.TH GMERLIN_PLAY 1 "2023-01-11" Gmerlin "User Manuals"
.SH NAME
gmerlin_play \- Gmerlin commandline player
.SH SYNOPSIS
.B gmerlin_play 
.I [options]
.I gml...
.SH DESCRIPTION
Commandline mediaplayer

.SH OPTIONS

.B \-ip
.I plugin?opt1=val&opt2=val ..

.RS 2
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
.RE

.B \-aud
.I param1=val1[&param2=val2...]

.RS 2
Set audio processing options
.RE
.RS 2
.BR q "=<number> (1..5, default: 2)"
.P
Conversion Quality
.P
Set the conversion quality for format conversions. Lower quality means more
speed. Values above 3 enable slow high quality calculations.

.P
.BR dm "=<string>"
.P
Supported strings: auto none rect tri shaped
.P
Default: auto
.P
Dither mode
.P
Dither mode. Auto means to use the quality level. Subsequent options are
ordered by increasing quality (i.e. decreasing speed).

.P
.BR sm "=<string>"
.P
Supported strings: auto zoh linear sinc_fast sinc_medium sinc_best
.P
Default: auto
.P
Resample mode
.P
Resample mode. Auto means to use the quality level. Subsequent options are
ordered by increasing quality (i.e. decreasing speed).

.P
.BR fixed_channel_setup "=[1|0] (default: 0)"
.P
Fixed channel setup
.P
If disabled, the output channel configuration is taken from the source. If
enabled, the setup you specify below us used.

.P
.BR num_front_channels "=<number> (1..5, default: 2)"
.P
Front channels
.P
.BR num_rear_channels "=<number> (0..3, default: 0)"
.P
Rear channels
.P
.BR num_lfe_channels "=[1|0] (default: 0)"
.P
LFE
.P
.BR front_to_rear "=<string>"
.P
Supported strings: mute copy diff
.P
Default: copy
.P
Front to rear mode
.P
Mix mode when the output format has rear channels, but the source doesn't.

.P
.BR stereo_to_mono "=<string>"
.P
Supported strings: left right mix
.P
Default: mix
.P
Stereo to mono mode
.P
Mix mode when downmixing Stereo to Mono.

.P
.RE

.B \-vid
.I param1=val1[&param2=val2...]

.RS 2
Set video processing options
.RE
.RS 2
.BR q "=<number> (1..5, default: 2)"
.P
Conversion Quality
.P
Set the conversion quality for format conversions. Lower quality means more
speed. Values above 3 enable slow high quality calculations.

.P
.BR alpha_mode "=<string>"
.P
Supported strings: ignore blend_color
.P
Default: ignore
.P
Alpha mode
.P
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.

.P
.BR background_color "=<r>,<g>,<b> (default: 0.000,0.000,0.000)"
.P
<r>, <g> and <b> are in the range 0.0..1.0
.P
Background color
.P
Background color to use, when alpha mode above is "Blend background color".

.P
.BR rc "=[1|0] (default: 0)"
.P
Resample chroma
.P
Always perform chroma resampling if chroma subsampling factors or chroma
placements are different. Usually, this is only done for qualities above 3.

.P
.BR skip "=[1|0] (default: 1)"
.P
Skip frames
.P
Skip frames to keep A/V sync

.P
.BR threads "=<number> (1..1024, default: 1)"
.P
Number of threads
.P
Threads to launch for processing operations. Changing this requires program
restart

.P
.RE

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

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

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

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

.B \-fa
.I plugin[?param1=val1[&param2=val2...]]

.RS 2
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
.RE

.B \-fv
.I plugin[?param1=val1[&param2=val2...]]

.RS 2
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
.RE

.B \-inopt
.I param1=val1[&param2=val2...]

.RS 2
Set generic input options
.RE
.RS 2
.BR still_framerate "=<number> (0..100, default: 10)"
.P
Still image repitition rate
.P
When showing still images, gmerlin repeats them periodically to make
realtime filter tweaking work.

.P
.BR sync_offset "=<number> (-1000..1000, default: 0)"
.P
Sync offset [ms]
.P
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

.P
.RE

.B \-osd
.I param1=val1[&param2=val2...]

