The FFmpeg Producer can play all media that FFmpeg can play, which includes many QuickTime video codec such as Animation, PNG, PhotoJPEG, MotionJPEG, as well as H.264, FLV, WMV and several audio codecs as well as uncompressed audio.

The FFmpeg Producer can also play from direct show devices such as USB cameras connected to the server.

Please see the AMCP commands section for a complete reference of the AMCP commands used to control this module.

All files played by this producer must be placed in the _Media sub folder, by default C:\CasparCG_Media

You can play two simultaneous video files from disk to the same consumer during any of the built-in transitions such as mix, wipe, push and slide of a user-selectable number of frames. If your video files have alpha channel (key) those will work as well.

The FFmpeg producer supports “libavfilter” filters through the FILTER parameter in the LOADBG command.

Even though most producers support Unicode characters, there are some limitations in the FFmpeg Producer that causes media not to be found if it contains less common characters and even spaces. This can be avoided by always enclosing file names in quotation marks when they are being sent in AMCP commands, or by avoiding them when naming the files.

Recommended: Show-Titles_A_03_Upper_Alpha.mov

Can cause problems in FFmpeg Producer if commands are not enclosed in quotation marks: Show Titles A 03 Upper Alpha.mov

The general format of the AMCP command is:

PLAY <channel>-<layer> <resource> <parameters> ...

channel is the output channel on which to play the resource.

layer is the channel layer on which to play the resource.

resource is a resource identifier. This can be a filename, or a URI like specification such as "dshow://video=Some Camera" which will open the USB camera 'Some Camera' connected to the CasparCG server.

{LOOP}

If this parameter is sent with either LOADBG, LOAD, PLAY or CALL, the file will automatically loop.

Example:

PLAY 1-1 MOVIE LOOP

SEEK [frames:int]

Currently only supported for video files, not audio files.

If this parameter is sent with either LOADBG, LOAD, PLAY or CALL it sets the start of the video file, in frames. This producer will instantly start playing at this point.

Example:

PLAY 1-1 MOVIE SEEK 100 LOOP

START [frames:int]

Introduced in CasparCG Server 2.1. Currently only supported for video files, not audio files.

Sets the start of the file in milliseconds. This point will be used as the starting point while looping.

Example:

PLAY 1-1 MOVIE START 100 LOOP

LENGTH [frames:int]

Currently only supported for video files, not audio files.

Sets the end point (the last frame that will be played or the end loop point.)

Example:

PLAY 1-1 MOVIE LENGTH 100

FILTER [libavfilter-parameters:string]

Configures which libavfilter will be used.

Example:

PLAY 1-1 MOVIE FILTER hflip:yadif=0:0

A complete list of filters and a description of their purpose can be found here http://libav.org/libavfilter.html#Video-Filters

LOOP [loop:0|1]

Sets whether file will loop or not.

Returns the value of LOOP after the command has completed.

Examples:

CALL 1-1 LOOP 1

Enables the looping on 1-1.

CALL 1-1 LOOP

Queries the parameter value, without changing it.

SEEK [REL|IN|OUT|END] [frames:int]

Seeks in the file.

Currently only supported for video files, not audio files.

If two parameters are specified the first parameter sets the offset for relative seeks (introduced in CasparCG Server 2.1):

• REL = offset is the current playback position
• IN = offset from the start (0 or as specified using START)
• OUT = offset from start + length
• END = offset from end of file (duration)

The second parameter can be a positive or negative number.

Returns the frame the seek command skipped to.

Example:

CALL 1-1 SEEK 200

Example seeking to 500 frames before the end of the video (introduced in CasparCG Server 2.1):

CALL 1-1 SEEK END -500

START [frames:int]

Introduced in CasparCG Server 2.1. Currently only supported for video files, not audio files.

Sets the start of the file. This point will be used while looping.

Example:

CALL 1-1 START 100

LENGTH [frames:int]

Introduced in CasparCG Server 2.1. Currently only supported for video files, not audio files.

Sets the end of the file.

Example:

CALL 1-1 LENGTH 100

ffmpeg[filename | video-mode | file-frame-number / file-nb-frames]

All endpoints have a prefix of /channel/[0-9]/stage/layer/[0-9]/

All endpoints have a prefix of /channel/[0-9]/stage/layer/[0-9]/