Skip to content

MP4Client Intro

jeanlf edited this page Jan 10, 2020 · 8 revisions

HOME » MP4Client Introduction


GPAC provides a highly configurable multimedia player called MP4Client or Osmo4 (name unification is pending ...).

This player is much more than a traditional audiovisual player because, in addition to its capabilities to play most video or audio formats and its support for most of the existing delivery protocols, it focuses on graphics, animations and interactivity technologies.

The player can playback audiovisual content mixed with 2D or 3D content in the following formats: MPEG-4 BIFS and LASeR, W3C SVG, W3D VRML and X3D. The player also supports 360 video (EQR projection only for now), and QTVR images (Cube Maps).

The core of the player uses:

  • all input, demuxing and decoding filters defined in GPAC
  • the Compositor filter for media composition and interactivity, acting as a video sink
  • the aout filter for audio output

The GPAC player is supported on all GPAC supported plateforms (Windows, Linux OSX, iOS and Android), and can easily be ported on any platforms providing GCC toolchain and SDL (1.2 or 2.0).

The command-line documentation is availbable here.

When no URL is given, the player will load the file indicated in the StartupFile key of the General section of the configuration. With a default install and configuration, this loads a GUI (written in JavaScript and BIFS !).

When a URL is given, the player will directly load the URL without any GUI. If you want to enable the GUI, add -gui to your command line.

Checking playback capabilities

For the purpose of evaluating if the compilation and installation steps went well, the GPAC framework provides a test content in the form of an MPEG-4 file containing an MPEG-4 BIFS stream testing JavaScript, text rendering, 2D vector graphics and OpenGL playback, image display (PNG stream), video playback( MPEG-4 video Part 2 stream) and audio playback (AAC stream).

This file is called gpac_cfg_test.mp4 and is located in the share install directory of GPAC (/usr/share/gpac/, \Program Files\GPAC\share) and

If the installation step went well, you should see this result and hear the audio:

Otherwise you should see at least one of the following lines:

Configuring the player

Currently there is no graphical interface for configuring the player (old GUI apps have been deprecated).

You will need to modify the GPAC configuration file for persistent modifications, or pass the appropriated options and filter arguments (see core_config)

Clone this wiki locally
You can’t perform that action at this time.