Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

pythops/bluetui

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

🧰 X-CMD

If you are a user of x-cmd, you can run:

x install 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 or Enter: Connect/Disconnect the device.

t: Trust/Untrust the device.

e: Rename the device.

New devices

Space or Enter: 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_trust = "t"
rename = "e"

βš–οΈ License

GPLv3

✍️ Credits

Bluetui logo: Marco Bulgarelli

About

πŸ›œ TUI for managing bluetooth on Linux

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Contributors 13

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /