summaryrefslogtreecommitdiff
path: root/README.md
blob: 2a654ad11b2ef4113f042819a0125c54c8c9c477 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
# Bluetooth Quick Connect

This extension allows paired Bluetooth devices to be connected and
disconnected via the GNOME system menu, without need to enter the
Settings app every time.

## Installation

### Requirements

 * bluez (on ubuntu: `sudo apt install bluez`)

### Installation from extensions.gnome.org

https://extensions.gnome.org/extension/1401/bluetooth-quick-connect/

### Installation from source code

```
git clone https://github.com/bjarosze/gnome-bluetooth-quick-connect
cd gnome-bluetooth-quick-connect
make install
```

## Battery level

Headset battery (currently) requires enabling experimental features in bluez.
See https://github.com/bjarosze/gnome-bluetooth-quick-connect/pull/42 for more details.

## 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> && sleep 7 && 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
```