🧩 Bluetooth Quick Connect

This extension allows paired Bluetooth devices to be connected and disconnected via the GNOME system menu, Shows battery status and more.

---

Note

This is a maintained fork of original Extension by bjarosze.

❄️ Installation

🚧 Requirements

• Properly working bluez setup

🎋 Installation from source code

Make sure you have Node.js and pnpm installed

git clone https://github.com/Extensions-Valhalla/gnome-bluetooth-quick-connect
cd gnome-bluetooth-quick-connect
pnpm install
pnpm extension-install

🛠️ Troubleshooting Guide

🔋 Battery Level Doesn't work

Headset battery (currently) requires enabling experimental features in bluez.

See bjarosze/gnome-bluetooth-quick-connect#42 for more details.

📖 Guides

• Enabling Experimental Features
• Check Bluetooth headphones battery status in Linux

🔍 Bluetooth Menu Disappears when turned Off (Pop!OS)

You may encounter an issue where the Bluetooth menu disappears when you turn off Bluetooth.

To fix this issue you need to do the following:

• Have at-least one device paired (this is important)
• Run this command in terminal

gsettings set org.gnome.shell had-bluetooth-devices-setup true

Now you can restart your system and the Bluetooth menu should be fixed.

🏗️ How to contribute

🐛 Reporting Bugs

If you encounter any bugs, please report them in the Issues. This will ensure a better experience for everyone.

📝 Translations

If you want to help translate this extension, carry on reading.

You need to first fork this repository and then clone it to your local machine.

git clone https://github.com/[your-username]/gnome-bluetooth-quick-connect
cd gnome-bluetooth-quick-connect

Now you need to create a new branch for your changes. For translations, you may want to use translate/[language-code] as the branch name.

git checkout -b translate/[language-code]

Now you might want to install a translation editor to make the process easier. We suggest using Poedit.

Open the translation app and choose Create new translation from POT file. Now select the pot file from the assets/po folder. Choose the language you want to translate to and start translating.

After you are done translating, save the file. You might want to preview the translations. See Installation from Source Code to get the local copy of the extension installed. Then restart the shell by logging out and logging back in. Then enable the extension.

gnome-extensions enable bluetooth-quick-connect@bjarosze.gmail.com

If everything looks good, you can commit your changes.

git add .
git commit -m "Add [language-name] translation"

Now you need to push the changes to your forked repository.

git push origin translate/[language-code]

Now you need to create a Pull Request to the original repository. And you are done!

We will review your changes and merge them if everything looks good.

Important

After you are done you might want to remove the local installation of the extension. Then re-install it from the extensions website. This will ensure you receive future updates.

💸 Sponsorship

If you like this extension, please consider sponsoring me. This will help me spend more time on this project.

📜 License

This project is licensed under the GPL-3.0 license.