5 releases (3 breaking)

0.5.1 Jul 29, 2024
0.5.0 Jul 11, 2024
0.4.0 Mar 15, 2024
0.2.0 Feb 25, 2024
0.1.0 Feb 21, 2024

#681 in Hardware support

Download history 23/week @ 2024-08-12 16/week @ 2024-08-19 14/week @ 2024-08-26 9/week @ 2024-09-02 13/week @ 2024-09-09 20/week @ 2024-09-16 43/week @ 2024-09-23 30/week @ 2024-09-30 41/week @ 2024-10-07 39/week @ 2024-10-14 28/week @ 2024-10-21 24/week @ 2024-10-28 36/week @ 2024-11-04 2/week @ 2024-11-11 19/week @ 2024-11-18 22/week @ 2024-11-25

83 downloads per month

GPL-3.0 license

140KB
2.5K SLoC

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 AUR with using an AUR helper.

paru -S 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

Dependencies

~13–24MB
~361K SLoC