Skip to content

Commit

Permalink
Add readme
Browse files Browse the repository at this point in the history
  • Loading branch information
pythops committed Feb 21, 2024
1 parent 1acaba1 commit ce6486e
Showing 1 changed file with 80 additions and 0 deletions.
80 changes: 80 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
<div align="center">
<img height="100" src="assets/logo.png"/>
<h2> TUI to manage bluetooth devices </h2>
</div>

## πŸ’‘ Prerequisites

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

## πŸš€ 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
```

### βš’οΈ 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`: Quit the app.

### Adpters

`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.

## πŸ—Ή Todo

- [ ] handle authentication

## βš–οΈ License

GPLv3

0 comments on commit ce6486e

Please sign in to comment.