Use Livestreams when your content arrives as a live RTMP broadcast or a public HLS live URL and you want tracked sessions, a timeline, replays, and automatic workflow outputs.
What Livestreams is for
Open Livestreams from the left sidebar, under Media, to manage RTMP and HLS sources that feed your workflows. Choose RTMP push when you control an encoder such as OBS. Choose HLS URL when a provider already exposes a public live playlist and you want Overlap to pull it continuously. The Audio Livestream trigger remains the simpler choice for an audio URL that does not need the Livestream Tracker’s episode and timeline experience.
How it works
Each livestream you create has three parts:- Input — either an RTMP server/key or a public HLS live URL
- Ingestion interval — how often the incoming stream is cut into a recorded chunk, from every 3 minutes up to every hour
- Workflows to trigger — one or more workflows that run automatically on every chunk
Create a livestream
Open New Livestream, then choose RTMP push or HLS URL to open the setup dialog with that input type selected.
- Input type — choose RTMP push or HLS URL
- HLS source URL — required for HLS. Public URLs, embedded Basic Auth, and fixed query-string tokens are supported. The full URL is stored server-side; the portal shows only its hostname
- Start listening — HLS only; create the source as On, On Until, Scheduled For, or Off. Scheduled For can be configured before the livestream is created
- Name — a label to identify this livestream, such as
Morning Show - Workflows to run in the background — check every workflow that should run on each chunk. Only workflows that contain a trigger node are listed. Livestreams automatically use the first trigger node in the workflow
- Ingest while live — RTMP only, under Advanced settings; choose Whenever live, Until a specific time, On a schedule, or Off
- Ingestion interval — under Advanced settings, how long each recorded chunk should be. Shorter intervals get content into your workflows faster; longer intervals mean fewer, longer chunks. Defaults to 5 minutes if you leave it collapsed
Connect an RTMP encoder
Once a livestream is created, its card shows the Server URL and a masked Stream Key, each with its own copy button. Click the eye icon to reveal the key before copying it. In your broadcasting software, set:- Server (sometimes called Stream URL) to the livestream’s Server URL
- Stream Key to the livestream’s Stream Key
Live, and it switches back to Idle when the encoder disconnects.
Only one encoder can publish to a stream key at a time. While one is sending,
a second encoder using the same key is refused rather than taking over, so give
each encoder its own livestream. If your encoder drops, it can reconnect as soon
as Overlap notices the old connection is gone, within about 10 seconds.
Schedule RTMP ingest
Open an RTMP source’s Settings → Advanced settings → Ingest while live and choose On a schedule. Add a listening window, select its timezone, and set the start and end times — for example, 13:00–14:00 every day. You can also set this before creating the source. Windows can run once or repeat daily, weekly, or monthly, including overnight windows. The encoder must be broadcasting during the window; the schedule cannot start your encoder. Outside the window, Overlap keeps the RTMP connection open and pauses recording. Your encoder can connect early and stay connected across windows. Only footage received during a recording window is saved and sent to workflows; footage outside the window is not buffered for later processing. When the window closes, the final partial chunk still processes, and already-started workflows can finish. An uninterrupted encoder connection stays in the same tracked episode across recording windows. Each reconnect starts a new episode. Schedule transitions normally apply within 30 seconds, so this is not a frame-exact recording cutoff. Off pauses recording while retaining the connection; Disable disconnects the encoder. Changing the stream key or ingestion interval can also disconnect it. The card shows the saved policy, pending changes, and the next start or stop. Choose Whenever live to resume unrestricted ingest; your saved windows are kept. Disable pauses the source without removing its schedule; Enable resumes that policy. Timezones follow daylight saving changes: nonexistent spring-forward times move to the first valid minute, and repeated fall-back hours stay continuous.Connect an HLS source
For an HLS livestream, paste its public HTTP(S) live playlist URL during creation. Overlap shows the sanitized source hostname and a connection status:Connecting, Connected, or Unavailable. To rotate a fixed token or change
providers, open Settings, enter a replacement URL, and save. Leaving the
replacement field blank keeps the current URL. Switching input type or
replacing an active URL closes the current episode and starts a new one when
the new source connects. Audio-only radio playlists that use packed AAC
segments are supported and follow the same listening controls and tracker
behavior.
If the card reports an upstream HTTP status such as 404, the root playlist
or one of the playlists, renditions, or segments it references is unavailable.
Replace it with a working live playlist URL; Overlap validates every nested HLS
resource rather than treating a reachable master playlist as a connected feed.
Control when HLS listens
Open the HLS card’s⋮ menu and choose Listening:
- On listens continuously
- On Until starts now and turns Off at the date and time you choose
- Scheduled For listens during one-time, daily, weekly, or monthly windows
- Off disconnects without deleting the source URL, schedule, episodes, or outputs
Connect a Twitch channel
Twitch channel sources are being rolled out per organization. If Twitch
channel is not listed under Input type, ask your Overlap contact to
enable it.
twitch.tv link. There is no stream key, encoder, or OBS change: Overlap
watches the channel, starts recording when it goes live, and stops when the
broadcast ends. Each broadcast becomes its own tracked episode, and every chunk
runs through the workflows you selected.
- The card shows Waiting for the channel to go live between broadcasts. Overlap checks about every 30 seconds, so recording begins shortly after the stream starts.
- Overlap records the public stream at its best available quality. Subscriber-only streams cannot be recorded.
- Twitch ad breaks are not recorded. A break leaves a gap, and a break longer than about 10 seconds ends the current episode and starts a new one when the stream resumes.
- Listening (On, On Until, Scheduled For, Off) works the same way as for an HLS source and controls when Overlap watches the channel.
- To record a different channel, open Settings and change the channel name.
- If Overlap cannot open the channel’s stream for a few minutes, the card shows a red message and the Overlap team is alerted automatically. A channel that is simply offline keeps showing Waiting for the channel to go live.
Clip chat reactions
Overlap also follows the channel’s chat while it records. With Clip chat reactions on, a sudden burst of chat is treated as a sign that something just happened: Overlap clips that moment, starting a little before the burst, and runs it through the same workflows as the rest of the stream. These clips are in addition to the ones your workflows find in each chunk.- Each channel is measured against its own usual pace, so the setting works for small and large chats alike. Choose Only the biggest reactions, Balanced, or Smaller reactions too to control how often it clips.
- Chat has to be active for this to trigger: at least 8 different
viewers writing within about 10 seconds. Bot messages and
!commandsare ignored. - Nothing is clipped in the first two minutes of a broadcast, while Overlap learns the pace, and at most 8 chat clips are made per hour.
- The livestream page lists each reaction under Chat reactions, with its time, how busy chat was, and whether it was clipped.
Show chat on your clips
Add the Add Chat Highlights step to the workflow connected to your Twitch livestream, after the step that makes the clips. For each clip, Overlap reads the chat from that part of the stream and shows the messages the streamer responds to as cards on the video: one they read out, repeat, or answer. Each card appears as the streamer starts responding, so the viewer sees what they are reacting to. A clip where the streamer does not respond to chat gets no cards.- Style: Chat Card, Chat Bubble, or Chat Minimal, each with its own colors. Select one, or select several and your clips rotate between them, one style per clip, the way thumbnail presets rotate on Post to Social. The preview beside the step shows two sample cards in the style you last picked.
- Position: where the cards sit on the video. A second card stacks under the first.
- Cards per clip: leave on Automatic (about one per 15 seconds of clip, up to 5) or set a lower limit.
- Also show chat reactions: off by default. Turn on to also show the strongest reactions from chat (a line many viewers sent at once, or one viewer’s punchline) even when the streamer does not respond to them.
- Show viewer names: turn off to label every card “Chat” instead of the viewer’s username.
Audio-only sessions
Audio-only RTMP and HLS feeds are detected automatically. The tracker presents an audio-focused player and thumbnail while keeping the same episode timeline, replays, clips, and workflow outputs. Recorded chunks are normalized to a black 1280×720 H.264/AAC MP4, so existing workflows run normally;mediaKind remains
attached to the session as provenance.
Create a clip from a broadcast
Open a livestream, drag the red playhead (or click anywhere on the timeline line) to where the clip should start and click Mark In, then do the same for Mark Out and choose Create Clip. Each of the livestream’s workflows cuts exactly that range — no other clips — whatever its Find Clips strategy (Highlights, Montages, or Even Clips). When a clip you marked is ready, a Your clip is ready notification pops up on whatever Overlap page you’re on and stays until you close it. Click it to open the clip. Clips the stream finds on its own don’t pop up; they’re under the bell icon.- To adjust a clip before creating it, drag the green In or Out handle on the timeline; the player jumps to the frame you’re dragging to. You can also move the playhead and choose Set In or Set Out, or select a handle and use the arrow keys (Shift moves 5 seconds). In is grabbed from its left side and Out from its right, so both stay easy to pick out even when the clip is only a second or two long. The handles sit above the clip markers, so grabbing one never opens a clip.
- To place In and Out by ear, turn on Audio Enabled Scrubbing in
Settings→Video & export(off by default) and unmute the player. Dragging the playhead or an In/Out handle then plays the broadcast’s audio under the pointer: a slow drag plays it at normal speed, a fast drag skims short bursts, and holding still plays half a second past the pointer and then goes quiet. The video pauses while you drag and picks up again when you let go, only if it was playing. Parts of the broadcast that are still recording stay silent until they upload. - A clip is not limited to one ingestion interval: it can cover up to 12 recorded chunks (an hour at the default 5-minute interval). When the range crosses several chunks, those chunks are joined into one video first (you’ll see “Joining N recorded chunks into one video” above Outputs), then the clip is cut from it as a single run. This takes a little longer than a clip inside one chunk.
- A range reaching into the part still being recorded is queued and cut automatically once that part finishes.
- Clips are positioned on the broadcast timeline where they were cut from, as markers in a shaded clip lane under the timeline line, with a faint tick on the line showing where each one sits. Clips that overlap (from several workflows, say) get their own row in the lane, so each one can be clicked: older clips keep their row, and newer ones go in a free spot or a row below, so the lane doesn’t reshuffle as clips arrive during a live stream. Click a marker to open its clip in the editor like any other clip. Vertical reframing still applies its own 12-minute limit.
- If joining the chunks fails, the range shows the error above Outputs and you get an in-app notification; try again or pick a shorter range.
Clip from the transcript
Switch the view above the player from Video to Transcript to read the broadcast as text. Search for a word or phrase (Enter and Shift+Enter step through every match), then select the words you want and choose Create clip. The Create Clip popover opens with In and Out set to the selected words, to the millisecond, so you can adjust them before creating the clip.- The clip starts with the first selected word and ends with the last. Where there is a pause next to the selection, the cut moves a little into it (at most 0.3 seconds) so no word is cut off.
- Click a word or a paragraph’s time to jump the player there; Preview switches to the Video view at the start of the selection. Shift-click a word to extend a selection.
- The play/pause button next to the timeline’s zoom controls (or the Space key, in either view) plays or pauses the broadcast without leaving the transcript. Switching to Video and back keeps your place in the transcript, along with your search and selection.
- Each part of the broadcast is transcribed a few minutes after it is recorded, so while live the newest few minutes have no text yet. New text appears as it arrives without clearing your selection, and the whole broadcast is available once the stream ends.
- Parts that are still transcribing, failed, or were never processed are marked in place, and parts with no speech say so.
Find a past broadcast
The Outputs dropdown on a livestream lists every broadcast, newest first, grouped by day. Each one shows when it started and ended in your own time zone and how much was recorded, for example 8:52 AM – 9:29 AM · 37 min. Older broadcasts recorded before this information existed show an approximate start time instead, such as ~8:57 AM. Broadcasts under a minute long aren’t listed. They are a few seconds each, left over when an encoder drops and reconnects, and hold nothing usable. The page stays on the broadcast you are looking at. When a new broadcast starts, whether the next show or an encoder reconnecting, your clips, timeline, transcript selection and any In/Out marks stay where they are, and a notice at the top offers Watch live to switch. The player shows that broadcast’s own recording (scrub the timeline or click Play recording), not the new live feed, so the video on screen is always the broadcast your clips and marks belong to. Switching broadcasts, from the notice or the dropdown, clears In/Out marks, since they belong to the other timeline.Download a full broadcast
Open a livestream, pick a finished broadcast from the Outputs dropdown, and click Download broadcast to get the whole recording as one MP4 at the quality your encoder sent.- The recording is stitched the first time anyone asks for it. If it’s ready within the time you stay on the page, the download starts automatically.
- Otherwise you’ll get an email and an in-app notification with a download link. The link works for 7 days; clicking Download broadcast again gives you a fresh one.
- Broadcasts can be downloaded for 30 days. After that the recording is deleted.
- The button is hidden while a broadcast is still recording.
- Reconnecting an encoder starts a new broadcast, so a show interrupted by a disconnect downloads as separate files.
Managing a livestream
Use the⋮ menu on a livestream’s card to:
- Settings — change the name, ingestion interval, selected workflows, or RTMP ingest schedule
- Listening — HLS and Twitch; choose On, On Until, Scheduled For, or Off
- Disable / Enable — RTMP only; reject new publishes without deleting the livestream or losing its configuration
- Regenerate key — RTMP only; issue a new stream key and invalidate the old one immediately
- Source details — HLS and Twitch; view the hostname or channel and current connection status without exposing a complete HLS URL
- Delete — remove the livestream and its stream key permanently
How this fits with workflows
Livestreams doesn’t add node-level skips to the workflow builder — it drives whatever trigger node your workflow already starts with, the same way a manual upload or another trigger would. Audio-only chunks arrive as normalized black-screen video, so the configured workflow and its existing safeguards run normally. Build the rest of the workflow as described in Workflows and Nodes.