.TH GMERLIN_PLAY 1 "2024-02-09" 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 to list all supported options .RE .B \-aud .I param1=val1[¶m2=val2...] .RS 2 Set audio processing options .RE .RS 2 .BR q "= (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 "=" .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 "=" .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 "= (1..5, default: 2)" .P Front channels .P .BR num_rear_channels "= (0..3, default: 0)" .P Rear channels .P .BR num_lfe_channels "=[1|0] (default: 0)" .P LFE .P .BR front_to_rear "=" .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 "=" .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[¶m2=val2...] .RS 2 Set video processing options .RE .RS 2 .BR q "= (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 "=" .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 "=,, (default: 0.000,0.000,0.000)" .P , and 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 "= (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[¶m2=val2...]] .RS 2 Set audio output plugin. Use -list-oa to list available plugins and -list-plugin-parameters to list all supported options .RE .B \-ov .I plugin[?param1=val1[¶m2=val2...]] .RS 2 Set video output plugin. Use -list-ov to list available plugins and -list-plugin-parameters to list all supported options .RE .B \-fa .I plugin[?param1=val1[¶m2=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 to list all supported options .RE .B \-fv .I plugin[?param1=val1[¶m2=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 to list all supported options .RE .B \-inopt .I param1=val1[¶m2=val2...] .RS 2 Set generic input options .RE .RS 2 .BR still_framerate "= (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 "= (-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[¶m2=val2...] .RS 2 Set OSD options .RE .RS 2 .BR enable_osd "=[1|0] (default: 1)" .P Enable OSD .P .BR mode "=" .P Supported strings: simple box outline .P Default: box .P Mode .P .BR fontname "= (Default: Sans Bold 20)" .P Font .P .BR color "=,,, (default: 1.000,1.000,1.000,1.000)" .P , , and are in the range 0.0..1.0 .P Foreground color .P .BR border_color "=,, (default: 0.000,0.000,0.000)" .P , and are in the range 0.0..1.0 .P Border color .P .BR border_width "= (0.00..10.00, default: 0.00)" .P Border width .P .BR justify_h "=" .P Supported strings: center left right .P Default: center .P Horizontal justify .P .BR justify_v "=" .P Supported strings: center top bottom .P Default: center .P Vertical justify .P .BR border_left "= (0..65535, default: 10)" .P Left border .P Distance from the left text border to the image border .P .BR border_right "= (0..65535, default: 10)" .P Right border .P Distance from the right text border to the image border .P .BR border_top "= (0..65535, default: 10)" .P Top border .P Distance from the top text border to the image border .P .BR border_bottom "= (0..65535, default: 10)" .P Bottom border .P Distance from the bottom text border to the image border .P .BR box_color "=,,, (default: 0.200,0.200,0.200,0.700)" .P , , and are in the range 0.0..1.0 .P Box color .P .BR box_radius "= (0..20, default: 10)" .P Box corner radius .P .BR box_padding "= (0..20, default: 10)" .P Box padding .P .BR duration "= (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 .RS 2 Set volume (0.0 - 1.0) .RE .B \-tracks .I .RS 2 can be a ranges mixed with comma separated tracks .RE .B \-as .I .RS 2 Selects audio stream index (starting with 1) .RE .B \-ss .I .RS 2 Selects subtitle stream index (starting with 1) .RE .B \-ra .I plugin[?param1=val1[¶m2=val2...]] .RS 2 Select audio recoder plugin. Use -list-ra to list available plugins and -list-plugin-parameters to list all supported options .RE .B \-rv .I plugin[?param1=val1[¶m2=val2...]] .RS 2 Use -list-rv to list available plugins and -list-plugin-parameters 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