Timestamp CCTV

Timestamp CCTV overlays a live, ticking CCTV-style date/time stamp on the player, optionally prefixed with the camera / stream name. It is the reference example for a player-overlay plugin.

Plugin id	timestamp
Category	tool
UI slot	player-overlay
Needs worker	No

This is a client-side player overlay: the core only stores the typed config; the frontend overlay reads it and draws the stamp on top of the player (a pointer-events-none element in the chosen corner). Because it is a player-overlay, once installed + enabled it renders automatically on the app’s players — including the public /play and /embed pages (served the sanitized config via GET /apps/:app/plugins/public).

Configuration

Field	Type	Default	Description
format	select	datetime-24h	Time format. Options: datetime-24h (YYYY-MM-DD HH:mm:ss), datetime-12h (YYYY-MM-DD hh:mm:ss AM/PM), time-24h (HH:mm:ss), time-12h (hh:mm:ss AM/PM), date-us (MM/DD/YYYY HH:mm:ss).
position	select	bottom-right	Corner. Options: top-left, top-right, bottom-left, bottom-right.
color	string	#00e5ff	Hex colour for the overlay text (e.g. #ffffff, #00e5ff).
showName	boolean	true	Show the camera / stream name before the timestamp.

Enable and configure

Dashboard: open the app’s Plugins tab → Install Timestamp CCTV → toggle Active → Configure the format, position and colour. The overlay appears on the app’s players immediately.

API:

curl -X PATCH https://YOUR-DOMAIN/api/v1/apps/live/plugins/timestamp \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"enabled": true, "config": {"format": "time-24h", "position": "top-left", "color": "#ffffff"}}'

Note

As a player-overlay, this renders on anonymous players too. The public overlay endpoint sanitizes the config (secrets and callback/webhook URLs are stripped), but Timestamp’s fields are all cosmetic and safe to expose.