Scan for Bluetooth devices, pair new ones and connect or disconnect paired ones.
Good to know
Needs BlueZ.
bluetui
A terminal UI for managing Bluetooth devices on Linux
Unclaimed
Built by @pythops on GitHub. This page was written by @iluxav from public sources, last updated for v0.8.1 (2026-01-17), and may lag behind new releases.
Maintain bluetui? Claim itPair, connect, trust, rename and favorite Bluetooth devices and control your adapters from a terminal, on top of BlueZ.
What you can do with it
Trust, untrust or unpair devices you have paired before.
Turn the Bluetooth adapter on or off and toggle whether it is pairable and discoverable.
See the battery level of connected Bluetooth devices.
Good to know
Only for devices that report battery level through BlueZ.
Change key bindings, layout and window width in a config file, from the default or a custom path.
Before you upgrade
Newest firstv0.8.02025-11-13
Newly paired devices are now connected and trusted automatically.
Read the evidence
v0.7.12025-10-22
paired_device.toggle_connect and new_device.pair are no longer configurable keys; use Space or Enter, and remove them from config.toml.
Release history 9
v0.8.12026-01-17
Mark devices as favorites so they are easy to find.
Details
f marks a device as favorite (toggle_favorite in config); esc_quit = true lets Esc quit; lists wrap around. Static binaries are published.
v0.8.1; static binaries on the releases page.
Improved: Trust, untrust or unpair devices you have paired be…Improved: Change key bindings, layout and window width in a c…
Seeded by @iluxav with Claude Code (canido)
v0.8.02025-11-13
Pair devices that need a PIN or passkey, and have new devices connected and trusted right away.
Details
The remaining Bluetooth authentication methods are implemented, and newly paired devices are connected and trusted automatically. Devices without an icon get a default one.
v0.8.0.
Improved: Scan for Bluetooth devices, pair new ones and conne…Behavior changed: Scan for Bluetooth devices, pair new ones and conne…
Seeded by @iluxav with Claude Code (canido)
Read the evidence
v0.7.22025-11-03
Set the window width and layout of bluetui, and load the config from any path.
Details
New layout (Legacy, Start, End, Center, SpaceAround, SpaceBetween) and width (auto or a number) settings, and -c for a custom config path.
v0.7.2.
Improved: Change key bindings, layout and window width in a c…
Seeded by @iluxav with Claude Code (canido)
v0.7.12025-10-22
Connect or pair a device with Enter as well as Space.
Details
Space or Enter now connects paired devices and pairs new ones; the help popup became a responsive help banner; h/l and Shift+Tab move between sections. Groups v0.7 and v0.7.1.
Also: Fixed display on light terminal themes.
v0.7.1.
Improved: Scan for Bluetooth devices, pair new ones and conne…Behavior changed / inferred: Change key bindings, layout and window width in a c…Now works: Turn the Bluetooth adapter on or off and toggle whe…
Seeded by @iluxav with Claude Code (canido)
v0.5.12024-07-29
See when the Bluetooth adapter is blocked by rfkill.
Details
bluetui detects when the device is soft or hard blocked; q quits.
v0.5.1.
Improved: Turn the Bluetooth adapter on or off and toggle whe…
Seeded by @iluxav with Claude Code (canido)
Read the evidence
v0.52024-07-11
Give paired devices names you recognize.
Details
Rename paired devices with e; light terminal backgrounds are supported.
v0.5.
Improved: Trust, untrust or unpair devices you have paired be…
Seeded by @iluxav with Claude Code (canido)
v0.42024-03-15
Change bluetui's key bindings in a config file.
Details
Key bindings can be set in $HOME/.config/bluetui/config.toml; lists get scrollbars.
v0.4.
Added: Change key bindings, layout and window width in a c…
Seeded by @iluxav with Claude Code (canido)
v0.32024-03-06
See the battery level of connected Bluetooth devices.
Details
Battery percentage is shown for devices that report it, with a reworked, colored layout.
v0.3.
Added: See the battery level of connected Bluetooth device…
Seeded by @iluxav with Claude Code (canido)
Read the evidence
v0.22024-02-25
Starting point
Starting point
Pair and connect Bluetooth devices from a terminal.
Details
State of bluetui up to v0.2: adapter power, pairing and discovery toggles; scanning; pairing new devices with confirmation; connecting, trusting and unpairing paired devices.
Pre-built binaries or cargo install bluetui; needs BlueZ.
Added: Scan for Bluetooth devices, pair new ones and conne…Added: Trust, untrust or unpair devices you have paired be…Added: Turn the Bluetooth adapter on or off and toggle whe…
Seeded by @iluxav with Claude Code (canido)