Visitar URL original
GitHub - pythops/bluetui: πŸ›œ TUI for managing bluetooth on Linux Β· GitHub
Skip to content
pythopsPublic

About

πŸ›œ TUI for managing bluetooth on Linux

Topics

Resources

Stars

3.1k stars

Watchers

13 watching

Forks

Latest commit

Β 

History

168 Commits

Folders and files

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

emerge 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

$ bluetui

You can run bluetui with options:

$ bluetui --help
Options:
  -c, --config <path>  config file path. Default ~/.config/bluetui/config.toml
      --ascii          Ascii display
  -h, --help           Print help
  -V, --version        Print version

Config

Keybindings can be customized in the default config file location $HOME/.config/bluetui/config.toml or from a custom path with -c

ascii = false # ascii display (false = do not show icons)

# Possible values: "Legacy", "Start", "End", "Center", "SpaceAround", "SpaceBetween"
layout = "SpaceAround"

# Window width
# Possible values: "auto" or a positive integer
width = "auto"

toggle_scanning = "s"
esc_quit = false  # Set to true to enable Esc key to quit the app

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

[paired_device]
unpair = "u"
toggle_trust = "t"
toggle_favorite = "f"
rename = "e"

🀝 Contributing

  • Strict No LLM.
  • Only submit a pull request after having a prior issue or discussion.
  • Keep PRs small and focused.

🎁 Note

If you like bluetui and you are looking for a TUI to manage WiFi, checkout out impala

βš–οΈ License

GPLv3

✍️ Credits

Bluetui logo: Marco Bulgarelli

About

πŸ›œ TUI for managing bluetooth on Linux

Topics

Resources

Stars

3.1k stars

Watchers

13 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages