baud

module
v0.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 24, 2025 License: MIT

README

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)
  1. Download the latest binary from the Releases page.

  2. 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
    
    
    
  3. Type baud list to start!

For Windows
  1. Download baud-windows.exe from the Releases page.
  2. 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:

  1. Clone the repo:
git clone https://github.com/jakeswider/baud.git

  1. Build:
go build -o baud ./cmd


License

Distributed under the MIT License.

Directories

Path Synopsis
internal

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL