NAME

       MP4Client - GPAC command-line media player

SYNOPSIS

       MP4Client [options] [file]

DESCRIPTION

       MP4Client  is  GPAC  command-line media player. It supports all GPAC playback features (2D
       and 3D support, local playback, RTP streaming, HTTP faststart, many audio and video codecs
       ...).
       Specific URLs shortcuts are available, see gpac -h compositor

OPTIONS

       -mem-track
              enable memory tracker

       -mem-track-stack
              enable memory tracker with stack dumping

       -rti (string)
              log run-time info (FPS, CPU, Mem usage) to given file

       -rtix (string)
              same as -rti but driven by GPAC logs

       -size (string)
              specify visual size WxH. If not set, scene size or video size is used

       -rti-refresh (int)
              set refresh time in ms between two runt-time counters queries (default is 200)

       -no-thread
              disable thread usage (except for depending on driver audio)

       -no-audio
              disable audio

       -pause
              pause at first frame

       -play-from (number)
              start playback from given time in seconds in media

       -speed (number)
              start playback wit given speed

       -loop
              loop playback

       -fs
              start in fullscreen mode

       -exit
              exit when presentation is over

       -run-for
              run for indicated time in seconds and exits

       -service (int)
              auto-tune to given service ID in a multiplex

       -no-save
              do not save configuration file on exit

       -no-addon
              disable automatic loading of media addons declared in source URL

       -gui
              start   in   GUI   mode.   The   GUI   is   indicated  in  the  configuration  file
              [General]StartupFile

       -p (string)
              use indicated profile for the global GPAC config. If  not  found,  config  file  is
              created.  If  a  file  path  is  indicated,  this will load profile from that file.
              Otherwise, this will create a directory of the specified name and store new  config
              there. Reserved name 0 means a new profile, not stored to disk. Works using -p=NAME
              or -p NAME

       -stats
              dump filter session stats after playback

       -graph
              dump filter session graph after playback

       -nk
              disable keyboard interaction

       -h,-help
              show this help. Use -hx to show expert help

       -hc
              show libgpac core options

       -hr
              show runtime options when keybard interaction is enabled

MP4Client runtime commands

   Prompt Interaction
       The following keys are used for prompt interaction:
       q: quit
       X: kill
       r: reload current presentation
       o: connect to the specified URL
       O: connect to the specified playlist
       N: switch to the next URL in the playlist. Also works with
       P: jump to a given number ahead in the playlist
       D: disconnect the current presentation
       G: select object or service ID
       p: play/pause the presentation
       s: step one frame ahead
       z: seek into presentation by percentage
       T: seek into presentation by time
       t: print current timing
       u: send a command (BIFS or LASeR) to the main scene
       e: evaluate JavaScript code in the main scene
       Z: dump current output frame to PNG
       w: view world info
       v: view list of active media objects in scene
       i: view Object Descriptor info (by ID)
       j: view Object Descriptor info (by number)
       b: view media objects timing and buffering info
       m: view media objects buffering and memory info
       d: dump scene graph
       k: turn stress mode on/off
       n: change navigation mode
       x: reset to last active viewpoint
       3: switch OpenGL on or off for 2D scenes
       4: force 4/3 Aspect Ratio
       5: force 16/9 Aspect Ratio
       6: force no Aspect Ratio (always fill screen)
       7: force original Aspect Ratio (default)
       H: set HTTP max download rate
       E: force reload of compositor options
       L: change to new log tool/level. CF MP4Client usage for possible values
       R: toggle run-time info display in window title bar on/off
       F: toggle displaying of FPS in stderr on/off
       f: print filter session stats
       g: print filter session graph
       h: print this message
       M: specify video cache memory for 2D objects ! experimental !

   Content interaction
       It is possible to interact with content (interactive or not) using mouse and keyboard.
       The following commands are available:
       TODO

EXAMPLES

       Basic and advanced examples are available at https://wiki.gpac.io/mp4client

MORE

       Authors: GPAC developers, see git repo history (-log)
       For  bug  reports,  feature  requests,   more   information   and   source   code,   visit
       https://github.com/gpac/gpac
       build: 1.1.0-DEV-rev1777-gb91a8dad3-master
       Copyright: (c) 2000-2022 Telecom Paris distributed under LGPL v2.1+ - http://gpac.io

SEE ALSO

       gpac(1), MP4Box(1)