https://github.com/pythops/bluetui

🛜 TUI for managing bluetooth devices
https://github.com/pythops/bluetui

bluetooth bluez linux ratatui rust tui

Last synced: about 17 hours ago
JSON representation

🛜 TUI for managing bluetooth devices

• Host: GitHub
• URL: https://github.com/pythops/bluetui
• Owner: pythops
• License: gpl-3.0
• Created: 2024-02-21T23:02:07.000Z (4 months ago)
• Default Branch: master
• Last Pushed: 2024-03-15T13:14:08.000Z (3 months ago)
• Last Synced: 2024-03-15T22:55:27.554Z (3 months ago)
• Topics: bluetooth, bluez, linux, ratatui, rust, tui
• Language: Rust
• Homepage:
• Size: 184 KB
• Stars: 91
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: Readme.md
  • License: LICENSE

Lists

• awesome-tuis - bluetui
• awesome-ratatui - bluetui - A TUI for managing Bluetooth devices. (💻 Apps / 🚀 Productivity and Utilities)

README

        


  

  
 TUI for managing bluetooth devices 

  



## 💡 Prerequisites

A Linux based OS with [bluez](https://www.bluez.org/) installed.

> [!NOTE]

> You might need to install [nerdfonts](https://www.nerdfonts.com/) for the icons to be displayed correctly.

## 🚀 Installation

### 📥 Binary release

You can download the pre-built binaries from the release page [release page](https://github.com/pythops/bluetui/releases)

### 📦 crates.io

You can install `bluetui` from [crates.io](https://crates.io/crates/bluetui)

```shell

cargo install bluetui

```

### 🐧 Arch Linux

You can install `bluetui` from the [AUR](https://aur.archlinux.org/packages/bluetui) with using an AUR helper.

```shell

paru -S bluetui

```

### ⚒️ Build from source

Run the following command:

```shell

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.

`q` or `ctrl+c`: 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.

### New devices

`p`: Pair the device.

## Custom keybindings

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

```toml

toggle_scanning = "s"

[adapter]

toggle_pairing = "p"

toggle_power = "o"

toggle_discovery = "d"

[paired_device]

unpair = "u"

toggle_connect = " "

toggle_trust = "t"

[new_device]

pair = "p"

```

## ⚖️ License

GPLv3