# CreateClip

Creates a video clip from video in a rolling buffer and saves it to the specified location.

Media Server does not transcode the video. The clip uses the same codecs as the video in the rolling buffer. Therefore to create clips in MP4 format and play them in a web browser you must have written video into the rolling buffer using a suitable MPEG4 audio profile and a suitable MPEG4 video profile (for example `mpeg4audio` and `mpeg4video_h264_sd`).

Video must exist in the rolling buffer for the start time that you specify (or begin within 15 seconds of the start time).

## Parameters

Parameter | Description | Required
--- | --- | ---
Duration | The amount of video to include in the clip. | Yes
OutputFormat | The format of the container file that is returned. | No
Path | The path, name, and file extension for the clip. If you do not set this parameter, the clip is returned in the response. Media Server must be permitted to write to the path (see AllowedOutputDirectoryCSVs). | No
StartTime | The time to begin the clip from (EPOCH milliseconds or ISO-8601 format). You must use UTC time. Video must exist in the rolling buffer for the start time that you specify (or begin within 15 seconds of the start time). If video begins within 15 seconds after the start time that you specify, Media Server automatically adjusts the start time. If there is no video in the rolling buffer within 15 seconds after the start time, the action fails. | Yes
Stream | The name of the rolling buffer to create the clip from. | Yes

## Example

    http://localhost:14000/action=CreateClip
                                        &Stream=BBCNews
                                        &StartTime=1393000074243
                                        &Duration=5minutes
                                        &Path=./temp/News1.ts

This action instructs Media Server to create a five minute clip from the `BBCNews` stream in the rolling buffer, beginning from Fri, 21 Feb 2014 16:27:54 GMT, and to save the clip as the `News1.ts` file in the `temp` directory.

## Response

Unless you set the `Path` parameter, the response is the video file.

    <autnresponse>
      <action>CREATECLIP</action>
      <response>SUCCESS</response>
      <responsedata></responsedata>
    </autnresponse>

_FT_HTML5_bannerTitle.htm