Skip to content

bluebubbles

diapason.channels.bluebubbles

BlueBubblesChannel — BlueBubbles (iMessage bridge) adapter.

BlueBubblesChannel

Bases: BaseChannel

BlueBubbles (iMessage bridge) channel adapter.

Parameters

url: BlueBubbles server URL. Falls back to BLUEBUBBLES_URL env var. password: BlueBubbles server password. Falls back to BLUEBUBBLES_PASSWORD env var. bus: Optional event bus for publishing channel events.

connect()

Mark as connected (send-only — no persistent connection).

disconnect()

Mark as disconnected.

list_channels()

Return available channel identifiers.

on_message(handler)

Register a callback for incoming messages.

send(channel, content, *, conversation_id='', metadata=None)

Send an iMessage via the BlueBubbles API.

status()

Return the current connection status.