v0.4.2

What's New

Homebrew support — nbor is now available via Homebrew on macOS:

brew tap tonhe/tap
brew install nbor

Supports both Intel and Apple Silicon Macs. The formula builds from source and is automatically updated with each new release.

Auto-elevate with sudo — Running nbor without root now automatically prompts for sudo with an explanation, instead of printing an error and exiting.

Changes

• Added Homebrew tap support via tonhe/homebrew-tap (builds from source)
• macOS/Linux: auto-elevate with sudo when not running as root
• Windows: improved privilege error message with instructions
• macOS release artifacts now include tar.gz archives with checksums
• Automated formula updates on release via GitHub App

Full Changelog: v0.4.1...v0.4.2

v0.4.1

v0.4.1 Release Notes

Windows Installer

This release adds a Windows installer (nbor-setup-windows-amd64.exe) that makes installation easier:

• Automatic Npcap handling - Detects if Npcap is installed; if not, offers to download and install it automatically from npcap.com
• Program Files installation - Installs to C:\Program Files\nbor\
• Start Menu shortcuts - Creates shortcuts for easy access
• Optional PATH addition - Add nbor to your system PATH for command-line use
• Clean uninstaller - Removes all files and PATH entries

The portable executable (nbor-windows-amd64.exe) is still available for users who prefer it.

Bug Fixes

• Fixed crash on Windows when changing interfaces - The "Change Interface" option in the configuration menu now works correctly on Windows. Previously it would crash with an "unsupported" error.

---

Installation

Windows (Installer - Recommended)

1. Download nbor-setup-windows-amd64.exe
2. Run as Administrator
3. Follow the wizard (it will help you install Npcap if needed)

Windows (Portable)

1. Download nbor-windows-amd64.exe
2. Install Npcap manually (enable "WinPcap API-compatible Mode")
3. Run as Administrator

macOS / Linux - No changes to installation process.

---

Full Changelog: v0.4.0...v0.4.1

v0.4.0

v0.4.0 Release Notes

New Features

Neighbor Detail View

• Press Enter on a selected neighbor to open a detailed popup view
• Shows all available information for the neighbor in a clean, organized format
• Header and footer remain visible when detail popup is open
• Press Esc to close the detail view and return to the main table

Improvements

UI/UX

• Vim keys (j/k) now work everywhere for navigation
• Dynamic column widths in neighbor table for better space utilization
• Abbreviated interface names for cleaner display
• Improved neighbor selection highlighting

Code Architecture

• Extracted protocol/ package for shared protocol constants
• Extracted cli/ package for command-line argument parsing
• Split config menu into separate files for maintainability

v0.3.2

Release Notes: v0.3.2

Platform Support

• Full Linux support - All platforms (macOS, Linux, Windows) are now tested and supported

New Features

• Auto-select interface - Automatically starts capturing when only one wired interface is available
• New configuration menu - Completely redesigned with submenus for better organization
• Theme switcher - Browse and preview all 20 themes with live preview from the config menu
• Capability filtering - Filter neighbors by capability type (router, bridge, station, etc.)

Bug Fixes

• Fix application hang on exit for Linux
• Fix LLDP broadcast issues
• Fix filters not getting applied
• Fix config menu UX issues:

Improvements

• Enhanced config navigation
• All defaults verified on config load

Full Changelog: v0.2.1...v0.3.2

v0.2.1

v0.2.1 Release Notes

New Features

CDP/LLDP Broadcasting

• Broadcast your system identity to the network using CDP and LLDP protocols
• Configurable system name and description for broadcasts
• Adjustable broadcast interval (default: 5 seconds) and TTL (default: 20 seconds)
• Advertise device capabilities: router, bridge, station, switch, phone, etc.

In-App Configuration Menu

• Press c from the capture view to open the configuration menu
• Change Interface: Switch to a different network interface without restarting
• System Identity: Set custom system name and description
• Protocol Listening: Enable/disable CDP and LLDP listening
• Protocol Broadcasting: Enable/disable CDP and LLDP broadcasting
• Broadcast on Startup: Option to automatically start broadcasting on launch
• Capabilities: Configure what device type to advertise

