From 894f0698d3689bfd9fc601a16ac8fbae9840091a Mon Sep 17 00:00:00 2001 From: Angelo Date: Tue, 11 Nov 2025 03:17:01 +0800 Subject: [PATCH 01/20] New folder for bluetooth images --- static/images/bluetooth/bluetooth_1.png | 3 +++ static/images/bluetooth/bluetooth_2.png | 3 +++ static/images/bluetooth/bluetooth_3.png | 3 +++ static/images/bluetooth/bluetooth_4.png | 3 +++ static/images/bluetooth/bluetooth_5.png | 3 +++ static/images/bluetooth/bluetooth_6.png | 3 +++ static/images/bluetooth/bluetooth_7.png | 3 +++ static/images/bluetooth/bluetooth_8.png | 3 +++ static/images/bluetooth/bluetooth_9.png | 3 +++ 9 files changed, 27 insertions(+) create mode 100644 static/images/bluetooth/bluetooth_1.png create mode 100644 static/images/bluetooth/bluetooth_2.png create mode 100644 static/images/bluetooth/bluetooth_3.png create mode 100644 static/images/bluetooth/bluetooth_4.png create mode 100644 static/images/bluetooth/bluetooth_5.png create mode 100644 static/images/bluetooth/bluetooth_6.png create mode 100644 static/images/bluetooth/bluetooth_7.png create mode 100644 static/images/bluetooth/bluetooth_8.png create mode 100644 static/images/bluetooth/bluetooth_9.png diff --git a/static/images/bluetooth/bluetooth_1.png b/static/images/bluetooth/bluetooth_1.png new file mode 100644 index 0000000000..fbcc318048 --- /dev/null +++ b/static/images/bluetooth/bluetooth_1.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:646fa5019e39b45b1b35486b495b0ddd836826417137ab1faf7eea929ef14432 +size 74304 diff --git a/static/images/bluetooth/bluetooth_2.png b/static/images/bluetooth/bluetooth_2.png new file mode 100644 index 0000000000..42983d936b --- /dev/null +++ b/static/images/bluetooth/bluetooth_2.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:9e1dd37d2303f8d517085823cb8f745ee830b9f4c440c39d19b33894e56866f3 +size 24008 diff --git a/static/images/bluetooth/bluetooth_3.png b/static/images/bluetooth/bluetooth_3.png new file mode 100644 index 0000000000..1ff82aaaa0 --- /dev/null +++ b/static/images/bluetooth/bluetooth_3.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:919bcb31f091e52f7c24c212ca6ec68bebdd4e9382c516b1b25e3755291f4564 +size 55705 diff --git a/static/images/bluetooth/bluetooth_4.png b/static/images/bluetooth/bluetooth_4.png new file mode 100644 index 0000000000..8c38717c71 --- /dev/null +++ b/static/images/bluetooth/bluetooth_4.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:1610c6e72a8b99f28ddbc8400fc8187f789f2fa0ebe419122ab54f6cd0e45a51 +size 173517 diff --git a/static/images/bluetooth/bluetooth_5.png b/static/images/bluetooth/bluetooth_5.png new file mode 100644 index 0000000000..a60ab012b0 --- /dev/null +++ b/static/images/bluetooth/bluetooth_5.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:e26e42274d98ed36bfcf08ffa24c9733a7b5862f66e8f9c54413adae0d6031b8 +size 106037 diff --git a/static/images/bluetooth/bluetooth_6.png b/static/images/bluetooth/bluetooth_6.png new file mode 100644 index 0000000000..021d84d00c --- /dev/null +++ b/static/images/bluetooth/bluetooth_6.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:067b14990510b75b8e85e712d2d9cad67ea98d99f6b9187f39f3c4f7ad7610d9 +size 36334 diff --git a/static/images/bluetooth/bluetooth_7.png b/static/images/bluetooth/bluetooth_7.png new file mode 100644 index 0000000000..2a7c23769b --- /dev/null +++ b/static/images/bluetooth/bluetooth_7.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:a3e1e9af1749f410371989d08a6641fb89c434bb9a8d0bf39f99243ecd702f2a +size 119328 diff --git a/static/images/bluetooth/bluetooth_8.png b/static/images/bluetooth/bluetooth_8.png new file mode 100644 index 0000000000..d0a90e6c1c --- /dev/null +++ b/static/images/bluetooth/bluetooth_8.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:1e6cc9501e245ba74d831d48ec1ff73588f857dec224531b42be9646ecf12e41 +size 152490 diff --git a/static/images/bluetooth/bluetooth_9.png b/static/images/bluetooth/bluetooth_9.png new file mode 100644 index 0000000000..d3a2f0f2bc --- /dev/null +++ b/static/images/bluetooth/bluetooth_9.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d18656947b9c937ce3919328019b2ce5a5b397d71b23d97e2b9a1c40555d1707 +size 51082 From 00e6f390cce6f7914cf79ab4147e5a1ae7dc3381 Mon Sep 17 00:00:00 2001 From: Angelo Date: Tue, 11 Nov 2025 03:17:40 +0800 Subject: [PATCH 02/20] Updated bluetooth content --- content/bluetooth.md | 157 +++++++++++++++++++++++++++++++++++++------ 1 file changed, 135 insertions(+), 22 deletions(-) diff --git a/content/bluetooth.md b/content/bluetooth.md index 37c101b898..39345e97ee 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -15,15 +15,42 @@ section: network-troubleshooting tableOfContents: true --- -## Important Notes About Bluetooth +## About Bluetooth -Bluetooth is a bit odd. -There are a lot of factors that go into whether Bluetooth devices work together as expected. +Bluetooth is incredibly flexible. With a range of factors that enhance compatibility, Bluetooth devices effortlessly connect and work together for a smooth, seamless experience. ### Bluetooth version Bluetooth 5.0 is backwards compatible with older Bluetooth versions, but older bluetooth versioned devices are not always compatible with newer versions or devices. +### Confirm the bluetooth version of your device and make sure it is 5.0 or higher + +Use bluetoothctl, on your terminal type: + +```bash +bluetoothctl +``` + +If you have multiple Bluetooth controllers, choose the one you wish to connect to the device. + +Check list of controllers: +``` +List +``` + +Select the controller you want to use: + +``` +select +``` + +Check the version: +``` +version +``` + +![bluetoothclt version](/images/bluetooth/bluetooth_1.png) + ### Signal Interference Bluetooth uses the same bandwidth as the 2.4Ghz Wi-Fi band, and in most of our machines it is on the same chip as the Wi-Fi module. They usually have two antennae, one for Bluetooth, and one for Wi-Fi, but it is possible for other Wi-Fi or Bluetooth devices signals to cross and to cause connection issues. If users are in an area crowded with other Wi-Fi networks or devices, the interference from these outside sources can impact performance and range. @@ -72,44 +99,135 @@ This process lowers the sound quality of the stream when in HSP/HFP mode, so aud Bluetooth issues can be troubleshooted in several ways. The first thing to check is toggling airplane mode which will sometimes get Bluetooth functioning again. Next, make sure Bluetooth is enabled in the top bar, or in the Bluetooth system settings. -Then, try reinstalling Bluetooth related software with this command, depending on the verison of Pop!\_OS you're using. - -*For Pop!\_OS 22.04 or higher:* +Installing Bluetooth related software with this command: ```bash -sudo apt reinstall --purge bluez gnome-bluetooth +sudo apt install blueman ``` -*For Pop!\_OS 21.10 or 20.04:* +**NOTE:** After reinstalling the above packages, fully shut down the machine and then power it back on, rather than rebooting. This ensures the hardware completely resets. -```bash -sudo apt install --reinstall bluez gnome-bluetooth indicator-bluetooth pulseaudio-module-bluetooth -``` +Open bluetooth manager, Super + Space and search: + +![bluetooth manager](/images/bluetooth/bluetooth_2.png) -After reinstalling the above packages, fully shut down the machine and then power it back on, rather than rebooting. This ensures the hardware completely resets. +Remove the device, allowing for a fresh, new connection. + +![Remove device](/images/bluetooth/bluetooth_3.png) + +Click search and pair the device again: + +![Pair device](/images/bluetooth/bluetooth_4.png) If `tlp` is installed, then there may be settings interfering with Bluetooth functionality. Edit this file and disable Wifi and Bluetooth power saving features: ```bash -sudo gedit /etc/default/tlp +sudo nano /etc/tlp.conf ``` ### Useful Programs -There is a program called Bluetooth Manager which is included with XFCE. It can sometimes pair and trust Bluetooth devices better than the default Bluetooth settings. Install it with: +There is a program called Bluetooth Manager. It can sometimes pair and trust Bluetooth devices better than the default Bluetooth settings. Install it with: ```bash sudo apt install blueman ``` +Start the bluetooth using systemctl: + +```bash +sudo systemctl start bluetooth +``` + +```bash +sudo systemctl enable bluetooth +``` + +Check the status of the bluetooth + +```bash +sudo systemctl status bluetooth +``` + +Sample output: + +![bluetooth status systemd](/images/bluetooth/bluetooth_5.png) + Then, run Bluetooth Manager. Check for the device being trusted, and also try re-pairing in that program. +### Using bluetoothctl + +Using bluetoothctl over a UI offers more control, flexibility, and efficiency, especially for advanced users. It allows precise management of Bluetooth devices via the terminal, which is faster than navigating through graphical menus. For troubleshooting, bluetoothctl provides direct feedback and logs, which can help identify connection issues, detect devices, or configure settings in real time. It’s also useful for headless or remote setups where a UI might not be available. + +To get started, ensure Bluetooth is unblocked by running rfkill to check and enable it if necessary. Use the command: + +```bash +rfkill unblock bluetooth +``` +to ensure that Bluetooth is not disabled at the system level. + +Type: +``` +bluetoothctl +``` +![bluetoothclt](/images/bluetooth/bluetooth_6.png) + +If you have multiple Bluetooth controllers, choose the one you wish to connect to the device: + +Check list of controllers: +``` +list +``` + +Check controller information: +``` +info +``` + +Select the controller you want to use: +``` +select +``` + +Make sure to power it on +``` +power on +``` +![bluetoothctl power on](/images/bluetooth/bluetooth_7.png) + +Look for the device you want to connect: +``` +scan on +``` +Add trusted device +``` +trust +``` +See list of paired devices: + +``` +devices +``` + +To connect the device: +``` +connect +``` +![bluetootctl list scan trust connect](/images/bluetooth/bluetooth_8.png) + +Successful device connection: + +![bluetooothctl device connected](/images/bluetooth/bluetooth_9.png) + ### Useful Commands To show if the Bluetooth module (driver) is loaded, and see what system messages have been logged: ```bash lsmod | grep bluetooth +``` + +```bash dmesg | grep Bluetooth ``` @@ -141,6 +259,9 @@ To manually reload the Bluetooth USB kernel module: ```bash sudo rmmod btusb +``` + +```bash sudo modprobe btusb ``` @@ -156,14 +277,6 @@ To reset the Bluetooth device profiles and require re-pairing all devices (this sudo rm -r /var/lib/bluetooth/ ``` -*For Pop!\_OS 21.10 or 20.04:* - -Older Pop!\_OS versions used a PulseAudio module for Bluetooth audio. It's typically loaded by default, but sometimes a manual load can get Bluetooth headsets working again: - -```bash -pactl load-module module-bluetooth-discover -``` - ## Additional Info Here are a few additional tidbits about the Bluetooth system that may help with troubleshooting. From 178d11c152fd4577b5baa664f4abbd41660e51a4 Mon Sep 17 00:00:00 2001 From: Angelo Date: Wed, 12 Nov 2025 03:09:47 +0800 Subject: [PATCH 03/20] Remove note blocks --- content/bluetooth.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/bluetooth.md b/content/bluetooth.md index 39345e97ee..7bcfe41e74 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -105,7 +105,7 @@ Installing Bluetooth related software with this command: sudo apt install blueman ``` -**NOTE:** After reinstalling the above packages, fully shut down the machine and then power it back on, rather than rebooting. This ensures the hardware completely resets. +> After reinstalling the above packages, fully shut down the machine and then power it back on, rather than rebooting. This ensures the hardware completely resets. Open bluetooth manager, Super + Space and search: From 8d7113bebee1b2bb4cae5805a0018d232d4776ce Mon Sep 17 00:00:00 2001 From: Angelo Date: Thu, 13 Nov 2025 06:11:27 +0800 Subject: [PATCH 04/20] Added new photos --- static/images/bluetooth/bluetooth_10.png | 3 +++ static/images/bluetooth/bluetooth_11.png | 3 +++ static/images/bluetooth/bluetooth_12.png | 3 +++ static/images/bluetooth/bluetooth_13.png | 3 +++ 4 files changed, 12 insertions(+) create mode 100644 static/images/bluetooth/bluetooth_10.png create mode 100644 static/images/bluetooth/bluetooth_11.png create mode 100644 static/images/bluetooth/bluetooth_12.png create mode 100644 static/images/bluetooth/bluetooth_13.png diff --git a/static/images/bluetooth/bluetooth_10.png b/static/images/bluetooth/bluetooth_10.png new file mode 100644 index 0000000000..8f71318594 --- /dev/null +++ b/static/images/bluetooth/bluetooth_10.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d2f17c12075090c3c2a73adc0b618d3d8372cf17eba3689787c3b10ce36b0b62 +size 42831 diff --git a/static/images/bluetooth/bluetooth_11.png b/static/images/bluetooth/bluetooth_11.png new file mode 100644 index 0000000000..66edcbbccb --- /dev/null +++ b/static/images/bluetooth/bluetooth_11.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:4b5dc697aefaad75ea17d54c2c5b7f21f65624061ace9cd8bfe63373231c9e31 +size 121902 diff --git a/static/images/bluetooth/bluetooth_12.png b/static/images/bluetooth/bluetooth_12.png new file mode 100644 index 0000000000..a8d38e8036 --- /dev/null +++ b/static/images/bluetooth/bluetooth_12.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:a2cb393fc2c2caab9cb1fa4a8486928994ff6705a0aded63ca26a720076285a9 +size 48847 diff --git a/static/images/bluetooth/bluetooth_13.png b/static/images/bluetooth/bluetooth_13.png new file mode 100644 index 0000000000..f44ef40c45 --- /dev/null +++ b/static/images/bluetooth/bluetooth_13.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:486c942db008292c1310a53b6f8caf4ba98e8c891c1b07639b157c36e87044af +size 9052 From 34ef1748248e9aa2d1624bda7ac1bc099ce8b888 Mon Sep 17 00:00:00 2001 From: Angelo Date: Thu, 13 Nov 2025 06:13:07 +0800 Subject: [PATCH 05/20] Remove unnecessary items, correct and adjust sections, and add new photos --- content/bluetooth.md | 136 +++++++++++++++++++++---------------------- 1 file changed, 66 insertions(+), 70 deletions(-) diff --git a/content/bluetooth.md b/content/bluetooth.md index 7bcfe41e74..f5efb90b46 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -15,9 +15,70 @@ section: network-troubleshooting tableOfContents: true --- -## About Bluetooth +### Basic Troubleshooting -Bluetooth is incredibly flexible. With a range of factors that enhance compatibility, Bluetooth devices effortlessly connect and work together for a smooth, seamless experience. +Bluetooth issues can be troubleshooted in several ways. The first thing to check is toggling airplane mode which will sometimes get Bluetooth functioning again. Next, make sure Bluetooth is enabled in the top bar, or in the Bluetooth system settings. + +Navigate to the upper-right corner of the screen and click on the Settings icon. A window will appear. In the Wi-Fi tab, you'll find the Airplane Mode toggle. Switch it on and off to enable and disable Airplane Mode. + +![navigate to settings tab](/images/bluetooth/bluetooth_10.png) + +![airplane mode toggle](/images/bluetooth/bluetooth_11.png) + +Turn on Bluetooth and confirm it is enabled in the top bar, or in the Bluetooth system settings. + +![bluetooth top bar](/images/bluetooth/bluetooth_13.png) + +![bluetooth system settings](/images/bluetooth/bluetooth_12.png) + +Using systemd: + +```bash +sudo systemctl start bluetooth +``` + +```bash +sudo systemctl enable bluetooth +``` + +Check the status of the bluetooth + +```bash +sudo systemctl status bluetooth +``` + +Sample output: + +![bluetooth status systemd](/images/bluetooth/bluetooth_5.png) + + +There is a program called Bluetooth Manager. It can sometimes pair and trust Bluetooth devices better than the default Bluetooth settings. Install it with: + +Install Bluetooth related software with this command: + +```bash +sudo apt install blueman +``` + +> After reinstalling the above packages, fully shut down the machine and then power it back on, rather than rebooting. This ensures the hardware completely resets. + +Open Bluetooth Manager by pressing Super + Space and search: + +![bluetooth manager](/images/bluetooth/bluetooth_2.png) + +Remove the device, allowing for a fresh, new connection. + +![Remove device](/images/bluetooth/bluetooth_3.png) + +Click search and pair the device again: + +![Pair device](/images/bluetooth/bluetooth_4.png) + +If `tlp` is installed, then there may be settings interfering with Bluetooth functionality. Edit this file and disable Wifi and Bluetooth power saving features: + +```bash +sudo nano /etc/tlp.conf +``` ### Bluetooth version @@ -49,11 +110,11 @@ Check the version: version ``` -![bluetoothclt version](/images/bluetooth/bluetooth_1.png) +![bluetoothctl version](/images/bluetooth/bluetooth_1.png) ### Signal Interference -Bluetooth uses the same bandwidth as the 2.4Ghz Wi-Fi band, and in most of our machines it is on the same chip as the Wi-Fi module. They usually have two antennae, one for Bluetooth, and one for Wi-Fi, but it is possible for other Wi-Fi or Bluetooth devices signals to cross and to cause connection issues. If users are in an area crowded with other Wi-Fi networks or devices, the interference from these outside sources can impact performance and range. +Bluetooth uses the same bandwidth as the 2.4Ghz Wi-Fi band, and in some machines it is on the same chip as the Wi-Fi module. The Wi-Fi module usually has two antennae, one for Bluetooth, and one for Wi-Fi, but it is possible for other Wi-Fi or Bluetooth devices signals to cross and to cause connection issues. If users are in an area crowded with other Wi-Fi networks or devices, the interference from these outside sources can impact performance and range. ### Device Specific Differences @@ -71,8 +132,6 @@ As the Linux kernel develops, support for more devices are added. Sometimes Blue Similar to the kernel versions. Improvements are often made in newer versions of Ubuntu and Pop!\_OS. Running software updates is always a good idea, followed by a reboot. - - ### Configuration Issues Sometimes Bluetooth devices are working correctly, but something in settings needs to be reset. @@ -95,65 +154,6 @@ Bluetooth audio devices, such as headphones and speakers, usually default to the Bluetooth devices with microphones built in, can be used if the device supports HFP/HSP. However, without the technology that companies like Sony have patented, the solution is to divide up the audio stream so that some of it is used for audio out and some for audio in. This process lowers the sound quality of the stream when in HSP/HFP mode, so audio may be "tinny," compressed (lower-fidelity), or at a lower volume. That is expected behavior. -## Bluetooth Troubleshooting - -Bluetooth issues can be troubleshooted in several ways. The first thing to check is toggling airplane mode which will sometimes get Bluetooth functioning again. Next, make sure Bluetooth is enabled in the top bar, or in the Bluetooth system settings. - -Installing Bluetooth related software with this command: - -```bash -sudo apt install blueman -``` - -> After reinstalling the above packages, fully shut down the machine and then power it back on, rather than rebooting. This ensures the hardware completely resets. - -Open bluetooth manager, Super + Space and search: - -![bluetooth manager](/images/bluetooth/bluetooth_2.png) - -Remove the device, allowing for a fresh, new connection. - -![Remove device](/images/bluetooth/bluetooth_3.png) - -Click search and pair the device again: - -![Pair device](/images/bluetooth/bluetooth_4.png) - -If `tlp` is installed, then there may be settings interfering with Bluetooth functionality. Edit this file and disable Wifi and Bluetooth power saving features: - -```bash -sudo nano /etc/tlp.conf -``` - -### Useful Programs - -There is a program called Bluetooth Manager. It can sometimes pair and trust Bluetooth devices better than the default Bluetooth settings. Install it with: - -```bash -sudo apt install blueman -``` - -Start the bluetooth using systemctl: - -```bash -sudo systemctl start bluetooth -``` - -```bash -sudo systemctl enable bluetooth -``` - -Check the status of the bluetooth - -```bash -sudo systemctl status bluetooth -``` - -Sample output: - -![bluetooth status systemd](/images/bluetooth/bluetooth_5.png) - -Then, run Bluetooth Manager. Check for the device being trusted, and also try re-pairing in that program. ### Using bluetoothctl @@ -170,7 +170,7 @@ Type: ``` bluetoothctl ``` -![bluetoothclt](/images/bluetooth/bluetooth_6.png) +![bluetoothctl](/images/bluetooth/bluetooth_6.png) If you have multiple Bluetooth controllers, choose the one you wish to connect to the device: @@ -277,10 +277,6 @@ To reset the Bluetooth device profiles and require re-pairing all devices (this sudo rm -r /var/lib/bluetooth/ ``` -## Additional Info - -Here are a few additional tidbits about the Bluetooth system that may help with troubleshooting. - ### Controlling audio Once you are connected to a Bluetooth speaker, you may need to change where your current audio is "routed". You can get a more advanced interface to settings on audio with the program called PulseAudio Volume Control. To install, run this command: From 34ec0f42ec1dfde8d201047778b8a2558c559c8c Mon Sep 17 00:00:00 2001 From: Angelo Date: Thu, 13 Nov 2025 06:27:01 +0800 Subject: [PATCH 06/20] fix lint errors --- content/bluetooth.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/content/bluetooth.md b/content/bluetooth.md index f5efb90b46..8ba46a5ba6 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -51,7 +51,6 @@ Sample output: ![bluetooth status systemd](/images/bluetooth/bluetooth_5.png) - There is a program called Bluetooth Manager. It can sometimes pair and trust Bluetooth devices better than the default Bluetooth settings. Install it with: Install Bluetooth related software with this command: @@ -154,7 +153,6 @@ Bluetooth audio devices, such as headphones and speakers, usually default to the Bluetooth devices with microphones built in, can be used if the device supports HFP/HSP. However, without the technology that companies like Sony have patented, the solution is to divide up the audio stream so that some of it is used for audio out and some for audio in. This process lowers the sound quality of the stream when in HSP/HFP mode, so audio may be "tinny," compressed (lower-fidelity), or at a lower volume. That is expected behavior. - ### Using bluetoothctl Using bluetoothctl over a UI offers more control, flexibility, and efficiency, especially for advanced users. It allows precise management of Bluetooth devices via the terminal, which is faster than navigating through graphical menus. For troubleshooting, bluetoothctl provides direct feedback and logs, which can help identify connection issues, detect devices, or configure settings in real time. It’s also useful for headless or remote setups where a UI might not be available. From 12e7e0e0fe2a06d7e92e40386465cfefd554f852 Mon Sep 17 00:00:00 2001 From: Angelo Date: Tue, 25 Nov 2025 03:29:23 +0800 Subject: [PATCH 07/20] Fix button formats and update Bluetooth description --- content/bluetooth.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/content/bluetooth.md b/content/bluetooth.md index 8ba46a5ba6..2bb68d4e78 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -31,7 +31,7 @@ Turn on Bluetooth and confirm it is enabled in the top bar, or in the Bluetooth ![bluetooth system settings](/images/bluetooth/bluetooth_12.png) -Using systemd: +To start, enable or check the status of Bluetooth using the command line, open the Terminal by pressing `Super` + `T` and type the following commands: ```bash sudo systemctl start bluetooth @@ -61,7 +61,7 @@ sudo apt install blueman > After reinstalling the above packages, fully shut down the machine and then power it back on, rather than rebooting. This ensures the hardware completely resets. -Open Bluetooth Manager by pressing Super + Space and search: +Open Bluetooth Manager by pressing `Super` and search: ![bluetooth manager](/images/bluetooth/bluetooth_2.png) @@ -155,7 +155,7 @@ This process lowers the sound quality of the stream when in HSP/HFP mode, so aud ### Using bluetoothctl -Using bluetoothctl over a UI offers more control, flexibility, and efficiency, especially for advanced users. It allows precise management of Bluetooth devices via the terminal, which is faster than navigating through graphical menus. For troubleshooting, bluetoothctl provides direct feedback and logs, which can help identify connection issues, detect devices, or configure settings in real time. It’s also useful for headless or remote setups where a UI might not be available. +The program bluetoothctl offers control, flexibility, and efficiency through precise management of Bluetooth devices via the terminal. For troubleshooting, bluetoothctl provides direct feedback and logs, which can help identify connection issues, detect devices, or configure settings in real time. It’s also useful for headless or remote setups where a user interface might not be available. To get started, ensure Bluetooth is unblocked by running rfkill to check and enable it if necessary. Use the command: @@ -308,3 +308,7 @@ sudo apt install obexfs obexftp ``` Then connect (pair) to the device and see if send files works. To receive files over Bluetooth you will need to enable the option in Personal File Sharing. + +### Get Support for Ongoing Bluetooth Issues + +If you purchased a computer from System76 and you are still encountering bluetooth problems, please have your serial number ready and [open a support ticket.](https://system76.com/contact/support) From 170ec91dce7663aa1d306db4153b1c73c4bb2746 Mon Sep 17 00:00:00 2001 From: Angelo Date: Tue, 25 Nov 2025 03:30:31 +0800 Subject: [PATCH 08/20] update bluetooth_2 image --- static/images/bluetooth/bluetooth_2.png | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/static/images/bluetooth/bluetooth_2.png b/static/images/bluetooth/bluetooth_2.png index 42983d936b..ddd502dba5 100644 --- a/static/images/bluetooth/bluetooth_2.png +++ b/static/images/bluetooth/bluetooth_2.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:9e1dd37d2303f8d517085823cb8f745ee830b9f4c440c39d19b33894e56866f3 -size 24008 +oid sha256:9b967df5a6f8fe75cadedd0e7469c210493a37dfae0e0579a4b4ca147c781ef6 +size 21990 From 3f58e8fb7c8907e5e15771a78014fb507b93e0b9 Mon Sep 17 00:00:00 2001 From: Jacob Kauffmann Date: Thu, 19 Feb 2026 16:02:32 -0700 Subject: [PATCH 09/20] Add more info about toggling airplane mode --- content/bluetooth.md | 6 +++++- static/images/bluetooth/airplane-mode.png | 3 +++ 2 files changed, 8 insertions(+), 1 deletion(-) create mode 100644 static/images/bluetooth/airplane-mode.png diff --git a/content/bluetooth.md b/content/bluetooth.md index 2bb68d4e78..3db10a2eed 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -17,7 +17,11 @@ tableOfContents: true ### Basic Troubleshooting -Bluetooth issues can be troubleshooted in several ways. The first thing to check is toggling airplane mode which will sometimes get Bluetooth functioning again. Next, make sure Bluetooth is enabled in the top bar, or in the Bluetooth system settings. +If Bluetooth isn't working, first try toggling airplane mode on and back off. This can be done using a keyboard shortcut if your keyboard has one (look for a key with an airplane symbol, commonly `Fn`+`F11` or `Fn`+`F9` on System76 laptops). Otherwise, use the option at the top of the Wi-Fi menu near the top-right corner of your screen. + +![Bluetooth toggle in WiFi menu](/images/bluetooth/airplane-mode.png) + +Next, make sure Bluetooth is enabled in the top bar, or in the Bluetooth system settings. Navigate to the upper-right corner of the screen and click on the Settings icon. A window will appear. In the Wi-Fi tab, you'll find the Airplane Mode toggle. Switch it on and off to enable and disable Airplane Mode. diff --git a/static/images/bluetooth/airplane-mode.png b/static/images/bluetooth/airplane-mode.png new file mode 100644 index 0000000000..ded6568604 --- /dev/null +++ b/static/images/bluetooth/airplane-mode.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0bf42aa7f5c12b2b25dae134d8f5159b5d58a9a0a2755ab645cfec50b8b18dd3 +size 8864 From 46b5bd33242c3a74ebff31ee36809363f01ab1c3 Mon Sep 17 00:00:00 2001 From: Jacob Kauffmann Date: Thu, 19 Feb 2026 16:10:06 -0700 Subject: [PATCH 10/20] Update Bluetooth enable screenshots to 24.04 --- content/bluetooth.md | 16 ++++------------ static/images/bluetooth/airplane-mode.png | 4 ++-- .../images/bluetooth/bluetooth-enable-applet.png | 3 +++ .../bluetooth/bluetooth-enable-settings.png | 3 +++ 4 files changed, 12 insertions(+), 14 deletions(-) create mode 100644 static/images/bluetooth/bluetooth-enable-applet.png create mode 100644 static/images/bluetooth/bluetooth-enable-settings.png diff --git a/content/bluetooth.md b/content/bluetooth.md index 3db10a2eed..24bc12cc35 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -19,21 +19,13 @@ tableOfContents: true If Bluetooth isn't working, first try toggling airplane mode on and back off. This can be done using a keyboard shortcut if your keyboard has one (look for a key with an airplane symbol, commonly `Fn`+`F11` or `Fn`+`F9` on System76 laptops). Otherwise, use the option at the top of the Wi-Fi menu near the top-right corner of your screen. -![Bluetooth toggle in WiFi menu](/images/bluetooth/airplane-mode.png) +![Airplane mode toggle in WiFi menu](/images/bluetooth/airplane-mode.png) -Next, make sure Bluetooth is enabled in the top bar, or in the Bluetooth system settings. +Next, make sure Bluetooth is enabled in the top bar, or in the Bluetooth page of the Settings application. -Navigate to the upper-right corner of the screen and click on the Settings icon. A window will appear. In the Wi-Fi tab, you'll find the Airplane Mode toggle. Switch it on and off to enable and disable Airplane Mode. +![Bluetooth toggle in applet](/images/bluetooth/bluetooth-enable-applet.png) -![navigate to settings tab](/images/bluetooth/bluetooth_10.png) - -![airplane mode toggle](/images/bluetooth/bluetooth_11.png) - -Turn on Bluetooth and confirm it is enabled in the top bar, or in the Bluetooth system settings. - -![bluetooth top bar](/images/bluetooth/bluetooth_13.png) - -![bluetooth system settings](/images/bluetooth/bluetooth_12.png) +![Bluetooth toggle in Settings](/images/bluetooth/bluetooth-enable-settings.png) To start, enable or check the status of Bluetooth using the command line, open the Terminal by pressing `Super` + `T` and type the following commands: diff --git a/static/images/bluetooth/airplane-mode.png b/static/images/bluetooth/airplane-mode.png index ded6568604..08e0d9feff 100644 --- a/static/images/bluetooth/airplane-mode.png +++ b/static/images/bluetooth/airplane-mode.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:0bf42aa7f5c12b2b25dae134d8f5159b5d58a9a0a2755ab645cfec50b8b18dd3 -size 8864 +oid sha256:a130942041324dfda98e4bd1d8e2b82677b945bfe69128e24a89da17ad57c7cf +size 10499 diff --git a/static/images/bluetooth/bluetooth-enable-applet.png b/static/images/bluetooth/bluetooth-enable-applet.png new file mode 100644 index 0000000000..bde8abfe62 --- /dev/null +++ b/static/images/bluetooth/bluetooth-enable-applet.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0483d29664791c47a5ba77111c3966d35fd995a8141936315e20c017ee0465da +size 11354 diff --git a/static/images/bluetooth/bluetooth-enable-settings.png b/static/images/bluetooth/bluetooth-enable-settings.png new file mode 100644 index 0000000000..33458ad216 --- /dev/null +++ b/static/images/bluetooth/bluetooth-enable-settings.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:bd86e0b13c38bb15a354ccc959772bd1619c2f05eeb121d98d006ab6842876ea +size 36171 From 8b864162eb58219e492bdaef3793b8e8eb3e28a5 Mon Sep 17 00:00:00 2001 From: Jacob Kauffmann Date: Tue, 24 Feb 2026 14:37:03 -0700 Subject: [PATCH 11/20] Add basic usage section --- content/bluetooth.md | 81 +++++++++++-------- .../bluetooth/devices-available-applet.png | 3 + .../bluetooth/devices-available-settings.png | 3 + .../bluetooth/devices-connected-applet.png | 3 + .../bluetooth/devices-connected-settings.png | 3 + 5 files changed, 60 insertions(+), 33 deletions(-) create mode 100644 static/images/bluetooth/devices-available-applet.png create mode 100644 static/images/bluetooth/devices-available-settings.png create mode 100644 static/images/bluetooth/devices-connected-applet.png create mode 100644 static/images/bluetooth/devices-connected-settings.png diff --git a/content/bluetooth.md b/content/bluetooth.md index 24bc12cc35..8015705e03 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -15,7 +15,27 @@ section: network-troubleshooting tableOfContents: true --- -### Basic Troubleshooting +## Pairing and Removing Devices + +To pair a new device, open the Bluetooth applet located near the top-right corner of the screen, expand the "Other Bluetooth devices" drop-down, and select the device you wish to pair with. + +![Available Bluetooth devices in the applet drop-down](/images/bluetooth/devices-available-applet.png) + +Alternatively, open the Settings app, navigate to the Bluetooth page, and select the device there. + +![Available Bluetooth devices in the Settings app](/images/bluetooth/devices-available-settings.png) + +Follow any prompts you see to confirm the connection (e.g. by entering a pairing code displayed on your device). + +To temprarily disconnect from a device, click the device in the Bluetooth applet. + +![Connected Bluetooth devices in the applet drop-down](/images/bluetooth/devices-connected-applet.png) + +Alternatively, in the Settings app, click the three dots to the right of the device, and click Disconnect (to temporarily disconnect) or Forget (to unpair the device, requiring a manual re-pairing to use it again later). + +![Connected Bluetooth devices in the Settings app](/images/bluetooth/devices-connected-settings.png) + +## Troubleshooting If Bluetooth isn't working, first try toggling airplane mode on and back off. This can be done using a keyboard shortcut if your keyboard has one (look for a key with an airplane symbol, commonly `Fn`+`F11` or `Fn`+`F9` on System76 laptops). Otherwise, use the option at the top of the Wi-Fi menu near the top-right corner of your screen. @@ -27,59 +47,57 @@ Next, make sure Bluetooth is enabled in the top bar, or in the Bluetooth page of ![Bluetooth toggle in Settings](/images/bluetooth/bluetooth-enable-settings.png) -To start, enable or check the status of Bluetooth using the command line, open the Terminal by pressing `Super` + `T` and type the following commands: +If Bluetooth still isn't working, press `Super`+`T` to launch a Terminal, then check that the Bluetooth service is running with the following command: ```bash -sudo systemctl start bluetooth +sudo systemctl status bluetooth ``` -```bash -sudo systemctl enable bluetooth -``` +![bluetooth status systemd](/images/bluetooth/bluetooth_5.png) -Check the status of the bluetooth +If it's stopped, enable it to auto-start and immediately start it using the following command: ```bash -sudo systemctl status bluetooth +sudo systemctl enable --now bluetooth ``` -Sample output: - -![bluetooth status systemd](/images/bluetooth/bluetooth_5.png) +### Using Bluetooth Manager (blueman) -There is a program called Bluetooth Manager. It can sometimes pair and trust Bluetooth devices better than the default Bluetooth settings. Install it with: - -Install Bluetooth related software with this command: +A third-party program called Bluetooth Manager can sometimes pair and trust Bluetooth devices better than the default Bluetooth settings. Install it with this command: ```bash sudo apt install blueman ``` -> After reinstalling the above packages, fully shut down the machine and then power it back on, rather than rebooting. This ensures the hardware completely resets. +> After installing the above package, fully shut down the machine and then power it back on, rather than rebooting. This ensures the hardware completely resets. -Open Bluetooth Manager by pressing `Super` and search: +Open Bluetooth Manager by pressing `Super` and searching for "blueman": ![bluetooth manager](/images/bluetooth/bluetooth_2.png) -Remove the device, allowing for a fresh, new connection. +If the device is already paired, start by removing it to allow for a fresh connection. ![Remove device](/images/bluetooth/bluetooth_3.png) -Click search and pair the device again: +Next, click the Search button, select your device from the list, and click the key icon to pair it again: ![Pair device](/images/bluetooth/bluetooth_4.png) -If `tlp` is installed, then there may be settings interfering with Bluetooth functionality. Edit this file and disable Wifi and Bluetooth power saving features: +Finally, right-click your paired device and select `Connect` to connect to it: + + + +### Check TLP Settings + +If `tlp` is installed, then there may be settings interfering with Bluetooth functionality. Edit this file and disable any WiFi and Bluetooth power saving features: ```bash sudo nano /etc/tlp.conf ``` -### Bluetooth version - -Bluetooth 5.0 is backwards compatible with older Bluetooth versions, but older bluetooth versioned devices are not always compatible with newer versions or devices. +### Bluetooth Version -### Confirm the bluetooth version of your device and make sure it is 5.0 or higher +Bluetooth 5.0 is backwards compatible with older Bluetooth versions, but older Bluetooth versioned devices are not always compatible with newer versions or devices. Use bluetoothctl, on your terminal type: @@ -137,11 +155,6 @@ A more thorough way of testing this would be to create a [test user](/articles/o If it does, config files may need deleted. If it doesn't (especially in the Live Disk), reinstalling the OS may solve the problem. Reinstalling the OS won't affect Bluetooth hardware directly, but resetting and starting with a clean slate can solve a slew of problems and save time hunting for a specific file or bug. -## Setting Expectations - -Because of all of these factors, if the steps outlined in the Bluetooth troubleshooting article, and the previous troubleshooting steps don't resolve the issue, the issue may not be resolved at all. -Or, in a future update or change to the system, the devices may start working again. In some cases (many cases) users will not experience any issue with Bluetooth at all. - ### Audio Input/Output Bluetooth audio devices, such as headphones and speakers, usually default to the A2DP protocol, which works effectively as an audio output source. @@ -283,7 +296,7 @@ There will be a drop-down in the Playback tab for each of your applications that ### Linux Firmware -Occasionally the kernel and/or Linux firmware will have problems. Sometimes, newer Linux firmware packages will have fixed bugs that aren't yet in the repositories. They can be downloaded from here: +Occasionally the kernel and/or Linux firmware will have problems. Sometimes, newer Linux firmware packages will have fixed bugs that aren't yet in the repositories. They can be downloaded from here: [http://mirrors.kernel.org/ubuntu/pool/main/l/linux-firmware/](http://mirrors.kernel.org/ubuntu/pool/main/l/linux-firmware/) @@ -297,14 +310,16 @@ sudo dpkg -i linux-firmware_#.###.#_all.deb ### File Transfer -Sometimes, additional programs need to be installed for mobile equipment file transfer. Please install the transfer tool with this command: +Sometimes, additional programs need to be installed for mobile device file transfer. Install the transfer tool with this command: ```bash sudo apt install obexfs obexftp ``` -Then connect (pair) to the device and see if send files works. To receive files over Bluetooth you will need to enable the option in Personal File Sharing. +Then connect (pair) to the device and see if send files works. To receive files over Bluetooth, you will need to enable the option in Personal File Sharing. + +## Get Support for Ongoing Bluetooth Issues -### Get Support for Ongoing Bluetooth Issues +If you own a System76 computer and you're still experiencing Bluetooth problems after troubleshooting with the above steps, [open a support ticket](https://system76.com/contact/support) for additional assistance. -If you purchased a computer from System76 and you are still encountering bluetooth problems, please have your serial number ready and [open a support ticket.](https://system76.com/contact/support) +Bluetooth compatibility can depend on a variety of hardware and software factors. While Bluetooth often works flawlessly, certain devices may never be trouble-free with a particular computer or OS, while other devices may start working with software updates at a later date. diff --git a/static/images/bluetooth/devices-available-applet.png b/static/images/bluetooth/devices-available-applet.png new file mode 100644 index 0000000000..d24fe0da37 --- /dev/null +++ b/static/images/bluetooth/devices-available-applet.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:4ecf148e7713847753123b44bc748f4b59bd07e479c048656798cfb0a1b160ff +size 196097 diff --git a/static/images/bluetooth/devices-available-settings.png b/static/images/bluetooth/devices-available-settings.png new file mode 100644 index 0000000000..c459482e75 --- /dev/null +++ b/static/images/bluetooth/devices-available-settings.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:83522ab1da25e7de510edc06a753cc359c7a07b84b6b15341a31a0d31e23eef3 +size 64401 diff --git a/static/images/bluetooth/devices-connected-applet.png b/static/images/bluetooth/devices-connected-applet.png new file mode 100644 index 0000000000..3afcd5cd9b --- /dev/null +++ b/static/images/bluetooth/devices-connected-applet.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:cc4f12c7a61a77e62a1b4dff4e803def4aa4c41cbf7855dc7ac5ecc23068eeee +size 232244 diff --git a/static/images/bluetooth/devices-connected-settings.png b/static/images/bluetooth/devices-connected-settings.png new file mode 100644 index 0000000000..f6890e5580 --- /dev/null +++ b/static/images/bluetooth/devices-connected-settings.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:911b1690f5baed6abe8af931e2878d92191eb40a584b343088a8bdd010d710d7 +size 53441 From 2fceffec0f3c0e4a156488fee509e57516ed64f3 Mon Sep 17 00:00:00 2001 From: Jacob Kauffmann Date: Fri, 27 Feb 2026 10:09:10 -0700 Subject: [PATCH 12/20] Re-take some screenshots --- content/bluetooth.md | 14 +++++++++----- static/images/bluetooth/blueman-connect.png | 3 +++ static/images/bluetooth/blueman-first-launch.png | 3 +++ static/images/bluetooth/blueman-launcher.png | 3 +++ static/images/bluetooth/blueman-pair.png | 3 +++ static/images/bluetooth/blueman-remove.png | 3 +++ static/images/bluetooth/bluetooth_2.png | 3 --- static/images/bluetooth/bluetooth_3.png | 3 --- static/images/bluetooth/bluetooth_4.png | 3 --- 9 files changed, 24 insertions(+), 14 deletions(-) create mode 100644 static/images/bluetooth/blueman-connect.png create mode 100644 static/images/bluetooth/blueman-first-launch.png create mode 100644 static/images/bluetooth/blueman-launcher.png create mode 100644 static/images/bluetooth/blueman-pair.png create mode 100644 static/images/bluetooth/blueman-remove.png delete mode 100644 static/images/bluetooth/bluetooth_2.png delete mode 100644 static/images/bluetooth/bluetooth_3.png delete mode 100644 static/images/bluetooth/bluetooth_4.png diff --git a/content/bluetooth.md b/content/bluetooth.md index 8015705e03..c0db6f77ba 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -73,19 +73,23 @@ sudo apt install blueman Open Bluetooth Manager by pressing `Super` and searching for "blueman": -![bluetooth manager](/images/bluetooth/bluetooth_2.png) +![Searching for blueman in the launcher](/images/bluetooth/blueman-launcher.png) -If the device is already paired, start by removing it to allow for a fresh connection. +On first launch, you may be asked if Bluetooth should be enabled automatically. Choose `Yes`. -![Remove device](/images/bluetooth/bluetooth_3.png) +![First-start blueman prompt](/images/bluetooth/blueman-first-launch.png) + +If the device is already paired, start by removing it to allow for a fresh connection. You can do this by selecting the deivce and clicking the `-` button. + +![Remove device](/images/bluetooth/blueman-remove.png) Next, click the Search button, select your device from the list, and click the key icon to pair it again: -![Pair device](/images/bluetooth/bluetooth_4.png) +![Pair device](/images/bluetooth/blueman-pair.png) Finally, right-click your paired device and select `Connect` to connect to it: - +![Pair device](/images/bluetooth/blueman-connect.png) ### Check TLP Settings diff --git a/static/images/bluetooth/blueman-connect.png b/static/images/bluetooth/blueman-connect.png new file mode 100644 index 0000000000..c9718a7259 --- /dev/null +++ b/static/images/bluetooth/blueman-connect.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:74f60ff28bb0ff2e4a9e7eab85b724da84c1cde93e7d5fd23384aa7a547ab3d7 +size 44389 diff --git a/static/images/bluetooth/blueman-first-launch.png b/static/images/bluetooth/blueman-first-launch.png new file mode 100644 index 0000000000..adf0a8c756 --- /dev/null +++ b/static/images/bluetooth/blueman-first-launch.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:3d79b7e82ed4bd14d929a6ad3731060a7d8a21d7622b41f6e18fa221e581fc5a +size 34354 diff --git a/static/images/bluetooth/blueman-launcher.png b/static/images/bluetooth/blueman-launcher.png new file mode 100644 index 0000000000..a39bf8be1d --- /dev/null +++ b/static/images/bluetooth/blueman-launcher.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:5725e67d93d67bae531d67416cbfba688eb152cd032f436b26e06c279964882a +size 21951 diff --git a/static/images/bluetooth/blueman-pair.png b/static/images/bluetooth/blueman-pair.png new file mode 100644 index 0000000000..8643cc7699 --- /dev/null +++ b/static/images/bluetooth/blueman-pair.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:9eeda62f4d01b7f469b74341b067989c85d9c366970f4e1e8e7a036a27445d81 +size 51681 diff --git a/static/images/bluetooth/blueman-remove.png b/static/images/bluetooth/blueman-remove.png new file mode 100644 index 0000000000..806b79e039 --- /dev/null +++ b/static/images/bluetooth/blueman-remove.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:acce725c99db42ca93381fed572b9bc760f8909a1040dd2b2042e2a0bf3d3b95 +size 47989 diff --git a/static/images/bluetooth/bluetooth_2.png b/static/images/bluetooth/bluetooth_2.png deleted file mode 100644 index ddd502dba5..0000000000 --- a/static/images/bluetooth/bluetooth_2.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:9b967df5a6f8fe75cadedd0e7469c210493a37dfae0e0579a4b4ca147c781ef6 -size 21990 diff --git a/static/images/bluetooth/bluetooth_3.png b/static/images/bluetooth/bluetooth_3.png deleted file mode 100644 index 1ff82aaaa0..0000000000 --- a/static/images/bluetooth/bluetooth_3.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:919bcb31f091e52f7c24c212ca6ec68bebdd4e9382c516b1b25e3755291f4564 -size 55705 diff --git a/static/images/bluetooth/bluetooth_4.png b/static/images/bluetooth/bluetooth_4.png deleted file mode 100644 index 8c38717c71..0000000000 --- a/static/images/bluetooth/bluetooth_4.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:1610c6e72a8b99f28ddbc8400fc8187f789f2fa0ebe419122ab54f6cd0e45a51 -size 173517 From ce651c3e0bd7957a2e1e595998990a0991181d66 Mon Sep 17 00:00:00 2001 From: Jacob Kauffmann Date: Wed, 8 Apr 2026 16:45:31 -0600 Subject: [PATCH 13/20] Replace incorrect Bluetooth version check The content before would have displayed the version of the bluetoothctl utility, not the supported Bluetooth version of the device. The new, simpler method shows the actual Bluetooth version of the device. --- content/bluetooth.md | 27 +++++-------------------- static/images/bluetooth/bluetooth_1.png | 3 --- 2 files changed, 5 insertions(+), 25 deletions(-) delete mode 100644 static/images/bluetooth/bluetooth_1.png diff --git a/content/bluetooth.md b/content/bluetooth.md index c0db6f77ba..b676c458f2 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -101,33 +101,16 @@ sudo nano /etc/tlp.conf ### Bluetooth Version -Bluetooth 5.0 is backwards compatible with older Bluetooth versions, but older Bluetooth versioned devices are not always compatible with newer versions or devices. +Computers with newer Bluetooth versions will generally work with devices built for older Bluetooth versions, but devices requiring newer Bluetooth versions may not work on computers with older Bluetooth versions. -Use bluetoothctl, on your terminal type: +You can check your computer's Bluetooth version by installing and running the `inxi` tool: -```bash -bluetoothctl -``` - -If you have multiple Bluetooth controllers, choose the one you wish to connect to the device. - -Check list of controllers: -``` -List -``` - -Select the controller you want to use: - -``` -select -``` - -Check the version: ``` -version +sudo apt install inxi +inxi -E ``` -![bluetoothctl version](/images/bluetooth/bluetooth_1.png) +The Bluetooth version for each wireless card will be displayed at the end of the `Report` line. For example, if the output says `bt-v: 5.2`, then your computer supports Bluetooth 5.2 (and below). ### Signal Interference diff --git a/static/images/bluetooth/bluetooth_1.png b/static/images/bluetooth/bluetooth_1.png deleted file mode 100644 index fbcc318048..0000000000 --- a/static/images/bluetooth/bluetooth_1.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:646fa5019e39b45b1b35486b495b0ddd836826417137ab1faf7eea929ef14432 -size 74304 From b3bcfb8bb68a56eb558493fc13c7d37d26cb202b Mon Sep 17 00:00:00 2001 From: Jacob Kauffmann Date: Wed, 8 Apr 2026 16:48:57 -0600 Subject: [PATCH 14/20] Remove incorrect info on separate antennas for WiFi & BT --- content/bluetooth.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/bluetooth.md b/content/bluetooth.md index b676c458f2..27c7e64201 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -114,7 +114,7 @@ The Bluetooth version for each wireless card will be displayed at the end of the ### Signal Interference -Bluetooth uses the same bandwidth as the 2.4Ghz Wi-Fi band, and in some machines it is on the same chip as the Wi-Fi module. The Wi-Fi module usually has two antennae, one for Bluetooth, and one for Wi-Fi, but it is possible for other Wi-Fi or Bluetooth devices signals to cross and to cause connection issues. If users are in an area crowded with other Wi-Fi networks or devices, the interference from these outside sources can impact performance and range. +Bluetooth uses the same bandwidth as the 2.4Ghz Wi-Fi band, and in many computers, it uses the same wireless card and antennas as the W-Fi. If you're in an area crowded with other Wi-Fi networks or devices, the interference can impact Bluetooth performance and range. ### Device Specific Differences From f6a8fd4acd954daf72895604a21794a3189d9b93 Mon Sep 17 00:00:00 2001 From: Jacob Kauffmann Date: Wed, 8 Apr 2026 17:11:08 -0600 Subject: [PATCH 15/20] Revising & editing for accuracy & style --- content/bluetooth.md | 69 +++++++++++++++++--------------------------- 1 file changed, 27 insertions(+), 42 deletions(-) diff --git a/content/bluetooth.md b/content/bluetooth.md index 27c7e64201..c5ac95f9f9 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -116,54 +116,53 @@ The Bluetooth version for each wireless card will be displayed at the end of the Bluetooth uses the same bandwidth as the 2.4Ghz Wi-Fi band, and in many computers, it uses the same wireless card and antennas as the W-Fi. If you're in an area crowded with other Wi-Fi networks or devices, the interference can impact Bluetooth performance and range. -### Device Specific Differences +### Device-Specific Differences -Every Bluetooth device is different. They use the same or similar protocols, but the printed circuit boards (PCBs), are specific to each device, and the firmware they are running is often custom designed, and closed-source. +Every Bluetooth device is different. They use the same or similar protocols, but the printed circuit boards (PCBs) are specific to each device, and the firmware they run is often custom-designed and closed-source. Many devices are not tested against Linux systems by their manufacturers. -Some of the code and technologies that make Bluetooth work reliably are patented, and only device vendors who have licensed the permission to use that patented technology will be able to experience the full benefits (for more information see the "Audio Input/Output" section below.) +Some devices, such as Apple or Sony headphones, may utilize patentend technologies that aren't available on all computers or operating systems. That doesn't mean these devices won't work, but does mean their behavior or performance may vary. -> Some devices, such as Apple or Sony headphones, particularly take advantage of these patents and technologies to ensure they work well with similar devices. Often these devices are not tested against Linux machines. That doesn't mean these devices will not work, only that behavior or performance may vary. +### Audio Input/Output -### Kernel Versions +Several audio protocols exist for handling audio steaming over Bluetooth: -As the Linux kernel develops, support for more devices are added. Sometimes Bluetooth devices will work better in a different kernel version. +- **A2DP (Advanced Audio Distribution Profile)**: This protocol allows high-quality stereo audio streaming. However, with some devices, it only supports audio in one direction at a time (e.g. speakers only, no microphone). +- **HSP (Bluetooth Headset Protocol) and HFP (Hands-Free Protocol):** These protocols allow bidirectional audio streaming (e.g. speakers and microphone at the same time), but are limited to lower-quality, mono audio. -### OS Versions +You can try a different device profile by navigating to Settings -> Sound -> Device Profiles and using the drop-down next to your device. -Similar to the kernel versions. Improvements are often made in newer versions of Ubuntu and Pop!\_OS. Running software updates is always a good idea, followed by a reboot. +### OS & Kernel Versions -### Configuration Issues +As the Linux kernel develops, support for more devices are added. Sometimes, Bluetooth devices will work better in a different kernel version. -Sometimes Bluetooth devices are working correctly, but something in settings needs to be reset. +Running software updates and rebooting can ensure you're using the most recent available software for Bluetooth support. -The easiest way to test this is to "forget" the paired Bluetooth device, and pair it again. +#### Linux Firmware Packages -A more thorough way of testing this would be to create a [test user](/articles/other-accounts), or boot from a [Live Disk](/articles/live-disk) to see if Bluetooth works in either case. -If it does, config files may need deleted. If it doesn't (especially in the Live Disk), reinstalling the OS may solve the problem. -Reinstalling the OS won't affect Bluetooth hardware directly, but resetting and starting with a clean slate can solve a slew of problems and save time hunting for a specific file or bug. +Sometimes, newer Linux firmware packages will contain bux fixes that aren't yet in the standard software repositories. Newer Linux firmware packages can be downloaded from here: -### Audio Input/Output +[http://mirrors.kernel.org/ubuntu/pool/main/l/linux-firmware/](http://mirrors.kernel.org/ubuntu/pool/main/l/linux-firmware/) -Bluetooth audio devices, such as headphones and speakers, usually default to the A2DP protocol, which works effectively as an audio output source. +Then, they can be installed with this command (filling in the version numbers in the filename as appropriate): -Bluetooth devices with microphones built in, can be used if the device supports HFP/HSP. However, without the technology that companies like Sony have patented, the solution is to divide up the audio stream so that some of it is used for audio out and some for audio in. -This process lowers the sound quality of the stream when in HSP/HFP mode, so audio may be "tinny," compressed (lower-fidelity), or at a lower volume. That is expected behavior. +```bash +sudo dpkg -i linux-firmware_#.###.#_all.deb +``` + +Rebooting is required to load the newly installed firmware. + +### Configuration Issues + +Beyond forgetting and re-pairing deivces, you can check if any local configuration files are causing problems with a device by creating a [test user](/articles/other-accounts) or booting from a [live disk](/articles/live-disk) to see if Bluetooth works in either case. If it does, config files in your normal user account may need to be deleted. ### Using bluetoothctl -The program bluetoothctl offers control, flexibility, and efficiency through precise management of Bluetooth devices via the terminal. For troubleshooting, bluetoothctl provides direct feedback and logs, which can help identify connection issues, detect devices, or configure settings in real time. It’s also useful for headless or remote setups where a user interface might not be available. +The `bluetoothctl` program offers control, flexibility, and efficiency through precise management of Bluetooth devices via the terminal. For troubleshooting, `bluetoothctl` provides direct feedback and logs, which can help identify connection issues, detect devices, or configure settings in real time. It’s also useful for headless or remote setups where a user interface might not be available. -To get started, ensure Bluetooth is unblocked by running rfkill to check and enable it if necessary. Use the command: +To get started, ensure Bluetooth is unblocked by running `rfkill` to check and enable it if necessary. Use the command `rfkill unblock bluetooth` to ensure that Bluetooth is not disabled at the system level. -```bash -rfkill unblock bluetooth -``` -to ensure that Bluetooth is not disabled at the system level. +Then, run `bluetoothctl` in a terminal to enter the Bluetooth control tool. -Type: -``` -bluetoothctl -``` ![bluetoothctl](/images/bluetooth/bluetooth_6.png) If you have multiple Bluetooth controllers, choose the one you wish to connect to the device: @@ -281,20 +280,6 @@ sudo apt install pavucontrol There will be a drop-down in the Playback tab for each of your applications that is outputting sound that you should be able to change to your Bluetooth speaker. -### Linux Firmware - -Occasionally the kernel and/or Linux firmware will have problems. Sometimes, newer Linux firmware packages will have fixed bugs that aren't yet in the repositories. They can be downloaded from here: - -[http://mirrors.kernel.org/ubuntu/pool/main/l/linux-firmware/](http://mirrors.kernel.org/ubuntu/pool/main/l/linux-firmware/) - -Then they can be installed with this command: - -```bash -sudo dpkg -i linux-firmware_#.###.#_all.deb -``` - -> You'll need to replace the numbers/file name with the most current version after downloading it. - ### File Transfer Sometimes, additional programs need to be installed for mobile device file transfer. Install the transfer tool with this command: From 19d2728f8937a644c889a28ea3e4c7b8d4dc1037 Mon Sep 17 00:00:00 2001 From: Jacob Kauffmann Date: Thu, 9 Apr 2026 11:43:43 -0600 Subject: [PATCH 16/20] Better organization of additional commands --- content/bluetooth.md | 53 +++++++++++++++++++++++++------------------- 1 file changed, 30 insertions(+), 23 deletions(-) diff --git a/content/bluetooth.md b/content/bluetooth.md index c5ac95f9f9..408a00a859 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -101,7 +101,7 @@ sudo nano /etc/tlp.conf ### Bluetooth Version -Computers with newer Bluetooth versions will generally work with devices built for older Bluetooth versions, but devices requiring newer Bluetooth versions may not work on computers with older Bluetooth versions. +Computers with newer Bluetooth versions will generally work with accessories built for older Bluetooth versions, but accessories requiring newer Bluetooth versions may not work on computers with older Bluetooth versions. You can check your computer's Bluetooth version by installing and running the `inxi` tool: @@ -214,23 +214,25 @@ Successful device connection: ### Useful Commands -To show if the Bluetooth module (driver) is loaded, and see what system messages have been logged: +#### Logging -```bash -lsmod | grep bluetooth -``` +To show kernel logs related to Bluetooth: ```bash -dmesg | grep Bluetooth +sudo dmesg | grep -i Bluetooth ``` -To check if the service that handles Bluetooth is running: +To monitor Bluetooth events (try leaving this command running while pairing or using a device to see any error messages or failures): ```bash -sudo systemctl status bluetooth +sudo btmon ``` -To check if Bluetooth or Wireless (Wi-Fi) are software-blocked: +#### Blocks + +The `rfkill` utility shows whether Bluetooth or Wi-Fi are blocked in software or hardware. Generally, this information corresponds to whether airplane mode is enabled, but it can be useful to check separately in case of bugs in the airplane mode GUI or other components. + +To check if Bluetooth or Wireless LAN (Wi-Fi) are blocked: ```bash rfkill list @@ -238,7 +240,7 @@ rfkill list To unblock Bluetooth: -``` +```bash sudo rfkill unblock bluetooth ``` @@ -248,47 +250,52 @@ To unblock all wireless types: sudo rfkill unblock all ``` -To manually reload the Bluetooth USB kernel module: +#### Kernel Module -```bash -sudo rmmod btusb -``` +To show what Bluetooth kernel modules (drivers) are loaded: ```bash -sudo modprobe btusb +lsmod | grep bluetooth ``` -To monitor Bluetooth-related messages (try leaving this command running while pairing or using a device to see any error messages or failures): +To manually reload the Bluetooth USB kernel module: ```bash -sudo btmon +sudo rmmod btusb +sudo modprobe btusb ``` -To reset the Bluetooth device profiles and require re-pairing all devices (this can help if your Bluetooth audio device is stuck in an HSP/HFP profile and will not switch to A2DP mode after updates [1](https://github.com/bluez/bluez/issues/157)): +#### Resetting Bluetooth Devices + +Resetting the Bluetooth device profiles will require re-pairing all devices: ```bash sudo rm -r /var/lib/bluetooth/ ``` -### Controlling audio +This can help if your Bluetooth audio device is stuck on an HSP/HFP profile and won't switch to A2DP mode. -Once you are connected to a Bluetooth speaker, you may need to change where your current audio is "routed". You can get a more advanced interface to settings on audio with the program called PulseAudio Volume Control. To install, run this command: +### Controlling Audio + +Once you're connected to a Bluetooth speaker, you may need to change where your current audio is "routed." PulseAudio Volume Control provides a more advanced GUI interface for routing audio. To install it, run this command: ```bash sudo apt install pavucontrol ``` -There will be a drop-down in the Playback tab for each of your applications that is outputting sound that you should be able to change to your Bluetooth speaker. +There will be a drop-down in the Playback tab for each of your applications that's outputting sound, which you can use to send audio from individual applications to your Bluetooth speaker. ### File Transfer -Sometimes, additional programs need to be installed for mobile device file transfer. Install the transfer tool with this command: +Sometimes, additional programs need to be installed for mobile device file transfer to work. Install the Object Exchange (OBEX) packages with this command: ```bash sudo apt install obexfs obexftp ``` -Then connect (pair) to the device and see if send files works. To receive files over Bluetooth, you will need to enable the option in Personal File Sharing. +Then connect (pair) to the device and see if file sending works. + +On GNOME environments (such as Pop!_OS 22.04 and below), you may need to enable the Personal File Sharing option in Settings for file receiving to work. ## Get Support for Ongoing Bluetooth Issues From 00e1828a8d8d399813b8a828a8142674e7b568f2 Mon Sep 17 00:00:00 2001 From: Jacob Kauffmann Date: Thu, 9 Apr 2026 14:42:30 -0600 Subject: [PATCH 17/20] Update COSMIC screenshots to latest version & optimize PNGs --- content/bluetooth.md | 122 +++++++----------- static/images/bluetooth/airplane-mode.png | 4 +- .../images/bluetooth/blueman-first-launch.png | 4 +- static/images/bluetooth/blueman-launcher.png | 4 +- static/images/bluetooth/blueman-remove.png | 4 +- .../bluetooth/bluetooth-enable-applet.png | 4 +- .../bluetooth/bluetooth-enable-settings.png | 4 +- .../bluetooth/bluetooth-systemd-status.png | 3 + static/images/bluetooth/bluetooth_10.png | 3 - static/images/bluetooth/bluetooth_11.png | 3 - static/images/bluetooth/bluetooth_12.png | 3 - static/images/bluetooth/bluetooth_13.png | 3 - static/images/bluetooth/bluetooth_5.png | 3 - static/images/bluetooth/bluetooth_6.png | 3 - static/images/bluetooth/bluetooth_7.png | 3 - static/images/bluetooth/bluetooth_8.png | 3 - static/images/bluetooth/bluetooth_9.png | 3 - .../bluetooth/bluetoothctl-connection.png | 3 + .../images/bluetooth/bluetoothctl-launch.png | 3 + .../bluetooth/devices-available-applet.png | 4 +- .../bluetooth/devices-available-settings.png | 4 +- .../bluetooth/devices-connected-applet.png | 4 +- .../bluetooth/devices-connected-settings.png | 4 +- 23 files changed, 74 insertions(+), 124 deletions(-) create mode 100644 static/images/bluetooth/bluetooth-systemd-status.png delete mode 100644 static/images/bluetooth/bluetooth_10.png delete mode 100644 static/images/bluetooth/bluetooth_11.png delete mode 100644 static/images/bluetooth/bluetooth_12.png delete mode 100644 static/images/bluetooth/bluetooth_13.png delete mode 100644 static/images/bluetooth/bluetooth_5.png delete mode 100644 static/images/bluetooth/bluetooth_6.png delete mode 100644 static/images/bluetooth/bluetooth_7.png delete mode 100644 static/images/bluetooth/bluetooth_8.png delete mode 100644 static/images/bluetooth/bluetooth_9.png create mode 100644 static/images/bluetooth/bluetoothctl-connection.png create mode 100644 static/images/bluetooth/bluetoothctl-launch.png diff --git a/content/bluetooth.md b/content/bluetooth.md index 408a00a859..8c2a869260 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -35,11 +35,11 @@ Alternatively, in the Settings app, click the three dots to the right of the dev ![Connected Bluetooth devices in the Settings app](/images/bluetooth/devices-connected-settings.png) -## Troubleshooting +## Enabling Bluetooth If Bluetooth isn't working, first try toggling airplane mode on and back off. This can be done using a keyboard shortcut if your keyboard has one (look for a key with an airplane symbol, commonly `Fn`+`F11` or `Fn`+`F9` on System76 laptops). Otherwise, use the option at the top of the Wi-Fi menu near the top-right corner of your screen. -![Airplane mode toggle in WiFi menu](/images/bluetooth/airplane-mode.png) +![Airplane mode toggle in WiFi menu](/images/bluetooth/airplane-mode.avif) Next, make sure Bluetooth is enabled in the top bar, or in the Bluetooth page of the Settings application. @@ -53,7 +53,7 @@ If Bluetooth still isn't working, press `Super`+`T` to launch a Terminal, then c sudo systemctl status bluetooth ``` -![bluetooth status systemd](/images/bluetooth/bluetooth_5.png) +![bluetooth status systemd](/images/bluetooth/bluetooth-systemd-status.png) If it's stopped, enable it to auto-start and immediately start it using the following command: @@ -61,7 +61,7 @@ If it's stopped, enable it to auto-start and immediately start it using the foll sudo systemctl enable --now bluetooth ``` -### Using Bluetooth Manager (blueman) +## Using Bluetooth Manager (blueman) A third-party program called Bluetooth Manager can sometimes pair and trust Bluetooth devices better than the default Bluetooth settings. Install it with this command: @@ -91,6 +91,31 @@ Finally, right-click your paired device and select `Connect` to connect to it: ![Pair device](/images/bluetooth/blueman-connect.png) +## Using bluetoothctl + +The `bluetoothctl` program offers control, flexibility, and efficiency through precise management of Bluetooth devices via the terminal. For troubleshooting, `bluetoothctl` provides direct feedback and logs, which can help identify connection issues, detect devices, or configure settings in real time. It’s also useful for headless or remote setups where a user interface might not be available. + +To get started, ensure Bluetooth is unblocked by running `sudo rfkill unblock bluetooth` in a terminal, then run `bluetoothctl` to enter the Bluetooth control tool. + +![bluetoothctl](/images/bluetooth/bluetoothctl-launch.png) + +If you have multiple Bluetooth controllers, you can list them with the `list` command, show information about them with `show `, and select one to use with `select ` command. Use `devices` to see a list of paired devices. + +Finally, connect with the device using the `connect ` command. A `Connection successful` message will appear if the connection succeeds. + +![bluetootctl trusting & connecting to a device](/images/bluetooth/bluetoothctl-connection.png) + +## Further Troubleshooting + ### Check TLP Settings If `tlp` is installed, then there may be settings interfering with Bluetooth functionality. Edit this file and disable any WiFi and Bluetooth power saving features: @@ -155,66 +180,31 @@ Rebooting is required to load the newly installed firmware. Beyond forgetting and re-pairing deivces, you can check if any local configuration files are causing problems with a device by creating a [test user](/articles/other-accounts) or booting from a [live disk](/articles/live-disk) to see if Bluetooth works in either case. If it does, config files in your normal user account may need to be deleted. -### Using bluetoothctl - -The `bluetoothctl` program offers control, flexibility, and efficiency through precise management of Bluetooth devices via the terminal. For troubleshooting, `bluetoothctl` provides direct feedback and logs, which can help identify connection issues, detect devices, or configure settings in real time. It’s also useful for headless or remote setups where a user interface might not be available. - -To get started, ensure Bluetooth is unblocked by running `rfkill` to check and enable it if necessary. Use the command `rfkill unblock bluetooth` to ensure that Bluetooth is not disabled at the system level. - -Then, run `bluetoothctl` in a terminal to enter the Bluetooth control tool. - -![bluetoothctl](/images/bluetooth/bluetooth_6.png) - -If you have multiple Bluetooth controllers, choose the one you wish to connect to the device: - -Check list of controllers: -``` -list -``` +### Controlling Audio -Check controller information: -``` -info -``` +Once you're connected to a Bluetooth speaker, you may need to change where your current audio is "routed." PulseAudio Volume Control provides a more advanced GUI interface for routing audio. To install it, run this command: -Select the controller you want to use: -``` -select +```bash +sudo apt install pavucontrol ``` -Make sure to power it on -``` -power on -``` -![bluetoothctl power on](/images/bluetooth/bluetooth_7.png) +There will be a drop-down in the Playback tab for each of your applications that's outputting sound, which you can use to send audio from individual applications to your Bluetooth speaker. -Look for the device you want to connect: -``` -scan on -``` -Add trusted device -``` -trust -``` -See list of paired devices: +### File Transfer -``` -devices -``` +Sometimes, additional programs need to be installed for mobile device file transfer to work. Install the Object Exchange (OBEX) packages with this command: -To connect the device: -``` -connect +```bash +sudo apt install obexfs obexftp ``` -![bluetootctl list scan trust connect](/images/bluetooth/bluetooth_8.png) -Successful device connection: +Then connect (pair) to the device and see if file sending works. -![bluetooothctl device connected](/images/bluetooth/bluetooth_9.png) +On GNOME environments (such as Pop!_OS 22.04 and below), you may need to enable the Personal File Sharing option in Settings for file receiving to work. -### Useful Commands +## Other Useful Commands -#### Logging +### Logging To show kernel logs related to Bluetooth: @@ -228,7 +218,7 @@ To monitor Bluetooth events (try leaving this command running while pairing or u sudo btmon ``` -#### Blocks +### Blocks The `rfkill` utility shows whether Bluetooth or Wi-Fi are blocked in software or hardware. Generally, this information corresponds to whether airplane mode is enabled, but it can be useful to check separately in case of bugs in the airplane mode GUI or other components. @@ -250,7 +240,7 @@ To unblock all wireless types: sudo rfkill unblock all ``` -#### Kernel Module +### Kernel Module To show what Bluetooth kernel modules (drivers) are loaded: @@ -265,7 +255,7 @@ sudo rmmod btusb sudo modprobe btusb ``` -#### Resetting Bluetooth Devices +### Resetting Bluetooth Devices Resetting the Bluetooth device profiles will require re-pairing all devices: @@ -275,28 +265,6 @@ sudo rm -r /var/lib/bluetooth/ This can help if your Bluetooth audio device is stuck on an HSP/HFP profile and won't switch to A2DP mode. -### Controlling Audio - -Once you're connected to a Bluetooth speaker, you may need to change where your current audio is "routed." PulseAudio Volume Control provides a more advanced GUI interface for routing audio. To install it, run this command: - -```bash -sudo apt install pavucontrol -``` - -There will be a drop-down in the Playback tab for each of your applications that's outputting sound, which you can use to send audio from individual applications to your Bluetooth speaker. - -### File Transfer - -Sometimes, additional programs need to be installed for mobile device file transfer to work. Install the Object Exchange (OBEX) packages with this command: - -```bash -sudo apt install obexfs obexftp -``` - -Then connect (pair) to the device and see if file sending works. - -On GNOME environments (such as Pop!_OS 22.04 and below), you may need to enable the Personal File Sharing option in Settings for file receiving to work. - ## Get Support for Ongoing Bluetooth Issues If you own a System76 computer and you're still experiencing Bluetooth problems after troubleshooting with the above steps, [open a support ticket](https://system76.com/contact/support) for additional assistance. diff --git a/static/images/bluetooth/airplane-mode.png b/static/images/bluetooth/airplane-mode.png index 08e0d9feff..a373d6bbac 100644 --- a/static/images/bluetooth/airplane-mode.png +++ b/static/images/bluetooth/airplane-mode.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:a130942041324dfda98e4bd1d8e2b82677b945bfe69128e24a89da17ad57c7cf -size 10499 +oid sha256:064a11726b141a7b8abe1ac2f421d38744e0a780da5c55808394ce0467063be5 +size 10233 diff --git a/static/images/bluetooth/blueman-first-launch.png b/static/images/bluetooth/blueman-first-launch.png index adf0a8c756..5e168d8e9e 100644 --- a/static/images/bluetooth/blueman-first-launch.png +++ b/static/images/bluetooth/blueman-first-launch.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:3d79b7e82ed4bd14d929a6ad3731060a7d8a21d7622b41f6e18fa221e581fc5a -size 34354 +oid sha256:29bd6f504b94ceaafeeaef359eb37268139cb5f7ac046f9fdcbdb3b32b92b431 +size 34262 diff --git a/static/images/bluetooth/blueman-launcher.png b/static/images/bluetooth/blueman-launcher.png index a39bf8be1d..eacaf5be8d 100644 --- a/static/images/bluetooth/blueman-launcher.png +++ b/static/images/bluetooth/blueman-launcher.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:5725e67d93d67bae531d67416cbfba688eb152cd032f436b26e06c279964882a -size 21951 +oid sha256:105a98805d1f85a61c8cd484df8a37258131750ddf5a50cde9305a0b7f5ad43b +size 21944 diff --git a/static/images/bluetooth/blueman-remove.png b/static/images/bluetooth/blueman-remove.png index 806b79e039..ece9670f35 100644 --- a/static/images/bluetooth/blueman-remove.png +++ b/static/images/bluetooth/blueman-remove.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:acce725c99db42ca93381fed572b9bc760f8909a1040dd2b2042e2a0bf3d3b95 -size 47989 +oid sha256:cb02b6680e9b949cdacf8748682f6bcf8f9b3e178d0f65a0d1d1f548369af04f +size 47594 diff --git a/static/images/bluetooth/bluetooth-enable-applet.png b/static/images/bluetooth/bluetooth-enable-applet.png index bde8abfe62..4092dd3275 100644 --- a/static/images/bluetooth/bluetooth-enable-applet.png +++ b/static/images/bluetooth/bluetooth-enable-applet.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:0483d29664791c47a5ba77111c3966d35fd995a8141936315e20c017ee0465da -size 11354 +oid sha256:710b83a14cdc0f886141548113e9a369f64a63db3e640b165b10b2993ce52ce3 +size 11086 diff --git a/static/images/bluetooth/bluetooth-enable-settings.png b/static/images/bluetooth/bluetooth-enable-settings.png index 33458ad216..47fdf6f476 100644 --- a/static/images/bluetooth/bluetooth-enable-settings.png +++ b/static/images/bluetooth/bluetooth-enable-settings.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:bd86e0b13c38bb15a354ccc959772bd1619c2f05eeb121d98d006ab6842876ea -size 36171 +oid sha256:3c06329f72fec9d4569e9c2cf661f2846f4e836e323eb66d5efaf7375ba55854 +size 36100 diff --git a/static/images/bluetooth/bluetooth-systemd-status.png b/static/images/bluetooth/bluetooth-systemd-status.png new file mode 100644 index 0000000000..0865eb9203 --- /dev/null +++ b/static/images/bluetooth/bluetooth-systemd-status.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:ded06f5a96ff42a596ab8b5b6368f23a426b89f10b13ab64881e357bffa8ea69 +size 61744 diff --git a/static/images/bluetooth/bluetooth_10.png b/static/images/bluetooth/bluetooth_10.png deleted file mode 100644 index 8f71318594..0000000000 --- a/static/images/bluetooth/bluetooth_10.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:d2f17c12075090c3c2a73adc0b618d3d8372cf17eba3689787c3b10ce36b0b62 -size 42831 diff --git a/static/images/bluetooth/bluetooth_11.png b/static/images/bluetooth/bluetooth_11.png deleted file mode 100644 index 66edcbbccb..0000000000 --- a/static/images/bluetooth/bluetooth_11.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:4b5dc697aefaad75ea17d54c2c5b7f21f65624061ace9cd8bfe63373231c9e31 -size 121902 diff --git a/static/images/bluetooth/bluetooth_12.png b/static/images/bluetooth/bluetooth_12.png deleted file mode 100644 index a8d38e8036..0000000000 --- a/static/images/bluetooth/bluetooth_12.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:a2cb393fc2c2caab9cb1fa4a8486928994ff6705a0aded63ca26a720076285a9 -size 48847 diff --git a/static/images/bluetooth/bluetooth_13.png b/static/images/bluetooth/bluetooth_13.png deleted file mode 100644 index f44ef40c45..0000000000 --- a/static/images/bluetooth/bluetooth_13.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:486c942db008292c1310a53b6f8caf4ba98e8c891c1b07639b157c36e87044af -size 9052 diff --git a/static/images/bluetooth/bluetooth_5.png b/static/images/bluetooth/bluetooth_5.png deleted file mode 100644 index a60ab012b0..0000000000 --- a/static/images/bluetooth/bluetooth_5.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:e26e42274d98ed36bfcf08ffa24c9733a7b5862f66e8f9c54413adae0d6031b8 -size 106037 diff --git a/static/images/bluetooth/bluetooth_6.png b/static/images/bluetooth/bluetooth_6.png deleted file mode 100644 index 021d84d00c..0000000000 --- a/static/images/bluetooth/bluetooth_6.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:067b14990510b75b8e85e712d2d9cad67ea98d99f6b9187f39f3c4f7ad7610d9 -size 36334 diff --git a/static/images/bluetooth/bluetooth_7.png b/static/images/bluetooth/bluetooth_7.png deleted file mode 100644 index 2a7c23769b..0000000000 --- a/static/images/bluetooth/bluetooth_7.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:a3e1e9af1749f410371989d08a6641fb89c434bb9a8d0bf39f99243ecd702f2a -size 119328 diff --git a/static/images/bluetooth/bluetooth_8.png b/static/images/bluetooth/bluetooth_8.png deleted file mode 100644 index d0a90e6c1c..0000000000 --- a/static/images/bluetooth/bluetooth_8.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:1e6cc9501e245ba74d831d48ec1ff73588f857dec224531b42be9646ecf12e41 -size 152490 diff --git a/static/images/bluetooth/bluetooth_9.png b/static/images/bluetooth/bluetooth_9.png deleted file mode 100644 index d3a2f0f2bc..0000000000 --- a/static/images/bluetooth/bluetooth_9.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:d18656947b9c937ce3919328019b2ce5a5b397d71b23d97e2b9a1c40555d1707 -size 51082 diff --git a/static/images/bluetooth/bluetoothctl-connection.png b/static/images/bluetooth/bluetoothctl-connection.png new file mode 100644 index 0000000000..31a3042715 --- /dev/null +++ b/static/images/bluetooth/bluetoothctl-connection.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:f26ad52d5f92c8f73283462b506c360be370074263efa3147f99e35cce724489 +size 121676 diff --git a/static/images/bluetooth/bluetoothctl-launch.png b/static/images/bluetooth/bluetoothctl-launch.png new file mode 100644 index 0000000000..61ccf02696 --- /dev/null +++ b/static/images/bluetooth/bluetoothctl-launch.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:696611a1a59afed9b11876c580fb4d3dc35dd4e99f15959680bf50d51b16f378 +size 38889 diff --git a/static/images/bluetooth/devices-available-applet.png b/static/images/bluetooth/devices-available-applet.png index d24fe0da37..4f35c94d6e 100644 --- a/static/images/bluetooth/devices-available-applet.png +++ b/static/images/bluetooth/devices-available-applet.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:4ecf148e7713847753123b44bc748f4b59bd07e479c048656798cfb0a1b160ff -size 196097 +oid sha256:52c4e07a7e3e10db43785263e577fd554b54cd7b8048fc5ae2de7ea42d0f54e5 +size 195000 diff --git a/static/images/bluetooth/devices-available-settings.png b/static/images/bluetooth/devices-available-settings.png index c459482e75..f67793ff6a 100644 --- a/static/images/bluetooth/devices-available-settings.png +++ b/static/images/bluetooth/devices-available-settings.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:83522ab1da25e7de510edc06a753cc359c7a07b84b6b15341a31a0d31e23eef3 -size 64401 +oid sha256:37d32d516706985aab7ba75a24e8274f4222c37d0398412aeae2d47f4ef04a48 +size 70601 diff --git a/static/images/bluetooth/devices-connected-applet.png b/static/images/bluetooth/devices-connected-applet.png index 3afcd5cd9b..da39f8b08b 100644 --- a/static/images/bluetooth/devices-connected-applet.png +++ b/static/images/bluetooth/devices-connected-applet.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:cc4f12c7a61a77e62a1b4dff4e803def4aa4c41cbf7855dc7ac5ecc23068eeee -size 232244 +oid sha256:8a88d0038578da1319358ef4ce76f9fdb5ae02c914d35b42f2544e6bb2bc8fa7 +size 230105 diff --git a/static/images/bluetooth/devices-connected-settings.png b/static/images/bluetooth/devices-connected-settings.png index f6890e5580..64b280f5a2 100644 --- a/static/images/bluetooth/devices-connected-settings.png +++ b/static/images/bluetooth/devices-connected-settings.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:911b1690f5baed6abe8af931e2878d92191eb40a584b343088a8bdd010d710d7 -size 53441 +oid sha256:12776ebe9c5993caf96be3c04923822b79111278a575f7862372f32020f7e649 +size 54170 From e74dd790833356c0c2b6d4972ab528b959aa3c1b Mon Sep 17 00:00:00 2001 From: Jacob Kauffmann Date: Thu, 9 Apr 2026 14:51:34 -0600 Subject: [PATCH 18/20] Convert PNGs to WebP --- content/bluetooth.md | 30 +++++++++---------- static/images/bluetooth/airplane-mode.png | 3 -- static/images/bluetooth/airplane-mode.webp | 3 ++ static/images/bluetooth/blueman-connect.png | 3 -- static/images/bluetooth/blueman-connect.webp | 3 ++ .../images/bluetooth/blueman-first-launch.png | 3 -- .../bluetooth/blueman-first-launch.webp | 3 ++ static/images/bluetooth/blueman-launcher.png | 3 -- static/images/bluetooth/blueman-launcher.webp | 3 ++ static/images/bluetooth/blueman-pair.png | 3 -- static/images/bluetooth/blueman-pair.webp | 3 ++ static/images/bluetooth/blueman-remove.png | 3 -- static/images/bluetooth/blueman-remove.webp | 3 ++ .../bluetooth/bluetooth-enable-applet.png | 3 -- .../bluetooth/bluetooth-enable-applet.webp | 3 ++ .../bluetooth/bluetooth-enable-settings.png | 3 -- .../bluetooth/bluetooth-enable-settings.webp | 3 ++ .../bluetooth/bluetooth-systemd-status.png | 3 -- .../bluetooth/bluetooth-systemd-status.webp | 3 ++ .../bluetooth/bluetoothctl-connection.png | 3 -- .../bluetooth/bluetoothctl-connection.webp | 3 ++ .../images/bluetooth/bluetoothctl-launch.png | 3 -- .../images/bluetooth/bluetoothctl-launch.webp | 3 ++ .../bluetooth/devices-available-applet.png | 3 -- .../bluetooth/devices-available-applet.webp | 3 ++ .../bluetooth/devices-available-settings.png | 3 -- .../bluetooth/devices-available-settings.webp | 3 ++ .../bluetooth/devices-connected-applet.png | 3 -- .../bluetooth/devices-connected-applet.webp | 3 ++ .../bluetooth/devices-connected-settings.png | 3 -- .../bluetooth/devices-connected-settings.webp | 3 ++ 31 files changed, 60 insertions(+), 60 deletions(-) delete mode 100644 static/images/bluetooth/airplane-mode.png create mode 100644 static/images/bluetooth/airplane-mode.webp delete mode 100644 static/images/bluetooth/blueman-connect.png create mode 100644 static/images/bluetooth/blueman-connect.webp delete mode 100644 static/images/bluetooth/blueman-first-launch.png create mode 100644 static/images/bluetooth/blueman-first-launch.webp delete mode 100644 static/images/bluetooth/blueman-launcher.png create mode 100644 static/images/bluetooth/blueman-launcher.webp delete mode 100644 static/images/bluetooth/blueman-pair.png create mode 100644 static/images/bluetooth/blueman-pair.webp delete mode 100644 static/images/bluetooth/blueman-remove.png create mode 100644 static/images/bluetooth/blueman-remove.webp delete mode 100644 static/images/bluetooth/bluetooth-enable-applet.png create mode 100644 static/images/bluetooth/bluetooth-enable-applet.webp delete mode 100644 static/images/bluetooth/bluetooth-enable-settings.png create mode 100644 static/images/bluetooth/bluetooth-enable-settings.webp delete mode 100644 static/images/bluetooth/bluetooth-systemd-status.png create mode 100644 static/images/bluetooth/bluetooth-systemd-status.webp delete mode 100644 static/images/bluetooth/bluetoothctl-connection.png create mode 100644 static/images/bluetooth/bluetoothctl-connection.webp delete mode 100644 static/images/bluetooth/bluetoothctl-launch.png create mode 100644 static/images/bluetooth/bluetoothctl-launch.webp delete mode 100644 static/images/bluetooth/devices-available-applet.png create mode 100644 static/images/bluetooth/devices-available-applet.webp delete mode 100644 static/images/bluetooth/devices-available-settings.png create mode 100644 static/images/bluetooth/devices-available-settings.webp delete mode 100644 static/images/bluetooth/devices-connected-applet.png create mode 100644 static/images/bluetooth/devices-connected-applet.webp delete mode 100644 static/images/bluetooth/devices-connected-settings.png create mode 100644 static/images/bluetooth/devices-connected-settings.webp diff --git a/content/bluetooth.md b/content/bluetooth.md index 8c2a869260..8d1033da8e 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -19,33 +19,33 @@ tableOfContents: true To pair a new device, open the Bluetooth applet located near the top-right corner of the screen, expand the "Other Bluetooth devices" drop-down, and select the device you wish to pair with. -![Available Bluetooth devices in the applet drop-down](/images/bluetooth/devices-available-applet.png) +![Available Bluetooth devices in the applet drop-down](/images/bluetooth/devices-available-applet.webp) Alternatively, open the Settings app, navigate to the Bluetooth page, and select the device there. -![Available Bluetooth devices in the Settings app](/images/bluetooth/devices-available-settings.png) +![Available Bluetooth devices in the Settings app](/images/bluetooth/devices-available-settings.webp) Follow any prompts you see to confirm the connection (e.g. by entering a pairing code displayed on your device). To temprarily disconnect from a device, click the device in the Bluetooth applet. -![Connected Bluetooth devices in the applet drop-down](/images/bluetooth/devices-connected-applet.png) +![Connected Bluetooth devices in the applet drop-down](/images/bluetooth/devices-connected-applet.webp) Alternatively, in the Settings app, click the three dots to the right of the device, and click Disconnect (to temporarily disconnect) or Forget (to unpair the device, requiring a manual re-pairing to use it again later). -![Connected Bluetooth devices in the Settings app](/images/bluetooth/devices-connected-settings.png) +![Connected Bluetooth devices in the Settings app](/images/bluetooth/devices-connected-settings.webp) ## Enabling Bluetooth If Bluetooth isn't working, first try toggling airplane mode on and back off. This can be done using a keyboard shortcut if your keyboard has one (look for a key with an airplane symbol, commonly `Fn`+`F11` or `Fn`+`F9` on System76 laptops). Otherwise, use the option at the top of the Wi-Fi menu near the top-right corner of your screen. -![Airplane mode toggle in WiFi menu](/images/bluetooth/airplane-mode.avif) +![Airplane mode toggle in WiFi menu](/images/bluetooth/airplane-mode.webp) Next, make sure Bluetooth is enabled in the top bar, or in the Bluetooth page of the Settings application. -![Bluetooth toggle in applet](/images/bluetooth/bluetooth-enable-applet.png) +![Bluetooth toggle in applet](/images/bluetooth/bluetooth-enable-applet.webp) -![Bluetooth toggle in Settings](/images/bluetooth/bluetooth-enable-settings.png) +![Bluetooth toggle in Settings](/images/bluetooth/bluetooth-enable-settings.webp) If Bluetooth still isn't working, press `Super`+`T` to launch a Terminal, then check that the Bluetooth service is running with the following command: @@ -53,7 +53,7 @@ If Bluetooth still isn't working, press `Super`+`T` to launch a Terminal, then c sudo systemctl status bluetooth ``` -![bluetooth status systemd](/images/bluetooth/bluetooth-systemd-status.png) +![bluetooth status systemd](/images/bluetooth/bluetooth-systemd-status.webp) If it's stopped, enable it to auto-start and immediately start it using the following command: @@ -73,23 +73,23 @@ sudo apt install blueman Open Bluetooth Manager by pressing `Super` and searching for "blueman": -![Searching for blueman in the launcher](/images/bluetooth/blueman-launcher.png) +![Searching for blueman in the launcher](/images/bluetooth/blueman-launcher.webp) On first launch, you may be asked if Bluetooth should be enabled automatically. Choose `Yes`. -![First-start blueman prompt](/images/bluetooth/blueman-first-launch.png) +![First-start blueman prompt](/images/bluetooth/blueman-first-launch.webp) If the device is already paired, start by removing it to allow for a fresh connection. You can do this by selecting the deivce and clicking the `-` button. -![Remove device](/images/bluetooth/blueman-remove.png) +![Remove device](/images/bluetooth/blueman-remove.webp) Next, click the Search button, select your device from the list, and click the key icon to pair it again: -![Pair device](/images/bluetooth/blueman-pair.png) +![Pair device](/images/bluetooth/blueman-pair.webp) Finally, right-click your paired device and select `Connect` to connect to it: -![Pair device](/images/bluetooth/blueman-connect.png) +![Pair device](/images/bluetooth/blueman-connect.webp) ## Using bluetoothctl @@ -97,7 +97,7 @@ The `bluetoothctl` program offers control, flexibility, and efficiency through p To get started, ensure Bluetooth is unblocked by running `sudo rfkill unblock bluetooth` in a terminal, then run `bluetoothctl` to enter the Bluetooth control tool. -![bluetoothctl](/images/bluetooth/bluetoothctl-launch.png) +![bluetoothctl](/images/bluetooth/bluetoothctl-launch.webp) If you have multiple Bluetooth controllers, you can list them with the `list` command, show information about them with `show `, and select one to use with `select ` command. A `Connection successful` message will appear if the connection succeeds. -![bluetootctl trusting & connecting to a device](/images/bluetooth/bluetoothctl-connection.png) +![bluetootctl trusting & connecting to a device](/images/bluetooth/bluetoothctl-connection.webp) ## Further Troubleshooting diff --git a/static/images/bluetooth/airplane-mode.png b/static/images/bluetooth/airplane-mode.png deleted file mode 100644 index a373d6bbac..0000000000 --- a/static/images/bluetooth/airplane-mode.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:064a11726b141a7b8abe1ac2f421d38744e0a780da5c55808394ce0467063be5 -size 10233 diff --git a/static/images/bluetooth/airplane-mode.webp b/static/images/bluetooth/airplane-mode.webp new file mode 100644 index 0000000000..f9a356703d --- /dev/null +++ b/static/images/bluetooth/airplane-mode.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:2d2e7b83bbadf69430d005e875de3885355596211d26ce99a08defa8c0db4680 +size 2560 diff --git a/static/images/bluetooth/blueman-connect.png b/static/images/bluetooth/blueman-connect.png deleted file mode 100644 index c9718a7259..0000000000 --- a/static/images/bluetooth/blueman-connect.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:74f60ff28bb0ff2e4a9e7eab85b724da84c1cde93e7d5fd23384aa7a547ab3d7 -size 44389 diff --git a/static/images/bluetooth/blueman-connect.webp b/static/images/bluetooth/blueman-connect.webp new file mode 100644 index 0000000000..7732aee7df --- /dev/null +++ b/static/images/bluetooth/blueman-connect.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:92c4a2e6e26838e4027a63815d699a2d400d7db39fdf70811545ddb8d0f53da6 +size 8958 diff --git a/static/images/bluetooth/blueman-first-launch.png b/static/images/bluetooth/blueman-first-launch.png deleted file mode 100644 index 5e168d8e9e..0000000000 --- a/static/images/bluetooth/blueman-first-launch.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:29bd6f504b94ceaafeeaef359eb37268139cb5f7ac046f9fdcbdb3b32b92b431 -size 34262 diff --git a/static/images/bluetooth/blueman-first-launch.webp b/static/images/bluetooth/blueman-first-launch.webp new file mode 100644 index 0000000000..7d636a47ce --- /dev/null +++ b/static/images/bluetooth/blueman-first-launch.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0c319a4b169bc2121a4cfe9405dba41fbf402e753859767fc7e4e483b606423c +size 6970 diff --git a/static/images/bluetooth/blueman-launcher.png b/static/images/bluetooth/blueman-launcher.png deleted file mode 100644 index eacaf5be8d..0000000000 --- a/static/images/bluetooth/blueman-launcher.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:105a98805d1f85a61c8cd484df8a37258131750ddf5a50cde9305a0b7f5ad43b -size 21944 diff --git a/static/images/bluetooth/blueman-launcher.webp b/static/images/bluetooth/blueman-launcher.webp new file mode 100644 index 0000000000..616d079cfa --- /dev/null +++ b/static/images/bluetooth/blueman-launcher.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:47a9746b887fa66c5c8501a54f4611952d6c5ed9d481a8caa8152f816fc3ef80 +size 5154 diff --git a/static/images/bluetooth/blueman-pair.png b/static/images/bluetooth/blueman-pair.png deleted file mode 100644 index 8643cc7699..0000000000 --- a/static/images/bluetooth/blueman-pair.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:9eeda62f4d01b7f469b74341b067989c85d9c366970f4e1e8e7a036a27445d81 -size 51681 diff --git a/static/images/bluetooth/blueman-pair.webp b/static/images/bluetooth/blueman-pair.webp new file mode 100644 index 0000000000..c11ac1845c --- /dev/null +++ b/static/images/bluetooth/blueman-pair.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:a08b012e7fbefced72152815a67d2898c1116834195bcd22981e096453629a9f +size 11638 diff --git a/static/images/bluetooth/blueman-remove.png b/static/images/bluetooth/blueman-remove.png deleted file mode 100644 index ece9670f35..0000000000 --- a/static/images/bluetooth/blueman-remove.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:cb02b6680e9b949cdacf8748682f6bcf8f9b3e178d0f65a0d1d1f548369af04f -size 47594 diff --git a/static/images/bluetooth/blueman-remove.webp b/static/images/bluetooth/blueman-remove.webp new file mode 100644 index 0000000000..7ec19ffec5 --- /dev/null +++ b/static/images/bluetooth/blueman-remove.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:e9fa118ffea88e72d076c2795b630ff0c33388dfff8f9feadc671a825a72d29c +size 9622 diff --git a/static/images/bluetooth/bluetooth-enable-applet.png b/static/images/bluetooth/bluetooth-enable-applet.png deleted file mode 100644 index 4092dd3275..0000000000 --- a/static/images/bluetooth/bluetooth-enable-applet.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:710b83a14cdc0f886141548113e9a369f64a63db3e640b165b10b2993ce52ce3 -size 11086 diff --git a/static/images/bluetooth/bluetooth-enable-applet.webp b/static/images/bluetooth/bluetooth-enable-applet.webp new file mode 100644 index 0000000000..9cf06076c6 --- /dev/null +++ b/static/images/bluetooth/bluetooth-enable-applet.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:3737f00ac6833f9621b3d229193bb2d0cd4cbec105b7feb59b73ba37f93da453 +size 2954 diff --git a/static/images/bluetooth/bluetooth-enable-settings.png b/static/images/bluetooth/bluetooth-enable-settings.png deleted file mode 100644 index 47fdf6f476..0000000000 --- a/static/images/bluetooth/bluetooth-enable-settings.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:3c06329f72fec9d4569e9c2cf661f2846f4e836e323eb66d5efaf7375ba55854 -size 36100 diff --git a/static/images/bluetooth/bluetooth-enable-settings.webp b/static/images/bluetooth/bluetooth-enable-settings.webp new file mode 100644 index 0000000000..f5b13744ea --- /dev/null +++ b/static/images/bluetooth/bluetooth-enable-settings.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:888ba2affe56c6851c47f36c6657830deff3adf62a7b60671f6b45b488c00718 +size 7784 diff --git a/static/images/bluetooth/bluetooth-systemd-status.png b/static/images/bluetooth/bluetooth-systemd-status.png deleted file mode 100644 index 0865eb9203..0000000000 --- a/static/images/bluetooth/bluetooth-systemd-status.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:ded06f5a96ff42a596ab8b5b6368f23a426b89f10b13ab64881e357bffa8ea69 -size 61744 diff --git a/static/images/bluetooth/bluetooth-systemd-status.webp b/static/images/bluetooth/bluetooth-systemd-status.webp new file mode 100644 index 0000000000..49b2329cb3 --- /dev/null +++ b/static/images/bluetooth/bluetooth-systemd-status.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:65e283a4dfe911b2e477fa98f814b0d4832532df2ce9c1bdb04fdc5639e093e8 +size 16354 diff --git a/static/images/bluetooth/bluetoothctl-connection.png b/static/images/bluetooth/bluetoothctl-connection.png deleted file mode 100644 index 31a3042715..0000000000 --- a/static/images/bluetooth/bluetoothctl-connection.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:f26ad52d5f92c8f73283462b506c360be370074263efa3147f99e35cce724489 -size 121676 diff --git a/static/images/bluetooth/bluetoothctl-connection.webp b/static/images/bluetooth/bluetoothctl-connection.webp new file mode 100644 index 0000000000..ba13176797 --- /dev/null +++ b/static/images/bluetooth/bluetoothctl-connection.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d4e90ff9edbe20ce25325b9f0bab59b0716fb578f1e1ce8dd25c7721a699109b +size 58996 diff --git a/static/images/bluetooth/bluetoothctl-launch.png b/static/images/bluetooth/bluetoothctl-launch.png deleted file mode 100644 index 61ccf02696..0000000000 --- a/static/images/bluetooth/bluetoothctl-launch.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:696611a1a59afed9b11876c580fb4d3dc35dd4e99f15959680bf50d51b16f378 -size 38889 diff --git a/static/images/bluetooth/bluetoothctl-launch.webp b/static/images/bluetooth/bluetoothctl-launch.webp new file mode 100644 index 0000000000..259dbe21fb --- /dev/null +++ b/static/images/bluetooth/bluetoothctl-launch.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:7eea4e6c0ba3c3152cd4f8cae816d17c149d0f046c39a2c55042f8669a4461ef +size 9910 diff --git a/static/images/bluetooth/devices-available-applet.png b/static/images/bluetooth/devices-available-applet.png deleted file mode 100644 index 4f35c94d6e..0000000000 --- a/static/images/bluetooth/devices-available-applet.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:52c4e07a7e3e10db43785263e577fd554b54cd7b8048fc5ae2de7ea42d0f54e5 -size 195000 diff --git a/static/images/bluetooth/devices-available-applet.webp b/static/images/bluetooth/devices-available-applet.webp new file mode 100644 index 0000000000..1fcc97562c --- /dev/null +++ b/static/images/bluetooth/devices-available-applet.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:e050f25fffba4670009e5e66e8748c77b7cbaf562adb51cbd2da27edae2cb530 +size 11150 diff --git a/static/images/bluetooth/devices-available-settings.png b/static/images/bluetooth/devices-available-settings.png deleted file mode 100644 index f67793ff6a..0000000000 --- a/static/images/bluetooth/devices-available-settings.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:37d32d516706985aab7ba75a24e8274f4222c37d0398412aeae2d47f4ef04a48 -size 70601 diff --git a/static/images/bluetooth/devices-available-settings.webp b/static/images/bluetooth/devices-available-settings.webp new file mode 100644 index 0000000000..4d2a6fce05 --- /dev/null +++ b/static/images/bluetooth/devices-available-settings.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:5e041e7996a655b4a29c7a713802b2a5faba6850c66d8303cc3fb521e81b2298 +size 16918 diff --git a/static/images/bluetooth/devices-connected-applet.png b/static/images/bluetooth/devices-connected-applet.png deleted file mode 100644 index da39f8b08b..0000000000 --- a/static/images/bluetooth/devices-connected-applet.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:8a88d0038578da1319358ef4ce76f9fdb5ae02c914d35b42f2544e6bb2bc8fa7 -size 230105 diff --git a/static/images/bluetooth/devices-connected-applet.webp b/static/images/bluetooth/devices-connected-applet.webp new file mode 100644 index 0000000000..0529618ebc --- /dev/null +++ b/static/images/bluetooth/devices-connected-applet.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:31544dcf1394138c41d58321e2b2baba76a92591a2544d697e8c32436f72ff75 +size 10146 diff --git a/static/images/bluetooth/devices-connected-settings.png b/static/images/bluetooth/devices-connected-settings.png deleted file mode 100644 index 64b280f5a2..0000000000 --- a/static/images/bluetooth/devices-connected-settings.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:12776ebe9c5993caf96be3c04923822b79111278a575f7862372f32020f7e649 -size 54170 diff --git a/static/images/bluetooth/devices-connected-settings.webp b/static/images/bluetooth/devices-connected-settings.webp new file mode 100644 index 0000000000..837d8098c0 --- /dev/null +++ b/static/images/bluetooth/devices-connected-settings.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:908779a1e1a81ebd342d0905cd1f7b7b318b5bccc908ead581632da27a55a02f +size 13608 From de318a2f71213056b52e1bede5073eaae22cbafb Mon Sep 17 00:00:00 2001 From: Jacob Kauffmann Date: Thu, 9 Apr 2026 15:01:29 -0600 Subject: [PATCH 19/20] Consolidate audio tips --- content/bluetooth.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/content/bluetooth.md b/content/bluetooth.md index 8d1033da8e..cbd1c85f72 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -156,6 +156,16 @@ Several audio protocols exist for handling audio steaming over Bluetooth: You can try a different device profile by navigating to Settings -> Sound -> Device Profiles and using the drop-down next to your device. +#### Controlling Audio + +The default Settings app allows you to select one input or output device for all applications. You may want only certain applications to play through a Bluetooth speaker. PulseAudio Volume Control provides a more advanced GUI interface for routing audio in this manner. To install it, run this command: + +```bash +sudo apt install pavucontrol +``` + +There will be a drop-down in the Playback tab for each of your applications that's outputting sound, which you can use to select which set of speakers (e.g. built-in or Bluetooth) that application's sound will play through. + ### OS & Kernel Versions As the Linux kernel develops, support for more devices are added. Sometimes, Bluetooth devices will work better in a different kernel version. @@ -180,16 +190,6 @@ Rebooting is required to load the newly installed firmware. Beyond forgetting and re-pairing deivces, you can check if any local configuration files are causing problems with a device by creating a [test user](/articles/other-accounts) or booting from a [live disk](/articles/live-disk) to see if Bluetooth works in either case. If it does, config files in your normal user account may need to be deleted. -### Controlling Audio - -Once you're connected to a Bluetooth speaker, you may need to change where your current audio is "routed." PulseAudio Volume Control provides a more advanced GUI interface for routing audio. To install it, run this command: - -```bash -sudo apt install pavucontrol -``` - -There will be a drop-down in the Playback tab for each of your applications that's outputting sound, which you can use to send audio from individual applications to your Bluetooth speaker. - ### File Transfer Sometimes, additional programs need to be installed for mobile device file transfer to work. Install the Object Exchange (OBEX) packages with this command: From 4a0ad4c297976ce33586c6be270e328e08e705ae Mon Sep 17 00:00:00 2001 From: Jacob Kauffmann Date: Thu, 9 Apr 2026 15:02:18 -0600 Subject: [PATCH 20/20] Tweak kernel modules heading --- content/bluetooth.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/bluetooth.md b/content/bluetooth.md index cbd1c85f72..5a7295bcf3 100644 --- a/content/bluetooth.md +++ b/content/bluetooth.md @@ -240,7 +240,7 @@ To unblock all wireless types: sudo rfkill unblock all ``` -### Kernel Module +### Kernel Modules To show what Bluetooth kernel modules (drivers) are loaded: