Repolode
Submit
pythops

pythops/bluetui

A terminal UI for managing Bluetooth devices on Linux, built on BlueZ.

View on GitHub
Stars
3,051
Forks
84
Open issues
9
Last commit
10 days ago

What is it?

bluetui is a terminal user interface for managing Bluetooth on Linux. It lets you scan for nearby devices, pair, trust, and unpair them, and switch the adapter's power and discovery state without leaving the terminal. It runs on top of BlueZ, the standard Linux Bluetooth stack, so it needs a Linux system with BlueZ installed.

The interface is keyboard-driven, and keybindings, layout, window width and icon display can be changed in a TOML config file at ~/.config/bluetui/config.toml or a custom path passed with -c. Devices can also be marked as favorites and renamed. Icons require a Nerd Font, and an --ascii mode is available for terminals without one.

bluetui is distributed as pre-built binaries, through crates.io, Arch Linux's extra repository, Gentoo, and x-cmd, or it can be built from source with Cargo. The project author also maintains impala, a similar TUI for WiFi.

Key features

  • 01Scan for nearby Bluetooth devices from the terminal.
  • 02Pair, trust, unpair, and favorite paired devices.
  • 03Toggle adapter power, discovery, and pairing mode.
  • 04Customize keybindings, layout, and width through a TOML config file.
  • 05Ascii mode for terminals without Nerd Font icons.

Use cases

  • Connecting headphones or a keyboard on a Linux machine without a desktop Bluetooth applet.
  • Managing Bluetooth over SSH or on a headless server with a terminal session.
  • Keeping Bluetooth control inside a tiling window manager workflow.

Quick start

  1. 1

    Install bluez and a Rust toolchain, then install from crates.io

    cargo install bluetui
  2. 2

    Run bluetui

    bluetui

Things to know

  • Linux only, and requires BlueZ to be installed.
  • Icons may need a Nerd Font to display correctly.

Topics

#bluetooth#linux#tui#bluez#rust#terminal#ratatui

FAQ

What is bluetui?
A terminal UI for managing Bluetooth devices on Linux, built on BlueZ. bluetui is a terminal user interface for managing Bluetooth on Linux. It lets you scan for nearby devices, pair, trust, and unpair them, and switch the adapter's power and discovery state without leaving the terminal. It runs on top of BlueZ, the standard Linux Bluetooth stack, so it needs a Linux system with BlueZ installed.
Is bluetui free to use? What license does it have?
bluetui is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is bluetui still maintained?
Actively maintained. The last commit to bluetui was on Oct 10, 2026.
What can I use bluetui for?
Connecting headphones or a keyboard on a Linux machine without a desktop Bluetooth applet. Managing Bluetooth over SSH or on a headless server with a terminal session. Keeping Bluetooth control inside a tiling window manager workflow.
How do I install bluetui?
Install bluez and a Rust toolchain, then install from crates.io: cargo install bluetui Run bluetui: bluetui
Where can I get bluetui?
The source code and installation instructions are on GitHub: https://github.com/pythops/bluetui

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects