Protocol Specification

Message Format

All messages follow the JSON-RPC 2.0 specification. Three message types:

// Request (requires response)
{ "jsonrpc": "2.0", "id": 1, "method": "navigation/goto", "params": { "slide": 5 } }

// Response
{ "jsonrpc": "2.0", "id": 1, "result": { "slide": 5, "total": 20 } }

// Notification (fire-and-forget, no id)
{ "jsonrpc": "2.0", "method": "state/changed", "params": { "slide": 5, "total": 20 } }

Capability Groups

During initialization, the presentation declares which capability groups it supports. Controllers should only use methods from supported groups.

Core Methods(required)

Jump Navigationnavigation.jump

Navigate directly to a specific slide by number.

Section Navigationnavigation.sections

Navigate by named sections/topics instead of slide numbers.

Lifecyclelifecycle

Start, stop, pause, and resume the presentation.

Display Controldisplay

Screen blanking (blackout/whiteout) and overview mode.

Speaker Notescontent.notes

Retrieve speaker notes for any slide.

Metadatacontent.metadata

Retrieve presentation metadata (title, author, sections).

Laser Pointerpointer

Show a laser pointer overlay at specific coordinates.

Annotationsannotations

Draw annotation strokes on slides.

Error Codes