osfeed.dev
Projects/pythops / bluetui

bluetui

A terminal UI for managing Bluetooth devices on Linux

Get it on GitHub
Unclaimed

Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v0.8.2 (2026-10-07), so it may lag behind newer releases.

Are you @pythops?Claim it, and your coding agent keeps it current with each release
v0.8.2 · 5 things you can do 3.1k stars 8 changes to know before upgrading

Pair, connect, trust, rename and favorite Bluetooth devices and control your adapters from a terminal, on top of BlueZ.

What you can do with bluetui

Scan for Bluetooth devices, pair new ones and connect or disconnect paired ones.

Present at v0.2
Good to know

Needs BlueZ.

Share
Wrong?

Turn the Bluetooth adapter on or off and toggle whether it is pairable and discoverable.

Present at v0.2
Share
Wrong?

See the battery level of connected Bluetooth devices.

Since v0.3
Good to know

Only for devices that report battery level through BlueZ.

Share
Wrong?

Before you upgrade bluetui

Newest first
v0.8.2

Startup now checks every Bluetooth rfkill entry and exits if any is blocked. For a soft block, unblock Bluetooth with `sudo rfkill unblock bluetooth`; clear a hardware block before starting.

Behavior changedInferredAffects: Systems with multiple Bluetooth controllers and a blocked controller
Read the evidence
Share
Wrong?
Show 5 older
v0.8.2

If app initialization fails after entering the terminal UI, bluetui now restores the terminal and returns success instead of propagating that initialization error.

Behavior changedInferredAffects: Users and scripts encountering failure during app initialization
Read the evidence
Share
Wrong?
bluetui release history 10
v0.8.2

Confirm before unpairing a Bluetooth device.

Details

Unpairing opens a confirmation dialog with No selected; Tab switches the choice, Enter applies it and Esc cancels. The custom-config long option changes from `--config` to `--config-path`; `-c` remains available.

Also: Pair the first scan result immediately; recover when adapters reappear; update custom-config commands and check favorites-file contents.

v0.8.2 pre-built binaries from the releases page, or `cargo install bluetui`; requires Linux and BlueZ.

Behavior changed / inferred: Trust, untrust or unpair devices you have paired be…Now works: Scan for Bluetooth devices, pair new ones and conne…Action required / inferred: Change key bindings, layout and window width in a c…Now works / inferred: Turn the Bluetooth adapter on or off and toggle whe…Behavior changed / inferred: Turn the Bluetooth adapter on or off and toggle whe…Behavior changed / inferred: Scan for Bluetooth devices, pair new ones and conne…Action required / inferred: Trust, untrust or unpair devices you have paired be…Behavior changed / inferred

Seeded by @iluxav with Codex

Read the evidence
v0.8.1

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

Read the evidence
v0.8.0

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

Read the evidence
v0.7.2

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

Read the evidence
v0.7.1

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

Read the evidence
v0.5.1

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

Read the evidence
v0.5

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

Read the evidence
v0.4

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

Read the evidence
v0.3

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

Read the evidence
v0.2
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

Read the evidence

Share

LinkedIn takes the link and its card only; write your text there.

X LinkedIn Reddit Hacker News Bluesky