Skip to content

SSE Events

All backends push state changes as Server-Sent Events (SSE). Connect once and get a unified stream of everything happening on the node.

GET /events
ParameterDescriptionExample
backendOnly receive events from this backend?backend=mpris
typesOnly receive these event types?types=player.updated,player.added
excludeExclude these event types?exclude=player.position
keepaliveKeepalive interval?keepalive=30s
EventBackendTrigger
player.updatedmprisPlayback state, volume, or metadata change
player.addedmprisNew player appeared
player.removedmprisPlayer closed
player.positionmprisPeriodic position tick
audio.updatedpulseaudioSink input added or changed
audio.removedpulseaudioSink input removed
service.updatedsystemdUnit state change
bluetooth.updatedbluetoothAdapter or device state change
power.actionpowerReboot or power-off triggered