bluetui

Start the program

$ bluetui

$ bluetui [[-h|--help]]

bluetui [ADAPTER] | bluetui -h | --version

-h, --help
    Display help message and exit

--version
    Show program's version number and exit

ADAPTER
    Optional Bluetooth adapter MAC address (e.g., 'hci0' or full MAC)

bluetui provides a terminal-based user interface (TUI) for managing Bluetooth devices on Linux systems using the BlueZ stack.

It offers an intuitive curses-based interface to discover adapters, scan for nearby devices, pair, connect, disconnect, and manage audio profiles like A2DP and HSP/HFP.

Key features include real-time device status, battery level monitoring for supported devices, multi-adapter support, and easy navigation via keyboard shortcuts.

Ideal for headless servers, minimal desktops, or users preferring keyboard-driven workflows over GUI tools like blueman.

bluetui requires a compatible terminal with mouse support optional and BlueZ 5.50+ installed. Launch it to enter interactive mode; no persistent daemon needed.

Requires BlueZ 5.50+ and bluetoothctl backend; terminal must support 256 colors for best visuals.
Limited to Linux/BlueZ; no Windows/macOS support. Mouse optional but keyboard primary.

Navigation: h/j/k/l or arrows; Enter select/action; q quit; s scan; c connect; p pair. See bluetui --help or in-app help (?).

Arch: AUR bluetui; Fedora: cargo install; or build from source: cargo install bluetui. Enable Bluetooth service: systemctl start bluetooth.

Developed by Roger Kvik starting 2022 as open-source GitHub project (rogerkvik/bluetui). Inspired by minimal TUIs; active development with v0.11+ adding audio sink/source switching and battery info. Gained popularity in Linux communities for server-side BT management.

bluetoothctl(1), hciconfig(8), blueman-manager(1), rfkill(8)