DOKK / manpages / debian 12 / gmerlin / gmerlin-play.1.en
GMERLIN_PLAY(1) User Manuals GMERLIN_PLAY(1)

gmerlin_play - Gmerlin commandline player

gmerlin_play [options] gml...

Commandline mediaplayer

-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 <plugin> to list all supported options

-aud param1=val1[&param2=val2...]

Set audio processing options
q=<number> (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=<string>

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=<string>

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=<number> (1..5, default: 2)

Front channels

num_rear_channels=<number> (0..3, default: 0)

Rear channels

num_lfe_channels=[1|0] (default: 0)

LFE

front_to_rear=<string>

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=<string>

Supported strings: left right mix

Default: mix

Stereo to mono mode

Mix mode when downmixing Stereo to Mono.

-vid param1=val1[&param2=val2...]

Set video processing options
q=<number> (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=<string>

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=<r>,<g>,<b> (default: 0.000,0.000,0.000)

<r>, <g> and <b> 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=<number> (1..1024, default: 1)

Number of threads

Threads to launch for processing operations. Changing this requires program restart

-oa plugin[?param1=val1[&param2=val2...]]

Set audio output plugin. Use -list-oa to list available plugins and -list-plugin-parameters <plugin> to list all supported options

-ov plugin[?param1=val1[&param2=val2...]]

Set video output plugin. Use -list-ov to list available plugins and -list-plugin-parameters <plugin> to list all supported options

-fa plugin[?param1=val1[&param2=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 <plugin> to list all supported options

-fv plugin[?param1=val1[&param2=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 <plugin> to list all supported options

-inopt param1=val1[&param2=val2...]

Set generic input options
still_framerate=<number> (0..100, default: 10)

Still image repitition rate

When showing still images, gmerlin repeats them periodically to make realtime filter tweaking work.

sync_offset=<number> (-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[&param2=val2...]

Set OSD options
enable_osd=[1|0] (default: 1)

Enable OSD

mode=<string>

Supported strings: simple box outline

Default: box

Mode

fontname=<string> (Default: Sans Bold 20)

Font

color=<r>,<g>,<b>,<a> (default: 1.000,1.000,1.000,1.000)

<r>, <g>, <b> and <a> are in the range 0.0..1.0

Foreground color

border_color=<r>,<g>,<b> (default: 0.000,0.000,0.000)

<r>, <g> and <b> are in the range 0.0..1.0

Border color

border_width=<number> (0.00..10.00, default: 0.00)

Border width

justify_h=<string>

Supported strings: center left right

Default: center

Horizontal justify

justify_v=<string>

Supported strings: center top bottom

Default: center

Vertical justify

border_left=<number> (0..65535, default: 10)

Left border

Distance from the left text border to the image border

border_right=<number> (0..65535, default: 10)

Right border

Distance from the right text border to the image border

border_top=<number> (0..65535, default: 10)

Top border

Distance from the top text border to the image border

border_bottom=<number> (0..65535, default: 10)

Bottom border

Distance from the bottom text border to the image border

box_color=<r>,<g>,<b>,<a> (default: 0.200,0.200,0.200,0.700)

<r>, <g>, <b> and <a> are in the range 0.0..1.0

Box color

box_radius=<number> (0..20, default: 10)

Box corner radius

box_padding=<number> (0..20, default: 10)

Box padding

duration=<number> (0..10000, default: 2000)

Duration (milliseconds)

-nt

Disable time display

-nc

Use ncurses frontend

-vol <volume>

Set volume (0.0 - 1.0)

-tracks <track_spec>

<track_spec> can be a ranges mixed with comma separated tracks

-as <idx>

Selects audio stream index (starting with 1)

-ss <idx>

Selects subtitle stream index (starting with 1)

-ra plugin[?param1=val1[&param2=val2...]]

Select audio recoder plugin. Use -list-ra to list available plugins and -list-plugin-parameters <plugin> to list all supported options

-rv plugin[?param1=val1[&param2=val2...]]

Use -list-rv to list available plugins and -list-plugin-parameters <plugin> 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

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

~/.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.

2023-01-11 Gmerlin