A professional stage countdown timer for live events, conferences and broadcast.
macOS · Windows · Raspberry Pi · iOS Companion · OSC · Bitfocus Companion · LTC · NDI · web mirror
30-day Full trial on every install. £8 unlocks every feature, for life.
UK buyers: +20% VAT at checkout · Outside the UK: flat £8, no tax added
/control panel lets you run the timer from any phone or tablet. Scan QR to connect instantly.Control KUMA Timer from your Elgato Stream Deck or any Companion-compatible controller. Grab the module package and import it straight into Companion 3.x — no terminal, no developer mode.
.tgz below.
@companion-module/base@2 · Requires Companion v4.3+ · Adds shared-password auth
.tgz above — no need to extract it.http://127.0.0.1:8000)..tgz.
Once the module is accepted into the official Companion module library this step disappears — it'll show up in the built-in search like any other integration.
KUMA Timer is distributed as direct downloads from this site. The macOS and Windows builds are code-signed — they install without Gatekeeper / SmartScreen warnings. The Raspberry Pi kiosk ships as an AppImage (AppImage convention — Linux apps are not code-signed). Every install starts with a 30-day Full trial — no card, no sign-up.
No Gatekeeper warning — Apple-notarized DMG. Double-click, drag to Applications, done. Works on macOS 13+ (Apple Silicon).
No SmartScreen warning — Azure-Trusted-Signed EXE installer. Runs on Windows 10 / 11 (x64).
One command turns a fresh Pi 4 or Pi 5 (Pi OS Bookworm 64-bit) into a dedicated KUMA Timer appliance — fullscreen timer on boot, web admin on the LAN. The installer handles every apt dependency; you don’t need to touch the AppImage manually.
Paste into an SSH session (or local terminal):
curl -fsSL https://raw.githubusercontent.com/pltech-dev/kuma-timer-releases/main/install-pi.sh | sudo bash
View script source on GitHub →
Installs KUMA in kiosk mode (fullscreen timer on boot, web admin at http://<pi-ip>/, default login kuma/kuma). Later updates from the web panel or sudo /opt/kuma-timer/update-kuma.sh.
📖 Full Raspberry Pi install guide →
☕ Support the project
Already own a Full licence? A coffee goes towards the next feature.
On first launch KUMA Timer will ask for permission to accept incoming network connections — this is required for OSC, Web Mirror, Web Controller and NDI.
Same codebase, three platforms. This table shows what each platform can do — the tier you run (Lite or Full) decides which of these are actually unlocked on your install. See the Lite vs Full comparison on the pricing page.
| Feature | 🍎 macOS | 🪟 Windows | 🥧 Raspberry Pi |
|---|---|---|---|
| Core timer | |||
| Countdown, count-up, pause, reset, hide | ✓ | ✓ | ✓ |
| Presets (quick-load & editor) | ✓ | ✓ | ✓ |
| Cues — load / next / prev / edit | ✓ | ✓ | ✓ |
| HH:MM:SS mode for long cues | ✓ | ✓ | ✓ |
| Time Glide (smooth time stretch) | ✓ | ✓ | ✓ |
| SMS flash message overlay | ✓ | ✓ | ✓ |
| Clock mode (wall clock) | ✓ | ✓ | ✓ |
| Display | |||
| Fullscreen text / round display modes | ✓ | ✓ | ✓ |
| Color thresholds + progress bar styles | ✓ | ✓ | ✓ |
| Custom fonts + background image | ✓ | ✓ | ✓ |
| Presenter View (second monitor) | ✓ | ✓ | — |
| Network integrations | |||
| OSC in/out (Companion, QLab, etc.) | ✓ | ✓ | ✓ |
| LTC timecode input | ✓ | ✓ | ✓ |
| Bitfocus Companion module | ✓ | ✓ | ✓ |
| Web admin panel (any device on LAN) | ✓ | ✓ | ✓ |
| KUMA Live cloud share (QR + link) | ✓ | ✓ | ✓ |
| KUMA Companion app (iPhone & iPad) | ✓ | ✓ | ✓ |
| NDI® output | ✓ | ✓ | — |
| CDEther (Interspace Ind.) hardware displays | ✓ | ✓ | ✓ |
| LimiTimer / DSAN PCT-2 (USB serial) | ✓ | ✓ | ✓ |
| Deployment & updates | |||
| Kiosk mode — fullscreen on boot, no desktop | — | — | ✓ |
| Auto-start on power-on (systemd) | — | — | ✓ |
| One-click update (web admin button) | ✓* | ✓* | ✓ |
| Config export / import (sync between devices) | ✓ | ✓ | ✓ |
| Code-signed installer (no browser warning) | ✓ | ✓ | — |
✓* = works with caveat — hover for details. Changes ship regularly; this table reflects the latest stable release.
Control KUMA Timer from Bitfocus Companion or any OSC-capable device. Default listen port: 9000
| Address | Argument | Action |
|---|---|---|
/kuma/start | — | Start timer |
/kuma/pause | — | Pause / resume toggle |
/kuma/reset | — | Reset to zero |
/kuma/hide | — | Toggle display visibility |
/kuma/time/add | — | +1 minute |
/kuma/time/sub | — | −1 minute |
/kuma/warp | int seconds | Load duration (e.g. 300 = 5:00) |
/kuma/preset | int ≥ 0 | Load preset by index (0 = first). Range depends on how many presets you've configured — max 10 in Lite, unlimited in Full. |
/kuma/cue | int index | Load cue from runsheet |
/kuma/settime | string HH:MM:SS | Load exact time (e.g. "01:30:00") |
Feedback from KUMA → Companion (default 127.0.0.1:12321):
| Address | Value | Sent when |
|---|---|---|
/kuma/timer | string e.g. "04:32" | Every 500 ms |
/kuma/status | "LIVE" · "PAUSED" · "STANDBY" · "HIDDEN" | On state change |
/kuma/overtime | 1 | On overtime start |