--- name: "gmerlin-play" section: "1" platform: "linux" package: "gmerlin" version: "2.0.0~svn6298~dfsg0-5" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/gmerlin-play" --- # gmerlin-play(1) Gmerlin commandline player ## NAME gmerlin\_play - Gmerlin commandline player ## SYNOPSIS **gmerlin\_play** *\[options\]* *gml...* ## DESCRIPTION Commandline mediaplayer ## OPTIONS **-ip** *plugin?opt1=val&opt2=val ..* Use a specific input plugin with options for opening media sources.Use -list-input to list available plugins and -list-plugin-parameters \ to list all supported options - **-aud** *param1=val1\[¶m2=val2...\]* Set audio processing options **q**=\ (1..5, default: 2) Conversion Quality Set the conversion quality for format conversions. Lower quality means more speed. Values above 3 enable slow high quality calculations. **dm**=\ Supported strings: auto none rect tri shaped Default: auto Dither mode Dither mode. Auto means to use the quality level. Subsequent options are ordered by increasing quality (i.e. decreasing speed). **sm**=\ Supported strings: auto zoh linear sinc\_fast sinc\_medium sinc\_best Default: auto Resample mode Resample mode. Auto means to use the quality level. Subsequent options are ordered by increasing quality (i.e. decreasing speed). **fixed\_channel\_setup**=\[1\|0\] (default: 0) Fixed channel setup If disabled, the output channel configuration is taken from the source. If enabled, the setup you specify below us used. **num\_front\_channels**=\ (1..5, default: 2) Front channels **num\_rear\_channels**=\ (0..3, default: 0) Rear channels **num\_lfe\_channels**=\[1\|0\] (default: 0) LFE **front\_to\_rear**=\ Supported strings: mute copy diff Default: copy Front to rear mode Mix mode when the output format has rear channels, but the source doesn't. **stereo\_to\_mono**=\ Supported strings: left right mix Default: mix Stereo to mono mode Mix mode when downmixing Stereo to Mono. - **-vid** *param1=val1\[¶m2=val2...\]* Set video processing options **q**=\ (1..5, default: 2) Conversion Quality Set the conversion quality for format conversions. Lower quality means more speed. Values above 3 enable slow high quality calculations. **alpha\_mode**=\ Supported strings: ignore blend\_color Default: ignore Alpha mode This option is used if the source has an alpha (=transparency) channel, but the output supports no transparency. Either, the transparency is ignored, or the background color you specify below is blended in. **background\_color**=\,\,\ (default: 0.000,0.000,0.000) \, \ and \ are in the range 0.0..1.0 Background color Background color to use, when alpha mode above is "Blend background color". **rc**=\[1\|0\] (default: 0) Resample chroma Always perform chroma resampling if chroma subsampling factors or chroma placements are different. Usually, this is only done for qualities above 3. **skip**=\[1\|0\] (default: 1) Skip frames Skip frames to keep A/V sync **threads**=\ (1..1024, default: 1) Number of threads Threads to launch for processing operations. Changing this requires program restart - **-oa** *plugin\[?param1=val1\[¶m2=val2...\]\]* Set audio output plugin. Use -list-oa to list available plugins and -list-plugin-parameters \ to list all supported options - **-ov** *plugin\[?param1=val1\[¶m2=val2...\]\]* Set video output plugin. Use -list-ov to list available plugins and -list-plugin-parameters \ to list all supported options - **-fa** *plugin\[?param1=val1\[¶m2=val2...\]\]* Add an audio filter with options to the chain. This option can be given multiple times. Use -list-fa to list available plugins and -list-plugin-parameters \ to list all supported options - **-fv** *plugin\[?param1=val1\[¶m2=val2...\]\]* Add a video filter with options to the chain. This option can be given multiple times. Use -list-fv to list available plugins and -list-plugin-parameters \ to list all supported options - **-inopt** *param1=val1\[¶m2=val2...\]* Set generic input options **still\_framerate**=\ (0..100, default: 10) Still image repitition rate When showing still images, gmerlin repeats them periodically to make realtime filter tweaking work. **sync\_offset**=\ (-1000..1000, default: 0) Sync offset \[ms\] Use this for playing buggy files, which have a constant offset between audio and video. Use positive values if the video is ahead of audio - **-osd** *param1=val1\[¶m2=val2...\]* Set OSD options **enable\_osd**=\[1\|0\] (default: 1) Enable OSD **mode**=\ Supported strings: simple box outline Default: box Mode **fontname**=\ (Default: Sans Bold 20) Font **color**=\,\,\,\ (default: 1.000,1.000,1.000,1.000) \, \, \ and \ are in the range 0.0..1.0 Foreground color **border\_color**=\,\,\ (default: 0.000,0.000,0.000) \, \ and \ are in the range 0.0..1.0 Border color **border\_width**=\ (0.00..10.00, default: 0.00) Border width **justify\_h**=\ Supported strings: center left right Default: center Horizontal justify **justify\_v**=\ Supported strings: center top bottom Default: center Vertical justify **border\_left**=\ (0..65535, default: 10) Left border Distance from the left text border to the image border **border\_right**=\ (0..65535, default: 10) Right border Distance from the right text border to the image border **border\_top**=\ (0..65535, default: 10) Top border Distance from the top text border to the image border **border\_bottom**=\ (0..65535, default: 10) Bottom border Distance from the bottom text border to the image border **box\_color**=\,\,\,\ (default: 0.200,0.200,0.200,0.700) \, \, \ and \ are in the range 0.0..1.0 Box color **box\_radius**=\ (0..20, default: 10) Box corner radius **box\_padding**=\ (0..20, default: 10) Box padding **duration**=\ (0..10000, default: 2000) Duration (milliseconds) - **-nt** Disable time display - **-nc** Use ncurses frontend - **-vol** *\* Set volume (0.0 - 1.0) - **-tracks** *\* \ can be a ranges mixed with comma separated tracks - **-as** *\* Selects audio stream index (starting with 1) - **-ss** *\* Selects subtitle stream index (starting with 1) - **-ra** *plugin\[?param1=val1\[¶m2=val2...\]\]* Select audio recoder plugin. Use -list-ra to list available plugins and -list-plugin-parameters \ to list all supported options - **-rv** *plugin\[?param1=val1\[¶m2=val2...\]\]* Use -list-rv to list available plugins and -list-plugin-parameters \ to list all supported options - **-list-input** List the names of the installed input plugins - **-list-oa** List the names of the installed audio output plugins - **-list-ov** List the names of the installed video output plugins - **-list-fa** List the names of the installed audio filter plugins - **-list-fv** List the names of the installed video filter plugins - **-list-ra** List the names of the installed audio recorder plugins - **-list-rv** List the names of the installed video recorder plugins - **-list-plugin-parameters** *plugin* List the parameters supported by the plugin ## GENERIC OPTIONS The following generic options are available for all gmerlin applications - **-help** Print this help message and exit - **-help-man** Print this help message as a manual page and exit - **-help-texi** Print this help message in texinfo format and exit - **-version** Print version info and exit - **-v** *level* Set verbosity level (0..4) - **-syslog** *name* Log to syslog the specified name - **-stderr** Always log to stderr ## FILES **~/.gmerlin/plugins.xml** Cache of the plugin registry (shared by all applications) **~/.gmerlin/generic/cfg.xml** Default plugin parameters are read from there. Use gmerlin\_plugincfg to change them.