ffavin

Warning

GPAC's wiki has moved to wiki.gpac.io.

This github wiki will no longer be updated.

You can contribute to GPAC's documentation here.

FFMPEG AV Capture

Register name used to load filter: ffavin
This filter may be automatically loaded during graph resolution.

Reads from audio/video capture devices using FFMPEG.
See FFMPEG documentation (https://ffmpeg.org/documentation.html) for more details.
To list all supported grabbers for your GPAC build, use gpac -h ffavin:*.

Device identification

Typical classes are dshow on windows, avfoundation on OSX, video4linux2 or x11grab on linux

Typical device name can be the webcam name:

• FaceTime HD Camera on OSX, device name on windows, /dev/video0 on linux
• screen-capture-recorder, see http://screencapturer.sf.net/ on windows
• Capture screen 0 on OSX (0=first screen), or screenN for short
• X display name (e.g. :0.0) on linux

The general mapping from ffmpeg command line is:

• ffmpeg -f maps to fmt option
• ffmpeg -i maps to dev option

Example

ffmpeg -f libndi_newtek -i MY_NDI_TEST ...  
gpac -i av://:fmt=libndi_newtek:dev=MY_NDI_TEST ...

You may need to escape the dev option if the format uses ':' as separator, as is the case for AVFoundation:
Example

gpac -i av://::dev=0:1 ...

Options

src (str): url of device, video://, audio:// or av://
fmt (str): name of device class. If not set, defaults to first device class
dev (str, default: 0): name of device or index of device
copy (enum, default: A): set copy mode of raw frames

• N: frames are only forwarded (shared memory, no copy)
• A: audio frames are copied, video frames are forwarded
• V: video frames are copied, audio frames are forwarded
• AV: all frames are copied

sclock (bool, default: false): use system clock (us) instead of device timestamp (for buggy devices)
probes (uint, default: 10, minmax: 0-100): probe a given number of video frames before emitting (this usually helps with bad timing of the first frames)
* (str): any possible options defined for AVInputFormat and AVFormatContext (see gpac -hx ffavin and gpac -hx ffavin:*)