.RS 2
Set OSD options
.RE
.RS 2
.BR enable_osd "=[1|0] (default: 1)"
.P
Enable OSD
.P
.BR mode "=<string>"
.P
Supported strings: simple box outline
.P
Default: box
.P
Mode
.P
.BR fontname "=<string> (Default: Sans Bold 20)"
.P
Font
.P
.BR color "=<r>,<g>,<b>,<a> (default: 1.000,1.000,1.000,1.000)"
.P
<r>, <g>, <b> and <a> are in the range 0.0..1.0
.P
Foreground color
.P
.BR border_color "=<r>,<g>,<b> (default: 0.000,0.000,0.000)"
.P
<r>, <g> and <b> are in the range 0.0..1.0
.P
Border color
.P
.BR border_width "=<number> (0.00..10.00, default: 0.00)"
.P
Border width
.P
.BR justify_h "=<string>"
.P
Supported strings: center left right
.P
Default: center
.P
Horizontal justify
.P
.BR justify_v "=<string>"
.P
Supported strings: center top bottom
.P
Default: center
.P
Vertical justify
.P
.BR border_left "=<number> (0..65535, default: 10)"
.P
Left border
.P
Distance from the left text border to the image border

.P
.BR border_right "=<number> (0..65535, default: 10)"
.P
Right border
.P
Distance from the right text border to the image border

.P
.BR border_top "=<number> (0..65535, default: 10)"
.P
Top border
.P
Distance from the top text border to the image border

.P
.BR border_bottom "=<number> (0..65535, default: 10)"
.P
Bottom border
.P
Distance from the bottom text border to the image border

.P
.BR box_color "=<r>,<g>,<b>,<a> (default: 0.200,0.200,0.200,0.700)"
.P
<r>, <g>, <b> and <a> are in the range 0.0..1.0
.P
Box color
.P
.BR box_radius "=<number> (0..20, default: 10)"
.P
Box corner radius
.P
.BR box_padding "=<number> (0..20, default: 10)"
.P
Box padding
.P
.BR duration "=<number> (0..10000, default: 2000)"
.P
Duration (milliseconds)
.P
.RE

.B \-nt

.RS 2
Disable time display
.RE

.B \-nc

.RS 2
Use ncurses frontend
.RE

.B \-vol
.I <volume>

.RS 2
Set volume (0.0 - 1.0)
.RE

.B \-tracks
.I <track_spec>

.RS 2
<track_spec> can be a ranges mixed with comma separated tracks
.RE

.B \-as
.I <idx>

.RS 2
Selects audio stream index (starting with 1)
.RE

.B \-ss
.I <idx>

.RS 2
Selects subtitle stream index (starting with 1)
.RE

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

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

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

.RS 2
Use -list-rv to list available plugins and -list-plugin-parameters <plugin> to
list all supported options
.RE

.B \-list\-input

.RS 2
List the names of the installed input plugins
.RE

.B \-list\-oa

.RS 2
List the names of the installed audio output plugins
.RE

.B \-list\-ov

.RS 2
List the names of the installed video output plugins
.RE

.B \-list\-fa

.RS 2
List the names of the installed audio filter plugins
.RE

.B \-list\-fv

.RS 2
List the names of the installed video filter plugins
.RE

.B \-list\-ra

.RS 2
List the names of the installed audio recorder plugins
.RE

.B \-list\-rv

.RS 2
List the names of the installed video recorder plugins
.RE

.B \-list\-plugin\-parameters
.I plugin

.RS 2
List the parameters supported by the plugin
.RE

.SH GENERIC OPTIONS
The following generic options are available for all gmerlin applications

.B \-help

.RS 2
Print this help message and exit
.RE

.B \-help\-man

.RS 2
Print this help message as a manual page and exit
.RE

.B \-help\-texi

.RS 2
Print this help message in texinfo format and exit
.RE

.B \-version

.RS 2
Print version info and exit
.RE

.B \-v
.I level

.RS 2
Set verbosity level (0..4)
.RE

.B \-syslog
.I name

.RS 2
Log to syslog the specified name
.RE

.B \-stderr

.RS 2
Always log to stderr
.RE

.SH FILES
.B ~/.gmerlin/plugins.xml

.RS 2
Cache of the plugin registry (shared by all applications)
.RE

.P
.B ~/.gmerlin/generic/cfg.xml

.RS 2
Default plugin parameters are read from there. Use gmerlin_plugincfg to change
them.
.RE

.P