Runtime Broadcast Toggle

• Press b to toggle broadcasting on/off at runtime
• Runtime toggle does not modify saved configuration settings
• Status bar shows TX when broadcasting, -- when not

Self-Filtering

• Own broadcasts are automatically filtered from the neighbor list
• Prevents seeing your own system as a discovered neighbor

New Log File on Settings Change

• A new CSV log file is automatically started when listen settings (CDP/LLDP) are changed in the configuration menu

Configuration

New configuration options in config.toml:

# Broadcasting settings
cdp_broadcast = false
lldp_broadcast = false
broadcast_on_startup = false  # If true, start broadcasting automatically
advertise_interval = 5        # Seconds between broadcasts
ttl = 20                      # Time-to-live for advertised information

# System identity (used when broadcasting)
system_name = ""              # Empty = use hostname
system_description = ""       # Empty = use default

# Capabilities to advertise
capabilities = ["station"]

CLI Options
New command-line flags:

--cdp-broadcast Enable CDP broadcasting
--lldp-broadcast Enable LLDP broadcasting
--broadcast Enable both CDP and LLDP broadcasting
--broadcast-on-startup Start broadcasting immediately
--interval Broadcast interval (default: 5)
--ttl TTL/hold time (default: 20)
--name System name to advertise
--description System description to advertise
--capabilities Capabilities to advertise (router,bridge,station)

Full Changelog: v0.1.2...v0.2.1

v0.1.2

nbor v0.1.2

Network neighbor discovery tool for CDP/LLDP protocols.

✨ New Features

CLI Arguments

• -t, --theme <name> - Apply a theme for the session
• -l, --list-interfaces - List available network interfaces
• --list-all-interfaces - List all interfaces including filtered ones
• -v, --version - Show version
• -h, --help - Show help
• Pass interface name directly: nbor eth0

Configuration File

• Persistent configuration via config.toml
• Linux/macOS: ~/.config/nbor/config.toml
• Windows: %APPDATA%\nbor\config.toml

20 Built-in Themes

Solarized Dark/Light, Gruvbox Dark/Light, Dracula, Nord, One Dark, Monokai, Tokyo Night, Catppuccin Mocha/Latte, Everforest, Kanagawa, Rosé Pine, Tomorrow Night, Ayu Dark, Horizon, Zenburn, Palenight, GitHub Dark

🐛 Bug Fixes

• Fixed Windows interface detection and screen rendering issues
• Fixed display refresh bug causing visual glitches
• Improved neighbor row styling and layout

📦 Installation

Requires root/administrator privileges for packet capture.

# macOS/Linux
sudo nbor

# Windows (Terminal run as Administrator)
nbor.exe

v0.1.1

v0.1.1 - Windows Support

This release adds Windows support and fixes several issues.

New Features

• Windows support - nbor now builds and runs on Windows with Npcap
• Automated Windows builds - Release workflow now produces Windows binaries

Bug Fixes

• Windows interface detection - Fixed interface IP address and status detection on Windows by using pcap device info directly
• Windows Terminal colors - Fixed header/footer background colors not rendering in Windows Terminal by forcing true color mode

Windows Requirements

• Npcap must be installed with "WinPcap API-compatible Mode" enabled
• Must run as Administrator

Downloads

Platform	File
Windows 64-bit	nbor-windows-amd64.exe
macOS Apple Silicon	nbor-macos-arm64
macOS Intel	nbor-macos-amd64
Linux 64-bit	nbor-linux-amd64

v0.1.0-alpha

nbor v0.1.0-alpha

Initial alpha release of nbor - a TUI tool for discovering network neighbors via CDP and LLDP.

Features

• Interface selection with status indicators
• CDP and LLDP packet capture and parsing
• Real-time neighbor table with auto-refresh
• Visual alerts for new neighbors (highlighting + terminal bell)
• Stale neighbor detection
• CSV logging of first-seen neighbors
• Responsive column layout based on terminal width

Platform Support

• macOS: Tested (Intel + Apple Silicon binaries included)
• Linux: Completely untested (binary included)
• Windows: Not included in this release

Notes

This is an alpha release. Please report issues at https://github.com/tonhe/nbor/issues