summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md42
1 files changed, 41 insertions, 1 deletions
diff --git a/README.md b/README.md
index 5a6d8cb..12b32e5 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,13 @@
# Bluetooth quick connect
This extension allows paired Bluetooth devices to be connected and
-disconnected via the GNOME system menu, without having to enter the
+disconnected via the GNOME system menu, without need to enter the
Settings app every time.
+# Requirements
+
+ * bluez (on ubuntu: `sudo apt install bluez`)
+
## Installation from extensions.gnome.org
https://extensions.gnome.org/extension/1401/bluetooth-quick-connect/
@@ -17,3 +21,39 @@ make
rm -r ~/.local/share/gnome-shell/extensions/bluetooth-quick-connect@bjarosze.gmail.com
cp -r gnome-bluetooth-quick-connect ~/.local/share/gnome-shell/extensions/bluetooth-quick-connect@bjarosze.gmail.com
```
+
+## Troubleshooting
+
+### Connecting and disconnecting does not work
+
+This extensions calls `bluetoothctl` under the hood. If something does not work
+you can try to execute `bluetoothctl` command in terminal and see what is wrong.
+
+#### Paired devices
+```bash
+bluetoothctl -- paired-devices
+```
+
+#### Connecting
+```bash
+bluetoothctl -- connect <mac address>
+```
+
+#### Disconnecting
+```bash
+bluetoothctl -- disconnect <mac address>
+```
+
+#### Reconnecting
+```bash
+bluetoothctl -- disconnect <mac> && bluetoothctl -- connect <mac>
+```
+
+### Reconnecting does not work
+
+Not sure why, but sometimes bluetoothctl does not want to connect
+device after it was disconnected. Reinstalling bluez and rebooting system helped on my ubuntu.
+```
+$ sudo apt purge bluez gnome-bluetooth pulseaudio-module-bluetooth
+$ sudo apt install bluez gnome-bluetooth pulseaudio-module-bluetooth
+``` \ No newline at end of file