baud
A lightweight, high-performance CLI tool for discovering serial ports.
Features
- Fast Discovery: Instantly list all connected serial devices.
- Hardware ID Mapping: Uses an embedded USB database to identify device manufacturers (Arduino, ESP32, etc.).
- Smart Filtering: Automatically hides system clutter (Bluetooth, debug ports) to keep your view clean.
- Zero Dependencies: No need for
libusb or pkg-config.
Installation
For macOS (Apple Silicon & Intel)
-
Download the latest binary from the Releases page.
-
Open your terminal and run:
# 1. Make the file executable
chmod +x ~/Downloads/baud-mac-arm64
# 2. Bypass macOS security check
xattr -d com.apple.quarantine ~/Downloads/baud-mac-arm64
# 3. Move it to your system path
sudo mv ~/Downloads/baud-mac-arm64 /usr/local/bin/baud
-
Type baud list to start!
For Windows
- Download
baud-windows.exe from the Releases page.
- Run it directly from your terminal:
.\baud-windows.exe list
For Developers (using Go)
If you have Go installed, you can compile and install it directly:
go install github.com/jakeswider/baud/cmd@latest
Note: Ensure your $(go env GOPATH)/bin is in your system PATH.
Usage
Basic List
Show only physical USB hardware (filters out Bluetooth and virtual ports):
baud list
Identify Devices
Show the manufacturer and product names (e.g., "Arduino Uno"):
baud list --name
Show All
Include internal system ports and Bluetooth:
baud list --showall
Development
To build from source:
- Clone the repo:
git clone https://github.com/jakeswider/baud.git
- Build:
go build -o baud ./cmd
License
Distributed under the MIT License.