Features Audio

Audio

Control audio sinks and volumes (Linux PulseAudio/PipeWire).

List Audio Sinks

deskbrid audio sinks

Response:

{
  "type": "response",
  "status": "ok",
  "data": [
    {
      "name": "alsa_output.pci-0000_00_1f.3.analog-stereo",
      "description": "Built-in Audio Analog Stereo",
      "volume": 75,
      "muted": false,
      "default": true
    }
  ]
}

Set Volume

deskbrid audio volume 50          # Set to 50%
deskbrid audio volume +10         # Increase by 10%
deskbrid audio volume -5          # Decrease by 5%
deskbrid audio volume 100 --sink alsa_output.pci-0000_00_1f.3.analog-stereo

Protocol:

{"action": "audio.set_volume", "volume": 50, "sink": "alsa_output.pci-0000_00_1f.3.analog-stereo"}

Mute Toggle

deskbrid audio mute           # Toggle mute on default sink
deskbrid audio mute --sink alsa_output.pci-0000_00_1f.3.analog-stereo

Protocol:

{"action": "audio.set_mute", "muted": true, "sink": "alsa_output.pci-0000_00_1f.3.analog-stereo"}

Set Default Sink

deskbrid audio set-default --sink alsa_output.usb-headphones.analog-stereo

Protocol:

{"action": "audio.set_default_sink", "sink": "alsa_output.usb-headphones.analog-stereo"}

Python Example

from deskbrid import Deskbrid

client = Deskbrid()

# List sinks
sinks = client.audio_sinks()
for sink in sinks:
    print(f"{sink['description']}: {sink['volume']}%")

# Muting
client.audio_set_mute(True, sink="alsa_output.pci-0000_00_1f.3.analog-stereo")