Update COSMIC screenshots to latest version & optimize PNGs

Author: jacobgkau

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,15 +53,15 @@ 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:
 
 ```bash
 sudo systemctl enable --now bluetooth
 ```
 
-### Using Bluetooth Manager (blueman)
+## Using Bluetooth Manager (blueman)
 
 A third-party program called <u>Bluetooth Manager</u> 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 <MAC address>`, and select one to use with `select <MAC address`.
+
+Power the controller on and scan for available devices to connect to using the following commands:
+
+```
+power on
+scan on
+```
+
+Devices with human-readable names (such as a product name) will show them after the MAC address. To pair with a device, use the `trust <MAC address>` command. Use `devices` to see a list of paired devices.
+
+Finally, connect with the device using the `connect <MAC address>` 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 <controller_address>
-```
+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 <mac address>
+```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 <mac address>
-```
-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 <mac address>
+```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.