-
-
Notifications
You must be signed in to change notification settings - Fork 6
Features Connection
Tuck edited this page Jun 28, 2026
·
1 revision
Manage the daemon connection lifecycle — subscribe to events, unsubscribe, and disconnect cleanly.
Subscribe to one or more event patterns. The daemon pushes events matching the subscribed patterns to the client in real-time.
| Parameter | Type | Description |
|---|---|---|
events |
string[] | Event patterns to subscribe to (supports wildcards) |
Event pattern examples:
-
screencast.*— all screencast events -
update.*— update-related events -
notification.*— notification events -
rule.*— rule engine events -
agent.*— agent messaging events
deskbrid subscribe '["screencast.*", "notification.*"]'{"type": "connection.subscribe", "events": ["screencast.*", "notification.*"]}The daemon will push events as they occur:
{"type": "event", "event": "screencast.started", "data": {"output_path": "/tmp/rec.mp4"}}Unsubscribe from one or more event patterns.
| Parameter | Type | Description |
|---|---|---|
events |
string[] | Event patterns to unsubscribe from |
{"type": "connection.unsubscribe", "events": ["screencast.*"]}Disconnect from the daemon cleanly.
deskbrid disconnect{"type": "connection.disconnect"}No response is sent — the connection is closed immediately.
from deskbrid import Deskbrid
client = Deskbrid()
# Subscribe to events
client.connection_subscribe(events=["screencast.*", "update.*"])
# Later, unsubscribe
client.connection_unsubscribe(events=["screencast.*"])
# Disconnect
client.connection_disconnect()Stable — subscribe, unsubscribe, and disconnect supported.
- Accessibility
- Apps
- Audio
- Backlight (LED driver)
- Bluetooth
- Clipboard
- Color Picker
- Desktop Portal
- Desktop Settings
- Files
- Hotkeys
- Input
- Keyboard Layouts
- Media (MPRIS)
- Monitors
- Network
- Notifications
- Print (CUPS)
- Screenshots
- Screen Recording
- Screencast
- Self-Update
- System
- System Tray
- Systemd Units & Timers
- Terminals (PTY)
- Windows & Workspaces