Bluetooth connection manager for fuzzel and other compatible launchers
Find a file
2025-09-30 17:18:18 +02:00
assets assets: upload a demo 2025-09-30 17:18:18 +02:00
btctl connect: handle br-connection-refused 2025-09-29 19:55:04 +02:00
LICENSE Initial commit 2025-09-28 19:02:24 +02:00
README.md assets: upload a demo 2025-09-30 17:18:18 +02:00

btctl

btctl is a lightweight Bluetooth connection manager.

Run btctl connect to connect to a paired device, or btctl disconnect to disconnect from a connected one. Select the device using the launcher of your choice, and get a notification about the connection status:

Demo

Note that this program only manages connections. You need to use another program like bluetoothctl for scanning, pairing, and trusting devices.

Dependencies

  • python-dbus to communicate with BlueZ and send notifications.
  • fuzzel or another compatible launcher that reads a list of options and writes the chosen option index.

Configuration

You can specify the launcher to use in the configuration file at $XDG_CONFIG_HOME/btctl/config.toml, for example:

[launcher]
command = ['fuzzel', '--dmenu', '--index', '--auto-select']