MP4Client(1)

📦 version 2.0.0, in ubuntu jammy

✨ MP4Client — the manual, but make it cute ✨

okay bestie, welcome to the MP4Client(1) page from the GPAC manual 💖 this is the command-line media player and she is that girl. Let's get into it.

💫 NAME 💫

MP4Client — the GPAC command-line media player. yep that's the whole vibe. 🎬

🌈 SYNOPSIS 🌈

MP4Client [options] [file]

🦋 DESCRIPTION 🦋

MP4Client is the GPAC command-line media player, and no cap, she does it all. She supports every single GPAC playback feature — that's 2D and 3D support, local playback, RTP streaming, HTTP faststart, and so many audio and video codecs, the list is genuinely giving infinity 💅.

There are also specific URL shortcuts available, so if you want those, go check gpac -h compositor 👑

✨ OPTIONS ✨

  • -mem-track — turns on the memory tracker. we're watching the memory, bestie 👀
  • -mem-track-stack — same energy as memory tracking, but with stack dumping too 📚
  • -rti (string) — logs run-time info (FPS, CPU, Mem usage) into the file you name
  • -rtix (string) — literally the same as -rti, except it's driven by GPAC logs
  • -size (string) — set the visual size as WxH. if you don't set it, the scene size or video size gets used instead 🎀
  • -rti-refresh (int) — sets the refresh time in ms between two run-time counter queries (default is 200) ⏱️
  • -no-thread — disables thread usage (except for the ones depending on the driver audio, those stay)
  • -no-audio — disables audio. silent mode activated 🤫
  • -pause — pauses at the very first frame. dramatic entrance, frozen
  • -play-from (number) — starts playback from the given time in seconds in the media ⏩
  • -speed (number) — starts playback with the given speed
  • -loop — loops playback. again and again and again 🔁
  • -fs — starts in fullscreen mode. main character energy, full screen 🖥️
  • -exit — exits when the presentation is over
  • -run-for — runs for the indicated time in seconds, then exits
  • -service (int) — auto-tunes to the given service ID in a multiplex
  • -no-save — does not save the configuration file on exit
  • -no-addon — disables automatic loading of media addons declared in the source URL
  • -gui — starts in GUI mode. the GUI is indicated in the configuration file under [General]StartupFile 🪟
  • -p (string) — uses the indicated profile for the global GPAC config. if it's not found, the config file gets created. if you pass a file path, it loads the profile from that file. otherwise it creates a directory with the specified name and stores the new config in there. the reserved name 0 means a new profile that is not stored to disk. works using -p=NAME or -p NAME 💾
  • -stats — dumps filter session stats after playback 📊
  • -graph — dumps filter session graph after playback
  • -nk — disables keyboard interaction
  • -h,-help — shows this help. use -hx to show expert help 🆘
  • -hc — shows libgpac core options
  • -hr — shows runtime options when keyboard interaction is enabled

🎀 MP4Client runtime commands 🎀

💖 Prompt Interaction 💖

these keys are what you use for prompt interaction, bestie — memorize them, they're iconic:

  • 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 🌸

so it's possible to interact with content (interactive or not) using the mouse and the keyboard 🖱️⌨️

these are the commands available:

  • TODO

(yeah. that's literally what it says. the manual said TODO and left 💀)

🫶 EXAMPLES 🫶

basic and advanced examples are all waiting for you over at

https://wiki.gpac.io/mp4client

👑 MORE 👑

  • Authors: GPAC developers, see git repo history (-log)
  • for bug reports, feature requests, more info and source code, come 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)

and that's a wrap, bestie 💅 this page is from the GPAC manual, MP4Client(1), dated 2019, and it ate. slay, go play some media 🎬✨💖

📦 where this page comes from