Sign in

Elgato Stream Deck

Control Cliqer with an Elgato Stream Deck through the bundled Elgato Stream Deck plugin.

Cliqer works with Elgato Stream Deck hardware through the bundled Cliqer plugin for the Elgato Stream Deck software.

Stream Deck Plugin

Configure your buttons inside the Elgato Stream Deck software. The bundled plugin is version 1.3.1.0 and requires Elgato Stream Deck software 6.6 or newer (macOS 10.15+, Windows 10+).

Auto-Install: Cliqer installs the plugin into the Elgato Stream Deck plugins folder on launch, and updates it automatically whenever the app ships a newer version. There is no .streamDeckPlugin file to open by hand.

Setup

Install the Stream Deck software

Install the Elgato Stream Deck software (6.6 or newer) and launch it at least once

Launch Cliqer

Launch Cliqer, it drops the Cliqer plugin into the Stream Deck plugins folder

Restart the Stream Deck software

Restart (or refresh) the Stream Deck software so it discovers the plugin

Add Cliqer actions

Drag Cliqer actions onto your Stream Deck buttons, they connect to the running app automatically

Lock-safe updates: If the Stream Deck software is running while Cliqer updates the plugin, the refresh is deferred to the next launch instead of overwriting a plugin that is in use, so a running install is never left half-written.

Available Plugin Actions

The plugin exposes the full control surface:

ActionDescription
Left Click / Right ClickAdvance slides (previous / next). A red flash confirms the click.
Timer DisplayLive countdown / count-up readout rendered on the key
Start / PauseA single key toggles the timer between running and paused
Reset TimerReset the timer to the active preset
+1 / +2 / +5 min, −1 / −2 / −5 minAdd or subtract minutes
Preset 5m / 10m / 15m / 20mSet the timer to a fixed duration
Caller 1-9 to ProgramTake a numbered caller to the program bus. The key turns red on air and shows the caller's name.
Clear Program (Black)Cut the program bus to black
Stop Screen ShareStop sharing your screen to the audience
Toggle Program NDIToggle the program NDI output (advanced)
Toggle Timer NDIToggle the timer NDI output
Cliqer ActionRun any action from Cliqer's External Control list
Local Connection: The plugin talks to Cliqer over loopback only (127.0.0.1), so no data leaves your machine. Slide, timer and preset keys use the clicker API on port 2222; caller, screen-share and NDI keys use the action API on port 24601; live key state (timer, on-air callers, toggle state) arrives over the WebSocket feed on port 9052.

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. 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

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

  • On macOS, check the deck in Settings > Control > Stream Deck
  • Caller and Clear Program keys need a plan with Studio control
  • Restart the Elgato Stream Deck software
Settings, Control on Mac with the Stream Deck section listing a Stream Deck MK.2 over USB in HID mode and a Stream Deck + through the Elgato software in Plugin mode, both Connected

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