> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://fastpix.com/docs/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://fastpix.com/docs/_mcp/server. # Clip moments from a live stream ## What is live clipping? Live clipping is the process of capturing and creating short video clips from a live stream as it happens. This feature lets broadcasters instantly extract key moments, turning them into highlights, social media content, or on-demand clips. It eliminates the need to wait for the live stream to finish, making it perfect for sharing engaging moments in real time. \ > **NOTE** > > When you create a live clip using the stream URL, the clip is automatically converted into an on-demand media file. This means that your extracted clip remains accessible even after the live stream ends, making it available for further viewing or sharing. > > You can also specify the access policy for the on-demand media that is generated by providing a query parameter (`clipAccess`). If no custom policy is set, the access policy for the generated clip will default to the livestream’s access policy. If you prefer hands-on instructions, the [Instant Live Clipping recipe](/recipes/instant-live-clipping) walks you through the entire process. \ ## Set up a live stream Both clipping methods need an active live stream to work from. You can create one in the FastPix dashboard or with the [Create new live stream API](/live-stream-api/start-live-stream/create-new-stream). 1. In the FastPix dashboard, open **Live** and create a live stream with either **Default settings** or **Custom settings**, then select **Create live stream**. To let viewers seek back through the stream while it's still live, turn on **Enable DVR mode**. 2) Open the new stream and go to **Overview**. Copy the **RTMPS URL** and **Stream key**, then enter them in your broadcasting software, such as OBS, vMix, or Wirecast. 3. Start streaming from your software. FastPix detects the feed automatically, and the stream's status changes to **Active**. For the stream-URL clipping method, you also need the stream's **Stream URL**, which you build from the stream's playback ID. It works in any HLS-compatible player and is the basis for generating clips with query parameters: **`URL`** ```Text URL https://stream.fastpix.com/{PLAYBACK_ID}.m3u8 ``` \ ## Create clips from the dashboard After your stream is **Active**, you can create clips visually from the dashboard while the stream is live. Each clip is saved as a separate on-demand media asset with its own playback ID. ### Create a clip 1. Open your live stream and select **Create Clips**. Let the stream run for at least 20 seconds. The clip controls stay disabled until the stream reaches this minimum duration. 2) In the player, pause at the moment you want to clip. You can create a clip only while the video is paused. 3) Set the clip's **Start time** and **End time**, either by entering timecodes or by dragging the handles on the timeline. To check your selection before you save, select **Preview Clip**. 4. Open the **Create as Public Clip** menu and choose an access policy: * **Create as Public Clip**: anyone with the link can play the clip. * **Create as Private Clip**: playback is restricted and requires a signed token. See [Secure playback with JWTs](/video-security/generate-jwts-for-secure-media). ### Find your clips Your clips appear under **Clips generated from your live stream**, with a media ID, status, duration, and creation date. A clip shows **Processing** while FastPix generates it and **Ready** once it's available to play. Select a **Ready** clip to open it as a standalone on-demand media asset, where you can find its **Media ID** and **Playback ID**, generate thumbnails, add subtitles, and run In-Video AI features. To create clips programmatically instead, use the [stream-URL method](#generate-clips-from-the-stream-url). \ ## Generate clips from the stream URL Creating a live clip involves defining the clip's duration by appending query parameters to the Stream URL. FastPix simplifies this process by using start and end times in seconds. \ > **NOTE** > > When you generate a live clip using the Stream URL, the clip is automatically converted into an on-demand media file. This ensures that the clip remains accessible even after the live stream ends. \ **Use the Stream URL with query parameters** You can generate a live clip by adding `start` and `end` parameters to your Stream URL. These parameters define the beginning and end of your clip. \ **Example:** **`URL`** ```text URL https://stream.fastpix.com/{PLAYBACK_ID}.m3u8?start=10&end=70 ``` This URL extracts a 60-second clip starting from the 10-second mark to the 70-second mark. \ > **NOTE** > > The maximum duration for a clip is 20 minutes. If the start and end parameters exceed this limit, the clip will be automatically trimmed to 20 minutes. \ ### Access policy for clips You can also control the access policy of the generated on-demand media by specifying a `clipAccess` query parameter. > **NOTE** > > Using the `clipAccess` parameter separately will result in another on-demand clip. It's better to combine `start`, `end`, `clipAccess` parameters all at once depending on your requirement. \ **`Example`** ```http Example https://stream.fastpix.com/{PLAYBACK_ID}.m3u8?start=10&end=70&clipAccess=private ``` \ * If `clipAccess=private`, the generated clip will be restricted to authorized users. To control who can access private clips, use secure playback with JWTs. See [Secure playback with JWTs](/video-security/generate-jwts-for-secure-media) for details. \ * If `clipAccess=public`, the generated clip will be accessible to anyone with the link. \ * If no `clipAccess` parameter is provided, the access policy of the generated clip will default to the access policy of the livestream. \ ## Retrieve clip and playback If you want to later retrieve the generated clip (stored as on-demand media) - use the [get all clips from live stream](/video-on-demand-api/manage-videos/list-live-clips) API by passing the `streamId` of the actual live stream. The response will give you a list of all clipped media IDs along with other details related to the clipped media. To initialize playback of the media, take the underlying `playbackId` from the specific clipped media and insert it in the stream URL below. **`Example`** ```json Example https://stream.fastpix.com/{PLAYBACK_ID}.m3u8 ``` You can use this URL (with .m3u8 extension) in other video players as per your use case. \ Otherwise, to directly stream your clipped media on a browser, you can also use the playback stream URL which is sharable. Simply preview your video by putting the `playbackId` on the stream URL. **`Example`** ```Text Example https://play.fastpix.com/?playbackId={PLAYBACK_ID} ``` \ ## Guidelines for start and end times To ensure your live clips are generated correctly, follow these guidelines: * **Use positive values only**: Both `start` and `end` times must be positive integers, representing seconds in the livestream. Negative values are not allowed and will result in an error. \ * **Start time must be earlier than end time**: The `start` time must always precede the `end` time. Providing an end time that is less than the start time is invalid and will prevent the clip from being generated. \ * **Valid time range**: Ensure the `start` and end times fall within the duration of the live stream. For example, if the live stream has only reached 20 seconds, specifying `end=30s` will result in an error. \ ## What's next A live clip is saved as an on-demand asset, so you can keep working with it like any other video: * [Upload videos from device](/upload-videos/upload-videos-from-device) to add more source videos. To edit and transform videos, see: * [Add metadata to videos](/video-on-demand/add-metadata-to-videos) * [Add a watermark to a video](/video-on-demand/add-a-watermark-to-a-video) * [Add an intro and outro to a video](/video-on-demand/add-an-intro-and-outro-to-a-video) * [Clip and trim videos](/video-on-demand/clip-and-trim-videos) * [Merge and stitch videos](/video-on-demand/merge-and-stitch-videos) * [Remove unwanted video segments](/video-on-demand/remove-unwanted-video-segments)