-
-
Notifications
You must be signed in to change notification settings - Fork 13
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
80 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 |