Live Events
Live Events are scheduled, one-time broadcasts — such as sports matches, concerts, product launches, or webinars. Unlike always-on live channels, a live event has a defined start time, duration, and end time, and goes through a clear lifecycle from announcement to replay.
How Live Events Work
Section titled “How Live Events Work”A live event progresses through four stages automatically:
| Stage | When | What Happens |
|---|---|---|
| Scheduled | Before the announcement window | The event exists in the admin panel but is not visible to viewers. |
| Upcoming | Within the announcement window before start | The event appears in swimlanes so viewers can discover it. A countdown is shown. |
| Live | Between start and end time | The stream is active. Viewers see a “Live” indicator and can watch in real time. |
| Ended | After the end time | The stream stops. If recording is enabled, the event becomes available as a replay. |
Creating a Live Event
Section titled “Creating a Live Event”-
Go to Media Catalog → Events → Active
-
Click New
-
Fill in the event details:
Field Description Event Name Display name shown to viewers External Manifest URL (Optional) HLS or DASH manifest URL if the stream is delivered externally. Leave empty to use Vidori CDN with RTMP ingest. Scheduled Start Date and time the event begins (picked in your local timezone) Duration How long the event lasts (30 minutes to 24 hours) Announcement How far in advance the event appears in swimlanes (1 hour to 7 days) Record After Event Whether to save the recording as a replay after the event ends (Cloudflare CDN only) -
Click Create
The live event is created in Draft status. Publish it when you are ready for it to be announced to viewers.
Editing a Live Event
Section titled “Editing a Live Event”Open the sidebar for any live event by clicking on it in the events table. The sidebar has multiple tabs:
Publishing Tab
Section titled “Publishing Tab”Contains the scheduling and configuration fields:
- Scheduled Start — adjust the start time
- Duration — change the event length (the end time is computed automatically)
- Announcement — change how early the event becomes visible
- Record After Event — toggle replay recording on or off
Changes are saved immediately when you update a field.
Ingest Tab
Section titled “Ingest Tab”The Ingest tab displays the streaming configuration for events using the Vidori CDN:
| Field | Description |
|---|---|
| Provider | The streaming provider (e.g. Cloudflare Stream) |
| RTMPS URL | The RTMP ingest endpoint — copy this into your encoder |
| Stream Key | Your unique stream key — copy this into your encoder |
| SRT URL | Alternative SRT ingest endpoint (if available) |
| Content inbound URI | Full push URL, also shown split into Server and Stream Key for convenience |
| Content source whitelist | Controls which sources are allowed to push content to the stream |
For events using an external manifest, the Ingest tab shows only the External Manifest URL field, which you can edit to update the HLS or DASH manifest URL.
Metadata Tab
Section titled “Metadata Tab”Contains detailed asset information, age ratings, localization settings, and metadata translations.
Deleting Live Events
Section titled “Deleting Live Events”You can delete events in two ways:
- Individual delete: Click the delete icon in the actions column for any event row. A confirmation prompt will appear before deletion.
- Bulk delete: Select multiple events using the checkboxes in the table, then click the delete button in the toolbar.
Event Status in the Table
Section titled “Event Status in the Table”Each live event shows a status tag next to its name in the table:
| Tag | Meaning |
|---|---|
| Upcoming (blue) | The event has not started yet |
| Live (red) | The event is currently broadcasting |
| Ended (grey) | The event has finished |
The table also shows Duration (e.g. “1h30m”) and Start as a relative time (e.g. “in 5h30m” or “2h ago”), making it easy to see at a glance which events are active across your catalog.
Announcement Window
Section titled “Announcement Window”The announcement window controls when the event becomes visible to viewers in your app. For example, if an event starts on Saturday at 8 PM and the announcement is set to 3 days, the event will appear in swimlanes starting Wednesday at 8 PM.
During the announcement window, viewers see:
- The event title, description, and poster
- The scheduled start time in their local timezone
- A countdown to the start of the event
Stream Sources
Section titled “Stream Sources”Live events support two stream sources, just like regular live channels:
Push your live stream from an encoder (OBS, Wirecast, vMix, etc.) to Vidori’s RTMP ingest.
- Open the live event and go to the Ingest tab
- Copy the RTMPS URL (or SRT URL) and Stream Key
- Configure your encoder and start streaming before the scheduled start time
See Live Streaming Setup for encoder settings.
Provide an HLS (.m3u8) or DASH (.mpd) manifest URL from your existing streaming infrastructure.
Enter the URL in the External Manifest URL field when creating the event. The player will connect directly to your manifest — no Vidori CDN bandwidth is used.
Replay (Record After Event)
Section titled “Replay (Record After Event)”When Record After Event is enabled, the broadcast is automatically saved after the event ends. The recording becomes available as a replay that viewers can watch on demand.
How Replay Works
Section titled “How Replay Works”- During the event, the stream is recorded on the CDN (Cloudflare)
- When the event ends, the recording is finalized
- The event transitions from “Live” to “Ended” and the replay is available immediately
- Viewers who open the event after it ends see the full recording and can seek through it like any on-demand video
Disabling Replay
Section titled “Disabling Replay”If you do not want the recording to be available after the event, leave Record After Event off. The event will simply show as ended with no playback available.
Live Events in Your App
Section titled “Live Events in Your App”Live events appear in your app through swimlanes, just like other content. When a live event enters its announcement window, it becomes eligible for swimlane data sources that include live events.
Viewer Experience
Section titled “Viewer Experience”- Before the event: Viewers see the event card with a countdown and scheduled start time
- During the event: Viewers see a “Live” badge and can tap to watch. Late joiners start at the live edge.
- After the event: If replay is enabled, viewers can watch the full recording. If not, the event is no longer shown.
Supported Platforms
Section titled “Supported Platforms”Live events work on all platforms supported by Vidori:
- Web (desktop and mobile browsers)
- iOS and Android native apps
- Smart TVs (Samsung Tizen, LG WebOS)
- Connected TV (Roku, Fire TV, Apple TV)