HOME » MP4Client Configuration
This configuration file is deprecated in the new filters architecture of GPAC. Most of the documentation here is kept for historical purposes.
Configuration file syntax
The GPAC configuration file is ordered by sections and keys, storing key/value pairs.
A section is declared as SectionName.
A key is declared as keyName=value. The key value is not interpreted and always handled as ASCII text. It may contain spaces and other
Key names shall not contain
= characters and shall be on a single line.
It is possible to store a
keyvalon multiple lines using
@character at the begining of the key value.
[mysection] keyname=@some noce string on two and three lines !
The configuration file is created by default when using a GPAC application.
New Architecture Configuration
Other than the core section and filters sections, the following sections are still defined in the new achitecture:
The General section of the config file holds player and application specific options.
StartupFile [value: filename]
Specifies file to load upon startup of Osmo4/MP4Client. It is by default set to the GUI file when creating the configuration file.
ForceGUI [value: "yes", "no"]
Specifies if the gui shall be loaded when launching the player with an argument. This avoids specifying -gui when launching the player.
NoMIMETypeFetch [value: "yes", "no"]
Specifies if the player has to check for mime type when following hyperlinks, or only follow links of known extensions.
RTIRefreshPeriod [value: positive integer]
Specifies the rate in ms at which MP4Client refreshes run-time information (CPU, Mem, ;..) for display. The default value is 200 ms.
LastWorkingDir [value: path to directory]
Specifies location of last working directory. Used by GUI only.
iOSDocumentsDir [value: path to directory]
Specifies location of iOS document directory of the client. Used by GUI only.
DeviceType [value: "iOS", "Android", "Desktop"] Specifies the underlying OS type. Used by GUI only.
LastWidth [value: positive integer] Used by GUI to save/restore output window width.
LastHeight [value: positive integer] Used by GUI to save/restore output window height.
Old Architecture Configuration
Some applications in the GPAC framework use a configuration file shared among modules and reloadable at run time. Modules may use the configuration file as well (to avoid multiple config files). This doc attempts to provide explanations for the different options.
The config file is ordered by sections and keys.
A section is declared as SectionName. Defined sections are:
On Windows plateforms, this config file is called "GPAC.cfg" and is usually located in C:\\Program Files\\GPAC. Note that Osmo4 will always create a config file in its own directory when none is found.
On Windows CE plateform, this config file is called "GPAC.cfg" and is usually located in \\Program Files\\GPAC. Note that Osmo4 / CE will always create a config file in its own directory when none is found.
On GNU/Linux plateforms, this config file is called ".gpacrc" and is always located at the root of the user home directory (for ex, /home/jean/.gpacrc).
Note on module names: Module names as given in the config file are names exported by each interface and not name of the physical library file (.dll, .so, ...). The physical file name can however be used to identify a module - it will then be replaced by the module name.
The General section of the config file holds player specific options.
ModulesDirectory [value: path to directory]
Specifies the path to modules directory. The MPEG-4 Systems engine cannot be loaded without modules. This option is used by GPAC clients on all platforms.
CacheDirectory [value: path to storage directory]
Specifies location of temp files. The user must have write access to this location. Although not used by applications, this is used by several modules.
StartupFile [value: filename]
Specifies file to load upon startup of most clients (Osmo4/MP4Client). If not specified, no file is loaded.
LogFile [value: filename]
Specifies where to output GPAC's log. By default, the logs are written to stdout. Note that GPAC may be compiled without log support. This is not used by MP4Client.
Logs [value: tool[:tool]@level:tool[:tool]@level]
Specifies log level for each tool. By default, only errors are logged. Available levels are:
- quiet : no logging is performed on the tool
- error : only errors are logged
- warning : warnings are also logged.
- info : information messages are also logged
- debug : debug messages are also logged
Available tools are:
- core : libgpac core
- coding : bitstream formats (audio, video, scene)
- container : container formats (ISO File, MPEG-2 TS, AVI, ...)
- network : network data exept RTP trafic
- rtp : rtp, rtcp and rtsp trafic
- author : authoring tools (hint, import, export)
- sync : terminal sync layer
- codec : terminal codec messages
- parser : scene parsers (svg, xmt, bt) and other
- media : terminal media object management
- scene : scene graph and scene manager
- script : scripting engine messages
- interact : user interaction messages
- compose : composition engine (events, etc)
- cache : HTTP cache
- mmio : Audio/Video HW I/O management
- rti : Run-time info (CPU, mem, ...)
- smil : SMIL timing and animation
- memory : GPAC memory tracker
- audio : Audio renderer and mixers
- module : used by some modules
- mutex : mutex information
- console : console messages, such as script alert() and error notifications
Options defined for Osmo4 (Windows version and wxWidgets version):
Loop [value: "yes" "no"]
Specifies whether the presentation has to be restarted when done playing.
ConsoleOff [value: "yes" "no"]
Specifies whether application messages (script, buffering, download progress) are displayed in the console or not.
SingleInstance [value: "yes", "no"]
Specifies if the player should be a single instance application or not (Osmo4-Win32 only).
LookForSubtitles [value: "yes" "no"]
Specifies if Osmo4 shall look for subtitle files when opening a presentation.
ViewXMT [value: "yes" "no"]
Specifies if scene dumping shall be done in XML (XMT, X3D) or in VRML-like syntax (BT, WRL).
ConfigPanel [value: positive integer]
Specifies the latest config panel selected by user.
NoMIMETypeFetch [value: "yes", "no"]
Specifies if the player has to check for mime type when following hyperlinks, or only follow links of known extensions.
Loop [value: "yes", "no"]
Specifies if the playlist shall be restarted when playback is over.
PLEntry [value: positive integer]
Indicates active playlist entry when player was last closed. Playlist backup is:
- "gpac_pl.m3u" on win32 platforms, stored in same directory as application
- ".gpac_pl.m3u" on other platforms, stored in user home directory
FillScreen [value: "yes", "no"]
Specifies if the display area shall fill all available space on screen. WindowsMobile/Symbian only
DisableBackLight [value: "yes", "no"]
Specifies if the screen backlighting shall be disabled while playing. WindowsMobile/Symbian only
LastWorkingDir [value: "yes", "no"]
Specifies the directory of the last local file opened. Smartphone Windows only
Browser [value: string]
Specifies prefered browser for WWW anchors and scene graph viewing - Only used by Osmo4/wxWidgets.
The "RecentFiles" section of the config file holds last accessed files (hardcoded to no more than 20) in the last access order. The keys are the file names and no value is used. This section is only used by GUI clients (osmo4/wxOsmo4)
The "Systems" section of the config file holds all configuration options for the MPEG-4 Systems engine.
LanguageName [value: string]
Specifies the user prefered language in readable english. This is used to select streams in case of alternate content in an audio object.
Language3CC [value: 3-char code from ISO 639-2]
Specifies the user prefered language as expressed in ISO 639-2. This is used to select streams in case of alternate content in an audio object.
Language2CC [value: 2-char code from ISO 639-1]
Specifies the user prefered language as expressed in ISO 639-1. This is used to select streams in case of alternate content in an audio object.
DrawLateFrames [value: "yes" "no"]
If set, late frames will still be drawn. If not set, the late frames are droped (or executed for systems decoders) untill the decoder output is back in sync. This is by default on to keep better testing heavy content or slow renderers, but should be set to off when needing a better sync or monitoring skipped frames.
ForceSingleClock [value: "yes" "no"]
One big problem with MP4 files is that the notion of "duration" has been unclear for a long time, and most content available (audio-video files) specifiy a wrong BIFS duration. In such a case the movie cannot be controled/seeked into. Another problem with ISMA streaming is that BIFS/OD don't use the same clock as audio/video, thus seeking the main timeline does not seek AV media. Setting the ForceSingleClock will handle both cases by using a single timeline for all media streams and setting the duration to the one of the longest stream.
ThreadingPolicy [value: "Free" "Single" "Multi"]
Specifies how media decoders are to be threaded. "Free" lets decoders decide of their threading, "Single" means that all decoders are managed in a single thread performing scheduling and priority handling and "Multi" means that each decoder runs in its own thread.
Priority [value: "low" "normal" "high" "real-time"]
Specifies the priority of the decoders (priority is applied to decoder thread(s) regardless of threading mode).
TimeSlice [value: unsigned integer]
Specifies the target maximum time (in ms) of one cycle of the media manager (the media manager will attempts to call all the active decoders within this time. Depending on the threading mode this option can be ignored;
ModuleUnload [value: "yes" "no"]
Specifies whether modules should be unloaded if not used or not. Default: "yes".
ResyncLateClock [value: unsigned integer]
Specifies the threshold after which late clocks are resynchronized to timestamps for OCR streams. By default, no threashold (0) is used and clocks are never resynchronized. This allows to resync clocks to the media owning the clock when the decoding is really too slow, and should only be used for debugging purposes.
NoVisualThread [value: "yes" "no"]
Specifies whether the visual rendering is done in the main codec manager or in a dedicated thread.
DefAudioDec , DefVideoDec and DefImageDec [value: string]
Specifies which module to use by default for audio/video/image decoding. The string is the name of the module to be used (same considerations as other modules, cf introduction).
codec_XX_XX [value: string]
Allows to specify default media module (audio/video) per stream type and object type. This is usefull if you have more than one decoder for a given type (ex, XviD and FFMPEG for MPEG-4 visual SP). The syntax is: codec_AA_BB=modulename where AA is the hexadecimal MPEG-4 streamType value for the codec (04=visual, 05=audio) and BB is the hexadecimal MPEG-4 objectTypeIndication of the media (0x20 = MPEG-4 video, 0x40=MPEG-4 Audio, ...). The string is the name of the module to be used (same considerations as other modules, cf introduction).
The "Compositor" section of the config file holds all configuration options for the compositor (logical rendering engine).
Raster2D [value: string]
Specifies the 2D rasterizer to use for vectorial drawing. Same as above, this module cannot be reloaded during a presentation.
FrameRate [value: float]
Specifies the simulation frame-rate of the presentation - this value is also used by the MPEG-4 Systems engine to determine when a BIFS frame is mature for decoding.
AntiAlias [value: "None" "All" "Text"]
Specifies antialiasing settings - whether the setting is applied or not depends on the graphics module / graphic card.
- "None": no anti-aliasing
- "Text": anti-aliasing for text only
- "All": complete anti-aliasing
HighSpeed [value: "yes" "no"]
Specifies whether rendering should target speed or quality - whether the setting is applied or not depends on the renderer, graphics module / graphic card.
ForceSceneSize [value: "yes" "no"]
Forces the scene to resize to the biggest bitmap available if no size info is given in the BIFS configuration.
StressMode [value: "yes" "no"]
Specifies that the renderer runs in worst case scenario, recomputing display lists and reloading textures (sending them to graphics card) at each frame even when no change has occured.
BoundingVolume [value: "None" "Box" "AABB"]
Specifies whether the bounding volume of an object shall be drawn or not. Note that the 2D renderer only uses rectangles as bounding volumes. The "AABB" value is used by the 3D renderer only, and specifies the object bounding-box tree shall be drawn.
ColorKey [value: unsigned hexadecimal integer, formated as AARRGGBB]
Specifies the color key to use for windowless rendering. GPAC currently doesn't support true alpha blitting to desktop due to limitations in most windowing toolkit, it therefore uses color keying mechanism. The alpha part of the key is used for global transparency of GPAC's output, if supported.
BackColor [value: unsigned hexadecimal integer, formated as AARRGGBB]
Specifies the background color to use when displaying transparent images or video with no scene compoistion instructions.
DrawMode [value: "immediate" "defer" "defer-debug"]
Specifies whether immediate drawing should be used or not. In immediate mode, the screen is completely redrawn at each frame. In defer mode object positioning is tracked from frame to frame and dirty rectangles info is collected in order to redraw the minimal amount of the screen buffer. Whether the setting is applied or not depends on the graphics module (currently all modules handle both mode). Defer Debug mode only renders changed areas.
ScalableZoom [value: "yes" "no"]
Specifies whether scalable zoom should be used or not. When scalable zoom is enabled, resizing the output window will also recompute all vectorial objects. Otherwise only the final buffer is stretched.
DisableYUV [value: "yes" "no"]
Disables YUV hardware support (YUV hardware support may not be available for the current video output module).
TextureFromDecoderMemory [value: "yes" "no"]
Allows video textures to be build directly from video decoder internal buffers. This may increase performances on some systems. Default is no.
ForceOpenGL [value: "always", "disable", "hybrid", "raster"]
Specifies that 2D rendering will be performed by OpenGL rather than raster 2D. This will involve polygon tesselation which may not be supported on all platforms, and 2D graphics will not loo as nice as 2D mode. The hybrid mode performs software drawing of 2D graphics with no textures (better quality) and uses OpenGL for all textures. The raster mode only uses OpenGL for pixel IO but does not perform polygin fill (no tesselation) (slow, mainly for test purposes).
EnablePBO [value: "yes", "no"]
Uses PixelBufferObjects to push YUV textures to GPU in OpenGL Mode.. This may slightly increase the performances of the playback.
DefaultNavigationMode [value: "Walk", "Fly", "Examine"]
Overrides the default navigation mode of MPEG-4/VRML (Walk) and X3D (Examine).
RasterOutlines [value: "yes" "no"]
Specifies that outlining shall be done through OpenGL pen width rather than vectorial outlining.
PolygonAA [value: "yes" "no"]
Specifies whether polygon antialiasing should be used in full antialiasing mode. If not set, only lines and points antialiasing are used.
DisableBackFaceCulling [value: "yes" "no"]
Specifies whether backface culling shall be disable or not. If not set, backface culling is performed.
Wireframe [value: "WireNone" "WireOnly" "WireOnSolid"]
Specifies wireframe drawing options:
- "WireNone": objects are drawn as solid
- "WireOnly": objects are drawn as wireframe only
- "WireOnSolid": objects are drawn as solid and wireframe is then drawn
DisableRectExt [value: "yes" "no"]
Specifies whether OpenGL rectangular texture extension (GL_EXT_texture_rectangle or GL_NV_texture_rectangle) shall be used or not.
- "yes": textures whose dimensions are not power of two are rescaled except if hardware support non-power-of-two textures (GL_ARB_texture_non_power_of_two) natively.
- "no": if extension is available, textures are used without rescaling. Note that in this case texture transformations are disabled.
EmulatePOW2 [value: "yes" "no"]
Enables power of 2 emulation. Ignored if openGL rectangular texture extension is enabled.
- "yes": video texture is not resized but emulated with padding. This usually speeds up video mapping on shapes but disables texture transformations.
- "no": video is resized to a power of 2 texture when mapping to a shape.
DisableGLUScale [value: "yes" "no"]
Disables usage of gluScaleImage, which may be slower but nicer than GPAC's software stretch routines.
TextureTextMode (value: "Default", "Never", "Always"]
Specifies whether text shall be drawn to a texture and then rendered or directly rendered. Using textured text can improve text rendering in 3D and also improve text-on-video like content. Default value will use texturing for OpenGL rendering.
OpenGLExtensions [value: string]
Read-only option listing the OpenGL extensions supported by the GL driver. Only valid after the 3D renderer has been used.
StereoType [value: "None", "SideBySide", "StereoHeadset", "TopToBottom", "Anaglyph", "Columns", "Rows", "SPV19", "Custom"]
Specifies the stereo output type (default "None"). If your graphic card does not support OpenGL shaders, only SideBySide and TopToBottom modes will be available.
- "SideBySide": images are displayed side by side from left to right.
- "TopToBottom": images are displayed from top (laft view) to bottom (right view).
- "StereoHeadset": same as SideBySide except that view aspect ratio is not changed.
- "Anaglyph": Standard color anaglyph (red for left view, green and blue for right view) is used.
- "Columns": images are interleaved by columns, left view on even columns and left view on odd columns.
- "Rows": images are interleaved by columns, left view on even rows and left view on odd rows.
- "SPV19": images are interleaved by for SpatialView 19'' 5 views display, fullscreen mode.
- "Custom": images are interleaved according to the shader specified by InterleaverShader
NumViews [value: unsigned integer]
Specifies the number of views to use in stereo mode. If mode is "Anaglyph", "Columns" or "Rows", the number of views is forced to 2.
InterleaverShader [value: path to fragment shader file]
Specifies the fragment shader file to use for view interleaving. Each view is rendered in its own texture. The shader is exposed each view as uniform sampler2D gfViewX, where X is the view number starting from the left (gfView1).
ReverseViews [value: "yes", "no"]
Specifies if the view order should be reversed (from right to left) or not.
EyeSeparation [value: float]
Specifies the eye separation in cm (distance between the cameras). Default: 6.3 cm.
CameraLayout [value: "OffAxis", Linear", "Circular"]
Specifies the camera layout. The default value is OffAxis in (auto-)stereo modes, ignored in mono mode.
ViewDistance [value: integer]
Specifies the distance in cm between the camera and the zero-disparity plane. There is currently no automatic calibration of depth in GPAC.
Output8bit [value: "yes" "no"]
Specifies whether 10 bit textures should be converted to 8 bit before GPU upload or use as is. Default is no if screen supports 10 bpp, yes otherwise.
VRDefaultFOV [value: float]
Default field of view for VR 360. Default is PI/2.
TileVisibilityTest [value: int1-int2]
Sets the number of points to test for tile visibility to int1, and consider the tile visible if more than int2 points are visible. Default is 30-0.
SimulateGaze [value: yes,no]
Uses the mouse to simulate gazing direction on the display for quality adaptation. Default is no.
TileVisibilityDebug [value: yes,no]
Enables tiles visibility debugging. This disables the tile having full coverage of the SRD, only displaying sub tiles. Default is no.
TileVisibilityForced [value: yes,no]
Forces tiles visibility. All tiles will be considered as visible, regardless the current viewpoint. Default is no.
The "Audio" section of the config file holds all configuration options for the audio rendering engine and hardware.
DriverName [value: string]
Specifies the driver to use for audio rendering. This driver cannot be reloaded at run-time, the complete system must be restarted.
ForceConfig [value: "yes" "no"]
Forces a given sound card configuration to be used. If not set the sound card will be setup to use 2 audio buffers of 1024 samples each. This may not work properly on some audio cards due to hardware latency, therefore forcing the config may be very usefull.
NumBuffers [value: positive integer, 0 forbidden]
When config is forced, specifies the number of audio buffers to allocate (audio buffers are played in ring).
TotalDuration [value: positive integer, 0 forbidden]
When config is forced, specifies the total audio buffer size in milliseconds. Be aware that the longer the audio buffer is, the longer the audio latency will be when pausing an audio object. The quality of fast forward audio playback will also be degradated when using large audio buffers.
NoResync [value: "yes" "no"]
Disables audio resynchronization: audio data is never dropped but may get out of sync.
DisableMultiChannel [value: "yes" "no"]
Disables audio multichannel output and always downmix to stereo. This may be usefull if the multichannel output behaves weirdly.
DisableNotification [value: "yes" "no"]
Disables usage of audio buffer notifications when supported (currently only DirectSound supports it). If DirectSound audio sounds weird try without notifications.
Volume [value: integer (0-100)]
Default audio volume used when launching GPAC.
Pan [value: integer (0-100)]
Default audio stereo balance used when launching GPAC - 0 for full left, 100 for full right, 50 for balanced.
Filter [value: string]
Defines a set of audio filters. Audio filters are declared as a list of strings separated with ";;". The exact syntax of the string is filter specific.
ForceFrequency [value: integer]
Force audio output frequency. Set to 0 (default) for dynamic reconfiguration of all params (freq, ch, layout and bps).
ForceChannels [value: integer]
Force audio output channels. Set to 0 (default) for dynamic reconfiguration of all params (freq, ch, layout and bps).
ForceLayout [value: hexa integer]
Force audio output frequency. Set to 0 (default) for dynamic reconfiguration of all params (freq, ch, layout and bps).
ForceBPS [value: integer]
Force audio output bits per sample. Set to 0 (default) for dynamic reconfiguration of all params (freq, ch, layout and bps).
The "Video" section of the config file holds all configuration options for the video renderer and hardware.
DriverName [value: string]
Specifies the driver to use for video memory access. This driver cannot be reloaded at run-time, the complete system must be restarted.
SwitchResolution [value: "yes" "no"]
Specifies fullscreen resolution mode. If enabled, selects smallest video resolution larger than scene size, otherwise use current video resolution.
HardwareMemory [value: "Auto" "Always" "Never"]
Only valid for 2D renderer. Specifies if main video backbuffer is always on hardware, always on system memory or selected by GPAC (default mode). Depending on the scene type, this may drastically change the playback speed.
DisableColorKeying [value: "yes" "no"]
Only valid for 2D renderer. Specifies if partial overlays should be disabled. If not disabled, hardware color keying for overlays is tested and used if present. Otherwise, only the top-most video with no overlapping objects will be drawn using overlays. Default value is "no".
UseGLDoubleBuffering [value: "yes" "no"]
Specifies if OpenGL double buffering shall be used. Default is "no".
GLNbBitsPerComponent [value: positive integer]
Specifies the number of bits per color component. Default is 5.
GLNbBitsDepth [value: positive integer]
Specifies the number of bits for the depth buffer. Default is 16.
X113DOffscreenMode [value: "Window" "VisibleWindow" "Pixmap"]
Specifies the type of OpenGL offscreen rendering in X11. Default mode is "Pixmap".
- "Window": A hidden window is used to perform offscreen rendering. Depending on your video driver and X11 configuration, this may not work.
- "VisibleWindow": A visible window is used to perform offscreen rendering. This can be usefull while debugging.
- "Pixmap": An X11 Pixmap is used to perform offscreen rendering. Depending on your video driver and X11 configuration, this may not work and can even crash the player.
The "Network" section of the config file holds all configuration options for the network used by modules and systems engine.
AutoReconfigUDP [value: "yes" "no"]
Specifies if network manager shall reconnect a scene if UDP is not present.
DataTimeout [value: positive integer]
Specifies timeout in ms befor initial media buffering aborts. Default terminal value is 20000 (20 seconds).
UDPNotAvailable [value: "yes" "no"]
Specifies if UDP traffic is not available. This is automatically set by GPAC if AutoReconfigUDP is set.
UDPTimeout [value: positive integer]
Specifies timeout in ms for initial UDP detection. Once a UDP packet is recieved the timeout is ignored.
BufferLength [value: positive integer]
Specifies the length of the decoding buffer in milliseconds. The client will wait for the buffer to be filled before starting decoding. A module may decide to use a different value based on protocol and network jitters.
RebufferLength [value: positive integer]
Specifies rebuffering length of the decoding buffer in milliseconds. Whenever the decoding buffer fullness is less than this value, the object clock is paused and the stream rebuffered till BufferLength. Therefore a value of 0 means no rebuffering. A module may decide to use a different value based on protocol and network jitters.
BufferMaxOccupancy [value: positive integer]
Specifies maximum buffer occupancy for buffer regulation. Corresponds to the max amount of data to be prefetch. Any value less than BufferLength will be forced to BufferLength.
LowLatencyBufferMax [value: positive integer]
Specifies the maximum buffer level for low latency mode, in ms. If media buffer max is above this value, full buffering will be done (clock resume at first frame displayed). Default value is 500 ms.
MobileIP [value: IP Address]
Specifies a Mobile IP interface overriding the default IP. If set, all sockets will be locally bound to this IP address.
DefaultMCastInterface [value: IP Address]
Specifies a default IP interface for Multicast overriding the default IP.If not set, the multicast will be setup using the default IP.
HTTPRebuffer [value: positive integer]
Specifies the default HTTP rebuffer time in ms. When playback position reaches download position, playback will be paused if this integer is not zero. Playback will resume once the HTTPRebuffer ms of playback are available. Default value is 5000 ms.
HTTPAutoRebuffer [value: "yes", "no"]
Specifies whether auto rebuffering is used. When auto-rebuffering is used, playback only resumes when estimated time to download the rest of the movie is less than remaining time of the playback. Default value is no.
The "FontEngine" section of the config file holds all configuration options for the font handling. The GPAC rendering module handles text through vectorial outline, allowing graphics module development without having to integrate text rendering which is always heavy work.
FontReader [value: string]
Specifies the module to use for font handling. This module cannot be reloaded at run-time, GPAC must be restarted.
WaitForFontLoad [value: "yes" "no"]
Forces to wait for SVG fonts to be loaded before displaying frames - default is "no".
FontDirectory (value: path to TrueType (*.ttf, *.ttc) font directory]
Specifies the directory where fonts are located - currently only one directory can be specified (however nothing stops a font module from using a private directory). Note: The freetype module will scan the entire sub-directories for fonts.
FontSerif [value: string]}: specifies default SERIF font. FontSans [value: string]}: specifies default SANS font. FontFixed [value: string]}: specifies default fixed font.
Note: The FreeType module uses this section to cache familly names to font file name associations.
The "Downloader" section of the config file holds all configuration options for file downloading and caching.
CleanCache [value: "yes" "no"]
Specifies whether downloaded files shall be removed once used.
DisableCache [value: "yes" "no"]
Specifies whether HTTP caching instructions are disabled or not.
AllowOfflineCache [value: "yes" "no"]
When enabled, allows HTTP request to use cached file if any when network is not available.
MaxRate [value: positive integer]
Specifies a maximum data rate in kilo bits per seconds for file downloading. This is used for simulation purposes. A value of 0 means no rate restriction.
UserAgent [value: string]
Specifies an alternate user agent (default one is "GPAC $VERSION").
HTTPHeadTimeout [value: positive integer]
Specifies timeout in milliseconds before considering HEAD request failed. 0 means no HEAD request is issued, only GET.
AllowBrokenCertificate [value: yes no]
If set to yes, ignores invalid certificates and process anyway. Default is no.
The "HTTPProxy" section of the config file holds configuration option for HTTP proxy adressing. Currently only one proxy can be enabled, and no URI selection is done.
Enabled [value: "yes" "no"]
Specifies whether the proxy should be used or not when downloading files.
Name [value: string]
Specifies the proxy name (IP address or resolved name) without protocol identifier (eg, no "http://"). If not present, the proxy is disabled.
Port [value: positive integer]
Specifies the port to use with the proxy. If no port is specified, the default HTTP port (80) is used.
The "Streaming" section of the config file holds all configuration options for real-time streaming using IETF SDP/RTSP/RTP/RTCP protocols.
DefaultPort [value: unsigned short]
Specifies the default port to use when connecting to a server (ignored if a port is specified in the url) if the port is 80 or 8080 (HTTP), the client will connect to the RTSP server through an HTTP tunnel, and transport will take place on the RTSP connection.
ReorderSize [value: positive integer]
Size of the RTP reordering buffer - 0 means no reordering. Ignored when transport takes place on the RTSP connection. The bigger this value, the longer the reordering delay will be.
RTPoverRTSP [value: "yes" "no" "OnlyCritical"]
Specifies whether RTP packets should be carried on the RTSP connection (TCP or UDP), or carried on UDP. If the connection port is an HTTP port, this value is assumed to be true. If set to OnlyCritical, transport will take place on TCP only if a critical media (eg, neither audio nor video) is found in the session.
RTSPTimeout [value: positive integer]
Specifies connection timeout with the server: an RTSP request is considered as failed when the timeout expires.
ForceFirstPort [value: positive integer]
Specifies first port for RTP channels. If not set, the default first port used by GPAC is 7040.
NATKeepAlive [value: positive integer]
Specifies the maximum inactivity period in milliseconds for RTP sockets. If no data is received after this period, an empty RTP packet will be sent in order to keep any NAT alive. If 0 (default), disables NAT keep-alive packets.
ForceMulticastIP [value: IP4 or IP6 address]
Forces the specified multicast address to be used instead of the regular unicast. Note that some servers may not support multicast initiation by the client.
ForceMulticastTTL [value: Positive integer]
Indicates the TTL to use when the client initiates the multicast. Default value is 127.
FirstPacketDrop [value: positive integer]
Specifies the sequence number of the first RTP packet to be droped - 0 means no packet drop. Used for packet drop simulation tests.
PacketDropFrequency [value: positive integer]
Specifies the frequency at which SL packets are droped. If value is 20, one packet every 20 recieved packets will be droped. Used for packet drop simulation tests.
This section is used to keep MIME types and file associations for GPAC modules. The format of the key is: mimeType="fileExt1 filexExt2 .. filexExtN" "MimeType description" ModuleName The description is used for GUI purposes (open file dialogs). You may modify the file extension list to support your own extensions. MIME Type is always checked when processing a remote ressource (eg http file) in order to load the appropriated modules. If MIME type is not available, provided extensions are first checked, then all input modules are queried.
The "StreamingCache" section of the config file holds all configuration options for the streaming cache. Streaming cache allows for recording of live sources such as RTP/RTSP sessions and internet radios. This is currently just an experimental feature in GPAC.
RecordDirectory [value: path]
Specifies path for recorded files. Cached data is written directly to disk (no re-interleaving or similar processes). If not specified, the default cache directory (cf General) is used.
BaseFileName [value: string]
Specifies the base name for recorded files. If not present in configuration file, the service name (URL) is used.
KeepExistingFiles [value: "yes" "no"]
Specifies if cached files with same name should be kept or not. If not, an integer number is added to the cached file name, the higest number for the latest file.
The "SAXLoader" section of the config file holds all configuration options for XML SAX parsing of SVG, XMT and X3D files.
Progressive [value: "yes" "no" "DOM"]
Specifies XML parsing mode used by different file loaders using the SAX parser.
- "yes": SAX parsing is used with progressive loading of the document.
- "no": SAX parsing is used, document will first be completely downloaded.
- "DOM": DOM parsing is used, document will first be completely downloaded. Only supported by libXML2 plugin, otherwise handled as "no".
MaxDuration [value positive integer]
Specifies the maximum amount of time the SAX parser should spent loading a portion of the document. Only used with SAX Progressive mode
The "XviD" section of the config file holds all configuration options for the XviD codec.
PostProc [value: "FilmEffect" "Deblock_Y" "Deblock_UV"]
Specifies filters to apply when decoding video. The string is a list of filters separated with a space character.
- "FilmEffect": xvid 1.0.0 filmEffect.
- "Deblock_Y": Y plane deblocking filter.
- "Deblock_UV": UV plane deblocking filter.
Threaded [value "yes" "no"]
Specifies whether the decoder should run in its own thread or not.
The "FFMPEG" section of the config file holds all configuration options for the FFMPEG demuxer and decoder.
DataBufferMS [value: positive integer]
Specifies the amount of video/audio data (in milliseconds) to be bufferer before starting decoding. For developpers only.
IOBufferSize [value: positive integer]
Specifies the size (in bytes) of the buffer used to fecth data from network (http playback only). Default size is 8192 bytes.
The "ISOReader" section of the config file holds all configuration options for the ISO Media File demuxer.
IgnoreMPEG-4ForBrands [value: Full 4CC or 4CC pattern (abc* ab*)]
Ignores all MPEG-4 systems tracks and IOD for files showing the listed brands in their compatible brand list.
The "DVB" section of the config file holds all configuration options for DVB playback on GNU/Linux systems.
ChannelsFile [value: Absolute file path]
Specifies the DVB channels configuration file as produced by dvbtools' scan util.
The "DASH" section of the config file holds all configuration options for DASH or HLS/M3U8 playback.
KeepFiles [value: yes, no]
Specifies whether downloaded files should not be deleted.
AutoSwitchCount [value: positive integer]
For debug purposes, instructs the player to switch representation every N segments. If 0 (default), switching is disabled.
BufferingMode [value: segments, minBuffer, none]
Selects buffer mode:
- segments: buffers complete segments as indicated in MPD before handing them to the player.
- minBuffer: asks the player to buffer media for the time indicated in the MPD, but segments are not pre-buffered. Default mode.
- none: uses the player settings for buffering.
NetworkAdaptation [value: disabled, bandwidth, buffer]
Sets automatic adaptation logic mode:
- disabled: no adaptation to network condition is used.
- bandwidth: network adaptation is based only on available download rate.
- buffer: network adaptation is based on available download rate for quality increase and buffer levels for quality drops. Default mode.
MemoryStorage [value: yes, no]
Files are only stored in memory and destroyed after playback, no disk IO is used. Default is yes
UseMaxResolution [value: yes, no]
Forces the player to set the output video resolution to the max resolution available instead of resizing the window. Default is yes
UseScreenResolution [value: yes, no]
Disables all resolutions that are higher than the screen resolution. Default is yes
StartRepresentation [value: minBandwidth, maxBandwidth, maxBandwidthTiles, minQuality, maxQuality]
Instructs the DASH client to start playing the indicated representation before doing any switching. Default is minBandwidth. maxBandwidthTiles selects the highest bandwidth for tiles with high priority and lowest for other tiles, whereas maxBandwidth selects the highest bandwidth for tiles with high priority and closest lower bandwidth for other tiles.
InitialTimeshift [value: positive integer ]
If between 0 and 100, indicates the percentage of the timeshift buffer when starting playback. If more than 100, indicates the number of milliseconds to rewind in the timeshift buffer when starting playback. Default is 0 to tune to the live point.
LowLatency [value: always, chunk, no]
Sets low-latency mode enabled. In low-latency mode, media data is parsed as soon as possible while segment is being downloaded. Default is no. If chunk is selected, media data is re-parsed at each HTTP 1.1 chunk end. If always is selected, media data is re-parsed as soon as HTTP data is received.
AllowAbort [value: yes, no]
Enables aborts of HTTP transfer when rate gets too low. This imply data loss and may also result in a connection loss. Default is no.
UseServerUTC [value: yes, no]
Enables using Server-UTC HTTP header to compensate any drift between client and server. Default is yes.
DebugAdaptationSet [value: integer]
Plays only the adaptation set indicated by its index in the MPD. If index is negative, all sets are used (default mode).
TimeBetween404 [value: unsigned integer]
Sets how many millisconds to wait between two 404 on the same segment. Default is 500.
SegmentExpirationThreshold [value: unsigned integer]
Sets how many millisconds to wait after the segment AvailabilityEndDate before considering the segment lost. Default is 100.
ThreadedDownload [value: yes no]
Enables threade download of media segments. When low latency mode is used, this option is forced to yes. Default is no.
SpeedAdaptation [value: yes no]
Enables adaptation based on playback speed. Default is no.
SwitchProbeCount [value: unsigned integer]
Sets how many segments the client shall wait before switching up bandwidth. If 0, switch will happen as soon as the bandwidth is enough, but this is more prone to network variations. Default value is 1.
AgressiveSwitching [value: yes no]
If yes, switching targets to the closest bandwidth fitting the available download rate. If no, switching targets the lowest bitrate representation that is above the currently played (eg does not try to switch to max bandwidth). Default value is no.
TileAdaptation [value: none, rows, reverseRows, middleRows, columns, reverseColumns, middleColumns, center]
Selects how bitrate is shared across tiles of a video:
- none: bitrate is shared equaly accross all tiles (default).
- rows: bitrate decreases for each row of tiles starting from the top, same rate for each tile on the row.
- reverseRows: bitrate decreases for each row of tiles starting from the bottom, same rate for each tile on the row.
- middleRows: bitrate decreased for top and bottom rows only, same rate for each tile on the row.
- columns: bitrate decreases for each columns of tiles starting from the left, same rate for each tile on the columns.
- reverseColumns: bitrate decreases for each columns of tiles starting from the right, same rate for each tile on the columns.
- middleColumns: bitrate decreased for left and right columns only, same rate for each tile on the columns.
- center: bitrate decreased for all tiles on the edge of the picture.
- edges: bitrate decreased for all tiles on the center of the picture.
TileRateDecrease [value: percentage]
Indicates the amount of bandwidth to use at each quality level. The rate is recursively applied at each level, e.g. if 50%, Level1 gets 50%, level2 gets 25%, ... If 100, automatic rate allocation will be done by maximizing the quality in order of priority. If 0, bitstream will not be smoothed across tiles/qualities, and concurrency may happen between different media. Default is 100.
UTCShiftATSC [value: unsigned integer]
Indicates the amount of ms to delay requests for ATSC broadcast. Default value is 1000.
The "ALSA" section of the config file holds all configuration options of the ALSA audio output module on GNU/Linux systems.
DeviceName [value: string]
Specifies the ALSA device to use. Default device is "hw:0,0".
The "StreamingText" section of the config file holds all configuration options for the 3GPP/MPEG-4 Streaming Text decoder.
UseTexturing [value: "yes" "no"]
Specifies whether the text shall be drawn using an intermediate texture or not.<OutlineText [value: "yes" "no"]
Specifies whether the text shall be drawn with a black thin outline or not.
The "Shortcuts" section of the config file holds all shortcuts in GPAC. You can define a shorcut for an action as: 'action'='keyname' or 'action'='ctrl+keyname' or 'action'='alt+keyname' or "='action'='ctrl+alt+keyname' Shift is not supported as a key modifier, and case is insensitive. Currently defined actions are as follows:
Play or Pause Stop Step Exit Mute VolumeUp VolumeDown JumpForward JumpBackward JumpStart JumpEnd FastForward FineForward SlowForward FastRewind FineRewind SlowRewind Next Previous
The "DSMCC" section of the config file holds the configuration option for the processing of DSMCC data.
Activated [value: "true" "false"]
Specifies if the DSMCC data will be processed (true). It implies creations of directories and files in the temp directory.
The openHEVC section of the config file holds the configuration option for the OpenHEVC decoder.
NumThreads [value: unsigned integer]
Specifies the number of threads to allocate to the OpenHEVC decoder. Default is the number of detected cores minus one, or one if core detection fails.
ThreadingType [value: frame , wpp , frame+wpp ]
Specifies the threading type for the openHEVC decoder. Default is frame (wpp disabled).
CBUnits [value: unsigned integer ]
Specifies the number of decoded frames in memory before display. Default value is 4.
PackHFR [value: yes, no ]
Packs 4 consecutive frames in a single 4x frame.
ResetAtReinit [value: yes, no ]
Destroys and recreates the decoder whenever a layer is restarted (base or enhancement). Default is no, but openHevc may need this depending on version/branch/platform.
The "DirectFB" section of the config file holds the configuration options for the DirectFB output module. You may also want to check the official documentation.
DisableAcceleration [value: "yes" "no"]
Forces to disable hardware acceleration.
DisableDisplay [value: "yes" "no"]
Specifies the DisableDisplay parameter value.
FlipSyncMode [value: "waitsync" "wait" "sync" "swap"]
Specifies the flip sync mode.
DisableBlit [value: "yes" "no"]
Forces to disable hardware blitting.
WindowMode [value: "X11" "SDL"]
Specifies the underlying windowing library.
The "DektecVideo" section of the config file holds the configuration options for the Dektec SDI video output module.
CardSlot [value: int:int]
Specifies the bus bus number (first int) and slot id (second int) of the card. If not present, the module will look for DTA-2174 and DTA-2154.
SDIOutput [value: unsigned integer]
Specifies the output port of the card. Default value is 1.
FrameRate [value: float]
Specifies the output frame rate for the card. If not present (default), the compositor output frame rate will be used.
ClipSDI [value: yes, no]
Indicates if YUV data shall be clipped to valid SDI range or left untouched. Default is yes.
The "M2TS" section of the config file holds configuration options for MPEG-2 TS demultiplexer module.
ForceTEMILocation [value: URL string]
Overrides the URL in TEMI location descriptor with the specified value.
RecordTo [value: file path]
Records the TS content to the specified file.
UDPBufferSize [value: unsigned integer]
UDP buffer size for the socket. Default value is a few hundred kilobytes depending on the platform.
The "RAWVideo" section of the config file holds configuration options for Raw video and audio output module.
RawOutput [value: "null" or any string]
If set to null string, the raw output does nothing (no bliting calls, no backbuffer) - used for bench mode only.
PixelFormat [value: 555, 565, rgb, bgr, rgb32, bgr32, rgba, argb]
Sets the output video format of the raw module, mostly used for testing. The default format is rgb.
The "NVDec" section of the config file holds configuration options for NVidia hardware decoding module.
NumSurfaces [value: integer]
Sets the number of decoded surface for the decoder. Default is 20.
DisableGL [value: yes, no]
Disables hardware decoder to opengl transfer on GPU (and forces GPU->CPU->GPU memory). Default is no.
UnloadInactive [value: no, destroy, reuse]
Enables unloading inactive decoders to free GPU resources (usefull for tiling VR). no disables unloading, destroy kills the decoder, reuse reassigns the HW decoder to another object (still buggy). Default is no.
PreferMode [value: cuvid, dxva, cuda]
Sets prefered mode for harware decoder. cuda should only be used for MPEG-1 and MPEG-2 video. Default is cuvid.