blueutil-tui

blueutil-tui is a terminal user interface for managing Bluetooth connections on macOS. It provides a visual interface for the blueutil command-line tool, displaying paired Bluetooth devices in an interactive TUI built with Python's Textual framework.

The application launches with the btui command and shows only paired devices by default. Users can search for additional devices by pressing 's', refresh the view with 'r' to remove unpaired devices, and exit with Ctrl+Q. The tool requires blueutil to be installed as a system dependency to function.

blueutil-tui targets macOS users who prefer terminal interfaces for system management tasks. It simplifies Bluetooth device management by wrapping blueutil's functionality in an accessible TUI format, eliminating the need to remember command-line syntax for common Bluetooth operations.

Installation

# via pipx
pipx install blueutil-tui

# via uv
uv tool install blueutil-tui

# via rye
rye install blueutil-tui