bluetui

Start the program

$ bluetui

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

bluetui [OPTIONS]

Starts the interactive Bluetooth Terminal User Interface.

--help
    Displays a help message and exits, detailing available command-line options for bluetui.

--version
    Shows the program's version number and exits.

--debug
    Enables debug logging, providing more verbose output to the console for troubleshooting purposes.

bluetui is an interactive Terminal User Interface (TUI) written in Python for managing Bluetooth devices on Linux systems. It provides a more user-friendly and visual alternative to traditional command-line tools like bluetoothctl by presenting a console-based graphical interface. Within its interactive environment, users can easily scan for nearby Bluetooth devices, initiate pairing, establish and terminate connections, and manage various Bluetooth adapters and peripherals directly. It leverages the powerful BlueZ protocol stack, which is the official Linux Bluetooth stack, offering an intuitive yet robust way to handle all essential Bluetooth operations without needing to switch away from the terminal.

bluetui is typically installed via pip (Python Package Installer) and may not be pre-installed on all Linux distributions. It requires Python 3 and the BlueZ Bluetooth stack to be operational on the system. All significant interactions and device management, such as pairing or connecting, occur within its interactive TUI after launch, not as direct command-line arguments to bluetui itself.

Once launched, bluetui presents an interactive console where users navigate using arrow keys, tabs, and specific hotkeys (e.g., 'q' to quit, 'd' to disconnect, 'p' to pair). All Bluetooth operations, from scanning to connecting, are performed within this dynamic environment, offering a distinct experience compared to executing single-shot commands.

bluetui emerged as a modern, Python-based solution to simplify Bluetooth management within the Linux terminal. Its development focuses on providing a more visual and interactive experience, moving beyond the often terse output of traditional command-line utilities. By leveraging the robust BlueZ backend and offering a TUI, it aims to make Bluetooth device handling more accessible and user-friendly for those who prefer console-based applications.

bluetoothctl(1), hcitool(8), hciconfig(8)