Skip to content

pythops/bluetui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

cea9b6f Β· Mar 19, 2025

History

72 Commits
Aug 28, 2024
Feb 21, 2024
Jan 27, 2025
Feb 21, 2024
Feb 25, 2024
Jan 12, 2025
Jan 12, 2025
Jul 10, 2024
Feb 21, 2024
Dec 22, 2024
Dec 21, 2024
Mar 19, 2025
Mar 19, 2025
Sep 1, 2024

Repository files navigation

TUI for managing bluetooth on Linux

πŸ’‘ Prerequisites

A Linux based OS with bluez installed.

Note

You might need to install nerdfonts for the icons to be displayed correctly.

πŸš€ Installation

πŸ“₯ Binary release

You can download the pre-built binaries from the release page release page

πŸ“¦ crates.io

You can install bluetui from crates.io

cargo install bluetui

🐧 Arch Linux

You can install bluetui from the extra repository:

pacman -S bluetui

🐧 Gentoo

You can install bluetui from the lamdness Gentoo Overlay:

sudo eselect repository enable lamdness
sudo emaint -r lamdness sync
sudo emerge -av net-wireless/bluetui

βš’οΈ Build from source

Run the following command:

git clone https://github.com/pythops/bluetui
cd bluetui
cargo build --release

This will produce an executable file at target/release/bluetui that you can copy to a directory in your $PATH.

πŸͺ„ Usage

Global

Tab: Switch between different sections.

j or Down : Scroll down.

k or Up: Scroll up.

s: Start/Stop scanning.

?: Show help.

esc: Dismiss the help pop-up.

ctrl+c or q: Quit the app.

Adapters

p: Enable/Disable the pairing.

o: Power on/off the adapter.

d: Enable/Disable the discovery.

Paired devices

u: Unpair the device.

Space: Connect/Disconnect the device.

t: Trust/Untrust the device.

e: Rename the device.

New devices

p: Pair the device.

Custom keybindings

Keybindings can be customized in the config file $HOME/.config/bluetui/config.toml

toggle_scanning = "s"

[adapter]
toggle_pairing = "p"
toggle_power = "o"
toggle_discovery = "d"

[paired_device]
unpair = "u"
toggle_connect = " "
toggle_trust = "t"
rename = "e"

[new_device]
pair = "p"

βš–οΈ License

GPLv3