Watermark
This content is for the 1.0 version. Switch to the latest version for up-to-date documentation.
Watermark draws a configurable text watermark in a corner of the player. Like Timestamp CCTV, it is a player-overlay plugin: pure config on the backend, with the frontend overlay reading that config and rendering the mark client-side.
| Plugin id | watermark |
| Category | tool |
| UI slot | player-overlay |
| Needs worker | No |
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). The overlay is a
pointer-events-none element, so it never intercepts player clicks.
Configuration
Section titled “Configuration”| Field | Type | Default | Description |
|---|---|---|---|
text |
string |
StreamHub |
The watermark text drawn over the player. |
position |
select |
bottom-right |
Corner. Options: top-left, top-right, bottom-left, bottom-right. |
opacity |
number |
0.6 |
Opacity of the watermark, 0–1. |
Enable and configure
Section titled “Enable and configure”Dashboard: open the app’s Plugins tab → Install Watermark → toggle Active → Configure the text, position and opacity.
API:
curl -X PATCH https://YOUR-DOMAIN/api/v1/apps/live/plugins/watermark \ -H "Authorization: Bearer sk_..." \ -H "Content-Type: application/json" \ -d '{"enabled": true, "config": {"text": "ACME TV", "position": "top-right", "opacity": 0.4}}'