Omahub
Sign in with GitHub
← All plugins
S

Advanced Bluetooth Audio

by ssupt

Shows active codecs, makes connected devices the default output (and input when available), and remembers their preferred audio modes

GitHub
Install
$ omarchy plugin add https://github.com/ssupt/omarchy-bluetooth-audio --enable
Hardware #bar #quickshell #media

Advanced Bluetooth Audio for Omarchy

An extension of Omarchy's native Bluetooth panel that exposes the active PipeWire audio mode for connected headsets and speakers.

For Bluetooth audio devices, the panel shows the active codec beside battery status. When more than one safe mode is available, the arrow on the device row opens a keyboard- and pointer-friendly selector. Modes are labelled by their trade-off, such as High fidelity · AAC or Headset + microphone · mSBC.

Connecting a device does not redirect audio automatically. Use the audio action on a connected device to make it the default output; a microphone exposed by the selected mode becomes the default input at the same time. Audio-mode choices are remembered independently for each Bluetooth device by WirePlumber.

This is the Bluetooth-panel companion to Advanced Audio Control, which provides per-application output routing and the full Devices/Bluetooth settings window.

More plugins by ssupt: omarchy-plugins.

Install

omarchy plugin add https://github.com/ssupt/omarchy-bluetooth-audio.git --enable

Enabling the plugin replaces the built-in omarchy.bluetooth widget in its current bar position. Disabling or removing it restores the built-in widget.

Requires pactl, jq, and timeout, all present in a standard Omarchy installation.

Removing

omarchy plugin remove ssupt.bluetooth-audio

Removing the companion restores the built-in Bluetooth widget in its previous bar position.

Controls

  • Click a device row to connect or disconnect it.
  • Use the audio action on a connected device to make it the default audio device.
  • Click the arrow on a connected audio device to choose its audio mode.
  • Use j/k or the arrow keys to navigate devices.
  • Use h/l or Left/Right to reach the audio, forget, and preferred-mode actions.
  • Press Enter to activate the selected row or action, and Escape to close.

Profile changes preserve the device's previous volume and mute state. The transition temporarily mutes affected outputs and streams so a newly created profile cannot expose a previously stored high volume. WirePlumber stores the selected profile per device and restores it on later connections.

Development

./test/all
omarchy-plugin-validate .

The panel is kept as a focused clone of the current native Bluetooth widget so it retains Omarchy's discovery, connection, and multi-monitor behavior.