blueutil-tui

blueutil-tui is a terminal user interface for managing Bluetooth connections on macOS. Built with Python's Textual framework, it provides a visual interface for connecting and managing Bluetooth devices through the underlying blueutil command-line tool.

The tool displays paired Bluetooth devices in a TUI format and allows users to search for additional devices by pressing 's'. Users can refresh the view with 'r' to remove unpaired devices, and exit the application with Ctrl+Q. The interface focuses on showing only paired devices by default, with the ability to discover and temporarily view unpaired devices during search operations.

blueutil-tui requires the blueutil command-line utility to be installed separately, typically via Homebrew. The tool is launched using the 'btui' command and is designed for macOS users who prefer a visual interface for Bluetooth management over raw command-line operations.

Installation

# via pipx
pipx install blueutil-tui

# via rye
rye install blueutil-tui

# via uv
uv tool install blueutil-tui