.TH GMERLIN_PLAYER 1 "March 2012" Gmerlin "User Manuals" .SH NAME gmerlin_player \- Commandline Multimedia player .SH SYNOPSIS .B gmerlin_player .I [options] .I gml... .SH DESCRIPTION Commandline Multimedia player .SH OPTIONS .B \-oa .I .RS 2 Set audio output options .RE .RS 2 .BR p "=option[{suboptions}]" .P Supported options: oa_alsa oa_pulse oa_oss oa_esd .P Default: oa_alsa .P Audio output plugin .P .B Suboptions for p=oa_alsa .P .RS 2 .BR card "=" .P Supported strings: default hw:0,0 hw:0,4 .P Default: default .P Card .P .BR surround40 "=[1|0] (default: 1)" .P Enable 4.0 Surround .P Use the surround 4.0 (aka quadrophonic) device .P .BR surround41 "=[1|0] (default: 1)" .P Enable 4.1 Surround .P Use the surround 4.1 device .P .BR surround50 "=[1|0] (default: 1)" .P Enable 5.0 Surround .P Use the surround 5.0 device .P .BR surround51 "=[1|0] (default: 1)" .P Enable 5.1 Surround .P Use the surround 5.1 device .P .BR user_device "=" .P User device .P Enter a custom device to use for playback. Leave empty to use the settings above .P .BR buffer_time "= (10..10000, default: 1000)" .P Buffer time .P Set the buffer time (in milliseconds). Larger values improve playback performance on slow systems under load. Smaller values decrease the latency of the volume control. .P .RE .B Suboptions for p=oa_oss .P .RS 2 .BR multichannel_mode "=" .P Supported strings: none multidev creative .P Default: none .P Multichannel Mode .P .BR device "= (Default: /dev/dsp)" .P Device .P .BR use_rear_device "=[1|0] (default: 0)" .P Use Rear Device .P .BR rear_device "= (Default: /dev/dsp1)" .P Rear Device .P .BR use_center_lfe_device "=[1|0] (default: 0)" .P Use Center/LFE Device .P .BR center_lfe_device "= (Default: /dev/dsp2)" .P Center/LFE Device .P .RE .B Suboptions for p=oa_esd .P .RS 2 .BR esd_host "=" .P Host (empty: local) .P .RE .RE .B \-ov .I .RS 2 Set video output options .RE .RS 2 .BR p "=option[{suboptions}]" .P Supported options: ov_x11 ov_v4l2 .P Default: ov_x11 .P Video output plugin .P .B Suboptions for p=ov_x11 .P .RS 2 .BR auto_resize "=[1|0] (default: 1)" .P Auto resize window .P .BR disable_xscreensaver_normal "=[1|0] (default: 0)" .P Disable Screensaver for normal playback .P .BR disable_xscreensaver_fullscreen "=[1|0] (default: 1)" .P Disable Screensaver for fullscreen playback .P .BR force_hw_scale "=[1|0] (default: 1)" .P Force hardware scaling .P Use hardware scaling even if it involves more CPU intensive pixelformat conversions .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 Specify the background color for videos with alpha channel. This is only used by the OpenGL driver. .P .BR scale_mode "=" .P Supported strings: auto nearest bilinear quadratic cubic_bspline cubic_mitchell cubic_catmull sinc_lanczos .P Default: auto .P Scale mode .P Choose scaling method. Auto means to choose based on the conversion quality. Nearest is fastest, Sinc with Lanczos window is slowest. .P .BR scale_order "= (4..1000, default: 4)" .P Scale order .P Order for sinc scaling .P .BR scale_quality "= (1..5, default: 2)" .P Scale quality .P Scale quality .P .RE .B Suboptions for p=ov_v4l2 .P .RS 2 .BR device "=option[{suboptions}]" .P Supported options: /dev/video0 .P Default: /dev/video0 .P V4L2 Device .P .BR force_rw "=[1|0] (default: 1)" .P Force write .P Don't use memory mapping .P .RE .BR w "=" .P Window ID .P .RE .B \-i .I .RS 2 Set and configure input plugin .RE .RS 2 .BR p "=option[{suboptions}]" .P Supported options: i_cdaudio i_avdec i_vcd i_dvd i_singlepic_stills i_lqt i_edl i_singlepic i_mikmod .P Default: i_cdaudio .P input plugin .P .B Suboptions for p=i_cdaudio .P .RS 2 .BR trackname_template "= (Default: %p \- %t)" .P Trackname template .P Template for track name generation from metadata %p: Artist %a: Album %g: Genre %t: Track name %n: Track number (d = number of digits, 1\-9) %y: Year %c: Comment .P .BR use_cdtext "=[1|0] (default: 1)" .P Use CD\-Text .P Try to get CD metadata from CD\-Text .P .BR use_local "=[1|0] (default: 1)" .P Use locally saved metadata .P Whenever we obtain CD metadata from the internet, we save them into $HOME/.gmerlin/cdaudio_metadata. If you got wrong metadata for a CD, disabling this option will retrieve the metadata again and overwrite the saved data. .P .BR use_musicbrainz "=[1|0] (default: 1)" .P Use Musicbrainz .P .BR musicbrainz_host "= (Default: mm.musicbrainz.org)" .P Server .P .BR musicbrainz_port "= (1..65535, default: 80)" .P Port .P .BR musicbrainz_proxy_host "=" .P Proxy .P Proxy server (leave empty for direct connection) .P .BR musicbrainz_proxy_port "= (1..65535, default: 80)" .P Proxy port .P Proxy port .P .BR use_cddb "=[1|0] (default: 1)" .P Use Cddb .P .BR cddb_host "= (Default: freedb.org)" .P Server .P .BR cddb_port "= (1..65535, default: 80)" .P Port .P .BR cddb_path "= (Default: /~cddb/cddb.cgi)" .P Path .P .BR cddb_proxy_host "=" .P Proxy .P Proxy server (leave empty for direct connection) .P .BR cddb_proxy_port "= (1..65535, default: 80)" .P Proxy port .P Proxy port .P .BR cddb_proxy_user "=" .P Proxy username .P User name for proxy (leave empty for poxies, which don't require authentication) .P .BR cddb_proxy_pass "=" .P Proxy password .P Password for proxy .P .BR cddb_timeout "= (0..1000, default: 10)" .P Timeout .P Timeout (in seconds) for connections to the CDDB server .P .BR cdparanoia_speed "=" .P Supported strings: Auto 4 8 16 32 .P Default: Auto .P Speed .P .BR cdparanoia_max_retries "= (0..200, default: 20)" .P Maximum retries .P Maximum number of retries, 0 = infinite .P .BR cdparanoia_disable_paranoia "=[1|0] (default: 0)" .P Disable paranoia .P Disable all data verification and correction features. .P .BR cdparanoia_disable_extra_paranoia "=[1|0] (default: 0)" .P Disable extra paranoia .P Disables intra\-read data verification; only overlap checking atread boundaries is performed. It can wedge if errors occur in the attempted overlap area. Not recommended. .P .RE .B Suboptions for p=i_avdec .P .RS 2 .BR audio_dynrange "=[1|0] (default: 1)" .P Dynamic range control .P Enable dynamic range control for codecs, which support this (currently only A52 and DTS). .P .BR pp "= (0.00..1.00, default: 0.20)" .P Postprocessing level .P Set postprocessing (to remove compression artifacts). 0 means no postprocessing, 1 means maximum postprocessing. .P .BR shrink "= (0..3, default: 0)" .P Shrink factor .P This enables downscaling of images while decoding. Currently only supported for JPEG\-2000. .P .BR vdpau "=[1|0] (default: 1)" .P Use vdpau .P Use VDPAU .P .BR connect_timeout "= (0..2000000, default: 5000)" .P Connect timeout (milliseconds) .P .BR read_timeout "= (0..2000000, default: 5000)" .P Read timeout (milliseconds) .P .BR network_buffer_size "= (1..1000, default: 32)" .P Network buffer size (kB) .P .BR network_bandwidth "=" .P Supported strings: 14400 19200 28800 33600 34400 57600 115200 262200 393200 524300 1500000 10500000 .P Default: 524300 .P Bandwidth .P .BR http_shoutcast_metadata "=[1|0] (default: 1)" .P Enable shoutcast title streaming .P .BR http_use_proxy "=[1|0] (default: 0)" .P Use proxy .P .BR http_proxy_host "=" .P Proxy host .P .BR http_proxy_port "= (1..65535, default: 80)" .P Proxy port .P .BR http_proxy_auth "=[1|0] (default: 0)" .P Proxy needs authentication .P .BR http_proxy_user "=" .P Proxy username .P .BR http_proxy_pass "=" .P Proxy password .P .BR rtp_try_tcp "=[1|0] (default: 0)" .P Try RTP over TCP .P Use this if your filewall blocks all UDP traffic. Not all servers support TCP .P .BR rtp_port_base "= (0..65530, default: 0)" .P Port base for RTP .P Port base for RTP over UDP. Values of 1024 or smaller enable random ports (recommended for RTSP aware firewalls). Values larger than 1024 define the base port. 2 consecutive ports are used for each A/V stream, these must be accessible through the firewall. Odd values are rounded to the next even value. .P .BR ftp_anonymous "=[1|0] (default: 1)" .P Login as anonymous .P .BR ftp_anonymous_password "= (Default: gates@nanosoft.com)" .P Anonymous ftp password .P .BR seek_subtitles "=" .P Supported strings: never video always .P Default: never .P Seek external subtitles .P If the input is a regular file, gmerlin_avdecoder can scan the directory for matching subtitle files. For a file movie.mpg, possible subtitle files are e.g. movie_english.srt, movie_german.srt. The rule is, that the first part of the filename of the subtitle file must be equal to the movie filename up to the extension. Furthermore, the subtitle filename must have an extension supported by any of the subtitle readers. Subtitle seeking can be disabled, enabled for video files or enabled for all files. .P .BR default_subtitle_encoding "= (Default: LATIN1)" .P Default subtitle encoding .P This sets the default encoding for text subtitles,when the original encoding is unknown. It must be a character set namerecognized by iconv. Type 'iconv \-l' at the commandline for a list of supported encodings. .P .BR sample_accuracy "=" .P Supported strings: never always when_necessary .P Default: never .P Sample accurate .P Try sample accurate seeking. For most formats, this is not necessary, since normal seeking works fine. Some formats are only seekable in sample accurate mode. Choose "When necessary" to enable seeking for most formats with the smallest overhead. .P .BR cache_time "= (default: 500)" .P Cache time (milliseconds) .P If building an index takes longer than the specified time, it will be cached. .P .BR cache_size "= (default: 20)" .P Cache size (Megabytes) .P Set the maximum total size of the cache directory. .P .BR threads "= (1..1024, default: 1)" .P Number of decoding threads .P Set the number of threads used by Video codecs .P .BR dv_datetime "=[1|0] (default: 0)" .P Export date and time as timecodes for DV .P .RE .B Suboptions for p=i_dvd .P .RS 2 .BR audio_dynrange "=[1|0] (default: 1)" .P Dynamic range control .P Enable dynamic range control for codecs, which support this (currently only A52 and DTS). .P .RE .B Suboptions for p=i_singlepic_stills .P .RS 2 .BR display_time "={[[HH:]MM:]SS} (default: 0:00)" .P Seconds can be fractional (i.e. with decimal point) Display time .P Time to pass until the next track will be selected. 0 means infinite. .P .RE .B Suboptions for p=i_lqt .P .RS 2 .BR ac "={option[{suboptions}][:option[{suboptions}]...]}" .P Supported options: ima4 rawaudio twos ulaw sowt alaw in24 in32 fl32 fl64 lpcm vorbis vorbis_qt ffmpeg_mp3 ffmpeg_mp2 ffmpeg_ac3 ffmpeg_qdm2 ffmpeg_alac ffmpeg_adpcm_ms ffmpeg_ima_adpcm_wav faad2 Audio Codecs .P Sort and configure audio codecs .P .BR vc "={option[{suboptions}][:option[{suboptions}]...]}" .P Supported options: raw v308 v408 v410 yuv2 yuv4 yv12 2vuy v210 rtjpeg jpeg mjpa png ffmpeg_mpg1 ffmpeg_mpg4 ffmpeg_msmpeg4v1 ffmpeg_msmpeg4v2 ffmpeg_msmpeg4v3 ffmpeg_msmpeg4v3_wmp ffmpeg_h263_dec ffmpeg_h263 ffmpeg_h264 ffmpeg_i263 ffmpeg_svq1 ffmpeg_svq3 ffmpeg_mjpg ffmpeg_mjpegb ffmpeg_TGA ffmpeg_TIFF ffmpeg_8BPS ffmpeg_indeo ffmpeg_rpza ffmpeg_smc ffmpeg_cinepak ffmpeg_cyuv ffmpeg_rle ffmpeg_wrle ffmpeg_dv ffmpeg_dvcpro ffmpeg_dv50 ffmpeg_dvcprohd ffmpeg_ffvhuff ffmpeg_ffv1 ffmpeg_dnxhd ffmpeg_imx schroedinger yuvs Video Codecs .P Sort and configure video codecs .P .B Suboptions for ffmpeg_mpg1 .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_mpg4 .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_msmpeg4v1 .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_msmpeg4v2 .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_msmpeg4v3 .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_msmpeg4v3_wmp .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_h263_dec .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_h263 .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_h264 .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_i263 .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_svq1 .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_svq3 .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_mjpg .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_indeo .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_cinepak .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_cyuv .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_dv .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_dvcpro .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_dv50 .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_dvcprohd .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_ffvhuff .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_ffv1 .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_dnxhd .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .B Suboptions for ffmpeg_imx .P .RS 2 .BR ff_flag_gray "=[1|0] (default: 0)" .P Grayscale mode .P .RE .RE .B Suboptions for p=i_singlepic .P .RS 2 .BR timescale "= (1..100000, default: 25)" .P Timescale .P .BR frame_duration "= (1..100000, default: 1)" .P Frame duration .P .RE .B Suboptions for p=i_mikmod .P .RS 2 .BR output "=" .P Supported strings: mono8 stereo8 mono16 stereo16 .P Default: stereo16 .P Output format .P .BR mixing_frequency "= (4000..60000, default: 44100)" .P Samplerate .P .BR hidden "=[1|0] (default: 0)" .P Look for hidden patterns in module .P .BR sur "=[1|0] (default: 0)" .P Use surround mixing .P .BR fade "=[1|0] (default: 0)" .P Force volume fade at the end of module .P .BR interpol "=[1|0] (default: 0)" .P Use interpolate mixing .P .RE .RE .B \-aud .I .RS 2 Set audio processing options .RE .RS 2 .BR sampleformat "=" .P Supported strings: none 8 16 32 f d .P Default: none .P Force sampleformat .P Force a sampleformat to be used for processing. None means to take the input format. .P .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 dither_mode "=" .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 fixed_samplerate "=[1|0] (default: 0)" .P Fixed samplerate .P If disabled, the output samplerate is taken from the source. If enabled, the samplerate you specify below us used. .P .BR samplerate "= (8000..192000, default: 44100)" .P Samplerate .P Samplerate .P .BR resample_mode "=" .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 .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 sm "=[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 still_framerate "= (1.00..100.00, default: 10.00)" .P Still image framerate .P Set framerate with which still images will be redisplayed periodically .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 \-inopt .I .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 .RS 2 Set OSD options .RE .RS 2 .BR enable_osd "=[1|0] (default: 1)" .P Enable OSD .P .BR font_size "= (12.00..100.00, default: 30.00)" .P Size .P Specify fontsize for OSD. The value you enter, is for an image width of 640. For other widths, the value will be scaled .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: 2.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 duration "= (0..10000, default: 2000)" .P Duration (milliseconds) .P .RE .B \-nt .RS 2 Disable time display .RE .B \-vol .I .RS 2 Set volume in dB (max: 0.0) .RE .B \-v .I level .RS 2 Set verbosity level (0..4) .RE .B \-tracks .I .RS 2 can be a ranges mixed with comma separated tracks .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 .SH FILES .B ~/.gmerlin/plugins.xml .RS 2 Cache of the plugin registry (shared by all applicatons) .RE .P .B ~/.gmerlin/generic/config.xml .RS 2 Default plugin parameters are read from there. Use gmerlin_plugincfg to change them. .RE .P