Skip to content


GPAC Log System

libgpac logs options:

-noprog: disable progress messages
-quiet: disable all messages, including errors
-log-file,-lf (string): set output log file
-log-clock,-lc: log time in micro sec since start time of GPAC before each log line except for app tool
-log-utc,-lu: log UTC time in ms before each log line except for app tool
-logs (string): set log tools and levels.

You can independently log different tools involved in a session.
log_args is formatted as a colon (':') separated list of toolX[:toolZ]@levelX
levelX can be one of:

  • quiet: skip logs
  • error: logs only error messages
  • warning: logs error+warning messages
  • info: logs error+warning+info messages
  • debug: logs all messages

toolX can be one of:

  • core: libgpac core
  • mutex: log all mutex calls
  • mem: GPAC memory tracker
  • module: GPAC modules (av out, font engine, 2D rasterizer)
  • filter: filter session debugging
  • sched: filter session scheduler debugging
  • codec: codec messages (used by encoder and decoder filters)
  • coding: bitstream formats (audio, video, scene)
  • container: container formats (ISO File, MPEG-2 TS, AVI, ...) and multiplexer/demultiplexer filters
  • network: TCP/UDP sockets and TLS
  • http: HTTP traffic
  • cache: HTTP cache subsystem
  • rtp: RTP traffic
  • dash: HTTP streaming logs
  • route: ROUTE (ATSC3) debugging
  • media: messages from generic filters and reframer/rewriter filters
  • parser: textual parsers (svg, xmt, bt, ...)
  • mmio: I/O management (AV devices, file, pipes, OpenGL)
  • audio: audio renderer/mixer/output
  • script: script engine except console log
  • console: script console log
  • scene: scene graph and scene manager
  • compose: composition engine (2D, 3D, etc)
  • ctime: media and SMIL timing info from composition engine
  • interact: interaction messages (UI events and triggered DOM events and VRML route)
  • rti: run-time stats of compositor
  • all: all tools logged - other tools can be specified afterwards.

The special keyword ncl can be set to disable color logs.
The special keyword strict can be set to exit at first error.



This moves all log to info level, dash to debug level and disable color logs

-proglf: use new line at each progress messages
-log-dual,-ld: output to both file and stderr