Elgato Stream Deck

Cliqer supports Elgato Stream Deck hardware through two independent integration layers. You can use either or both at the same time.

Supported Models

Direct HID mode supports all current Stream Deck models:

Smaller models prioritise core controls (arrows, timer, start/stop) and omit preset and ± buttons due to limited key space.

Button Layout (15-Key)

The standard 15-key Stream Deck uses the following layout:

 ┌────────┬────────┬────────┬────────┬────────┐
 │ P 5min │ P 10min│ P 15min│ P 20min│  +2    │  ← Row 0
 ├────────┼────────┼────────┼────────┼────────┤
 │  −5    │ TIMER  │  +5    │  ◀ Prev│ Next ▶ │  ← Row 1
 ├────────┼────────┼────────┼────────┼────────┤
 │ Reset  │ ▶ Start│  −2    │  −1    │  +1    │  ← Row 2
 └────────┴────────┴────────┴────────┴────────┘

• Preset buttons (P 5/10/15/20) — tap to set the timer to that duration. Labels update live when you change presets in the app.
• Timer display — shows the current countdown/count-up time.
• ±1 / ±2 / ±5 — add or subtract minutes from the timer.
• ◀ / ▶ (left / right arrows) — advance slides. A red flash confirms the click.
• Start / Stop — toggles the timer. Background turns green when running.
• Reset — resets the timer to the active preset value.

Method 1: Direct USB (HID)

No software installation required — just plug in your Stream Deck.

Setup

1. Connect your Stream Deck via USB
2. Launch Cliqer — the device is detected automatically
3. The connection status appears at the bottom of the main window

Cliqer communicates directly with the hardware over USB HID. All button icons are rendered dynamically using the Cliqer brand colours.

Click Feedback

When you press the ◀ or ▶ arrow button, Cliqer provides visual feedback with a red background that fades out over three steps:

1. Bright red background immediately on press
2. Dim red after 150 ms
3. Normal state restored after 300 ms

Method 2: Elgato Stream Deck Plugin

Use this method if you prefer to configure buttons inside the Elgato Stream Deck software.

Setup

1. Install the Cliqer Stream Deck Plugin (.streamDeckPlugin file bundled with Cliqer)
2. Open the Elgato Stream Deck application
3. Drag Cliqer actions onto your Stream Deck buttons
4. Launch Cliqer — the plugin connects automatically via WebSocket

Available Plugin Actions

The plugin exposes the following actions:

Preset Synchronisation

Timer presets stay in sync across all surfaces:

1. Change a preset value in the Cliqer Timer panel
2. The updated value is sent to the main process
3. HID buttons re-render with the new label
4. WebSocket plugin clients receive the updated preset data

This means your Stream Deck always reflects the current presets, even if you adjust them mid-presentation.

Troubleshooting

Stream Deck Not Detected (HID)

• Ensure the Stream Deck is connected via USB before launching Cliqer
• On macOS, grant Cliqer permission to access USB devices if prompted
• On Windows, ensure no other application (including the Elgato software) has exclusive access to the device
• Try unplugging and reconnecting the Stream Deck

Plugin Not Connecting

• Verify Cliqer is running — the WebSocket server starts with the app
• Check that your firewall is not blocking Cliqer's local connections
• Reinstall the plugin from the .streamDeckPlugin file

Buttons Not Responding

• Check the connection status at the bottom of the Cliqer main window
• Restart the Elgato Stream Deck application
• Ensure you are using a supported Stream Deck model

Previous: Custom Software | Next: Bitfocus Companion