bthandler/README.md

66 lines
2.7 KiB
Markdown
Raw Normal View History

2020-04-18 21:20:08 +02:00
# bthandler
2020-04-25 15:01:13 +02:00
A simple interactive tool to:
- connect to already paired devices
2020-07-04 21:43:46 +02:00
- disconnect bluetooth devices
2020-04-25 15:01:13 +02:00
- pair new ones
- unpair already paired devices
- turn bluetooth on/off
- blacklist paired devices to not be listed in connection selection
2020-07-04 21:43:46 +02:00
- trust devices
2020-04-25 15:03:18 +02:00
all via dmenu. Should be easily extendable by editing the `actions` string.
2020-09-06 19:50:26 +02:00
<img src="/../assets/cropped.png" alt="cropped preview" width="100%">
2020-06-08 22:19:03 +02:00
2020-04-18 21:48:34 +02:00
# Installation
2020-04-25 15:01:13 +02:00
Edit the Makefile to reflect your preffered installation destination. Then, simply
```bash
make install
```
2020-06-08 21:59:36 +02:00
2020-07-05 11:29:12 +02:00
**Note:** If you don't change the Makefile `sudo` is not required and might break the blacklist and hardcoded pair list.
Afterwards, invoking `bt` will start the menu.
2020-06-08 21:59:36 +02:00
# Clear blacklist/pairlist
2020-06-08 22:19:03 +02:00
Since `bluetoothctl paired-devices` seems to be hugely unreliable in listing paired devices, bthandler has a seperate list for all devices paired through bthandler.
2020-06-08 21:59:36 +02:00
There is also a blacklist available to not display certain devices, which might be useful for autoconnection Bluetooth mice for example.
To clear these files, simply run
```bash
make clear
```
and these files will be reset to their inital, empty state.
2020-07-05 11:29:12 +02:00
**Note:** If for some reason `bluetoothctl paired-devices` works for you dont worry, bthandler lists all devices returned from `bluetoothctl` and it's own paired devices list. (Duplicates are not displayed.)
2020-06-08 21:59:36 +02:00
# Uninstall
To uninstall you might follow that it's a simple
```bash
make uninstall
```
2020-07-04 21:43:46 +02:00
If you have troubles with an uninstall, _additionally_ run `which bt | xargs rm`.
2020-06-08 21:59:36 +02:00
2020-07-14 09:33:11 +02:00
# Troubleshooting
## If bt takes long to show a menu
consider turning off `AUTOSCAN`. If there are many devices around you autoscanning will add them all to your `bluetoothctl devices` list. Every device on that list get's checked whether it's connected at startup.
This should only be an issue if `bluetoothctl scan off` is unreliable for you though.
2020-07-04 21:46:01 +02:00
# TODO
2020-06-08 21:59:36 +02:00
2020-09-05 22:32:18 +02:00
- [x] start scanning for new devices immediately at execution to save time when pairing new devices
- [x] auto-trust newly paired devices/trust device via dmenu (changeable via the AUTOTRUST variable in the beginning of bt, menu display adjusts accordingly)
- [x] blacklist devices via dmenu (action is hidden, but typing `blacklist` as your choice will reveal the menu)
- [x] update bthandler internal paired devices list if something new shows up via `bluetoothctl paired-devices` not already listed in the paired devices file
- [x] only show disconnect option if devices are already connected
- [ ] find a way to get something similar to `grep -vf` without the need of temp files.
- [x] only list connected devices to disconnect from, not all paired devices
- [x] only list not trusted devices in trust menu
- [x] selecting already connected device disconnects it