Timer
Cliqer includes a built-in presentation timer with countdown and count-up modes, customizable presets, a fullscreen display window, and a REST API for external control.
Timer Modes
| Mode | Description |
|---|---|
| Count Down (default) | Counts from the set time to 0:00. Enters overtime (red) if it passes zero. |
| Count Up | Counts from 0:00 upward to track elapsed time. |
Toggle between modes in Settings → Behavior → Count Down/Up.
Presets
Four customizable presets let you quickly set common timer durations:
- Default values: 5, 10, 15, and 20 minutes
- Tap a preset to set the timer to that value
- Edit a preset by selecting it and adjusting the minutes — the new value is saved automatically
Quick Adjust Buttons
In addition to presets, the timer offers quick-adjust controls:
| Button | Action |
|---|---|
| +1 / +2 / +5 | Add 1, 2, or 5 minutes to the timer |
| −1 / −2 / −5 | Subtract 1, 2, or 5 minutes |
| Start / Stop | Toggle timer running state |
| Reset | Reset to the active preset value |
These are available in the Cliqer UI, on connected Stream Deck hardware, and via the Timer API.
Fullscreen Timer Window
Open a dedicated fullscreen timer display for confidence monitors or stage displays:
- Click the fullscreen timer button in the Timer panel
- A new window opens showing the timer in large, easily readable text
- The display updates in real time as the timer counts
Timer API
Control the timer remotely via Cliqer's local HTTP API. Endpoints are served on the same local address used by the Cliqer host application.
Read Timer State
GET /timer/state
Returns the current timer state:
{
"time": "14:30",
"isRunning": true,
"isOvertime": false,
"presets": [5, 10, 15, 20]
}
Timer Actions
POST /timer/:action
| Action | Description |
|---|---|
start | Start the timer |
stop | Stop the timer |
reset | Reset to active preset |
plus1 / plus2 / plus5 | Add 1 / 2 / 5 minutes |
minus1 / minus2 / minus5 | Subtract 1 / 2 / 5 minutes |
preset5 / preset10 / preset15 / preset20 | Set timer to a preset value |
Overtime Behaviour
When the timer reaches 0:00 in countdown mode and continues running:
- The timer enters overtime and counts negative (e.g.,
−1:30) - The display colour changes to red to alert the presenter
- The overtime state is reflected in the API response (
isOvertime: true) - Stream Deck timer display turns red
See also: Stream Deck Integration · NDI Timer Output