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 adapts its button layout to the number of keys on the device:

Smaller models prioritise core controls (arrows, timer, start/pause) and omit preset and ±1 / ±2 buttons due to limited key space. Any other key count falls back to the 15-key layout.

Button Layout (15-Key)

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

• 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 / Pause, 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, the key briefly flashes red and then fades back to its normal state, giving you a clear visual confirmation that the slide command was sent.

Method 2: Elgato Stream Deck Plugin

Use this method if you prefer to configure buttons inside the Elgato Stream Deck software. The bundled plugin is version 1.2.0.0 and requires Elgato Stream Deck software 6.6 or newer (macOS 10.15+, Windows 10+).

Setup

1. Install the Elgato Stream Deck software (6.6 or newer) and launch it at least once
2. Launch Cliqer, it drops the Cliqer plugin into the Stream Deck plugins folder
3. Restart (or refresh) the Stream Deck software so it discovers the plugin
4. Drag Cliqer actions onto your Stream Deck buttons, they connect to the running app automatically

Available Plugin Actions

The plugin exposes the full control surface:

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. The plugin reads the new preset values from the timer API and re-labels its preset keys

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 local servers start with the app
• Restart the Elgato Stream Deck software so it discovers a freshly installed plugin
• Check that your firewall is not blocking Cliqer's local (loopback) connections

Buttons Not Responding

• Check the connection status at the bottom of the Cliqer main window
• Confirm you are on Cliqer 2.0.7 or newer (earlier builds had unresponsive timer keys)
• Caller, screen-share and NDI keys act on macOS; on Windows the caller keys have no effect
• Restart the Elgato Stream Deck software

Only One Bridge Per Machine

Cliqer binds its local ports (2222, 24601, 9052) once per machine. Running a second copy of Cliqer on the same computer leaves the second instance unable to claim those ports, so its Stream Deck (and Companion) bridge will not work. Run a single Cliqer instance per machine.

Previous: Custom Software | Next: Bitfocus Companion