neulab/tldr huggingface dataset:
-v, --verbose Print additional logging. Multiple v's increase logging detail. This option is incompatible with the --quiet option.
-V, --version Print the version number of the scancel command.
-w, --nodelist=host1,host2,... Cancel any jobs using any of the given hosts.  The list may be specified as a comma-separated list of hosts, a range of hosts (host[1-5,7,...] for example), or a filename. The host list will be assumed to be a filename only if it contains a "/" character.
--wckey=wckey Restrict the scancel operation to jobs using this workload characterization key.
ARGUMENTS
job_id The Slurm job ID to be signaled.
step_id The step ID of the job step to be signaled.  If not specified, the operation is performed at the level of a job.
If neither --batch nor --signal are used, the entire job will be terminated.
When --batch is used, the batch shell processes will be signaled. The child processes of the shell will not be signaled by Slurm, but the shell may forward the signal.
When --batch is not used but --signal is used, then all job steps will be signaled, but the batch script itself will not be signaled.
Executing scancel sends a remote procedure call to slurmctld. If enough calls from scancel or other Slurm client commands that send remote procedure calls to the slurmctld daemon come in at once, it can result in a degradation of performance of the slurmctld daemon, possibly resulting in a denial of service.
Do not run scancel or other Slurm client commands that send remote procedure calls to slurmctld from loops in shell scripts or other programs. Ensure that programs limit calls to scancel to the minimum necessary for the information you are trying to gather.
Some scancel options may be set via environment variables. These environment variables, along with their corresponding options, are listed below.  (Note: commandline options will always override these settings)
SCANCEL_ACCOUNT     -A, --account=account
SCANCEL_BATCH       -b, --batch
SCANCEL_CTLD        --ctld
SCANCEL_FULL        -f, --full
SCANCEL_HURRY       -H, --hurry
SCANCEL_INTERACTIVE -i, --interactive
SCANCEL_NAME        -n, --name=job_name
SCANCEL_PARTITION   -p, --partition=partition_name
SCANCEL_QOS         -q, --qos=qos
SCANCEL_STATE       -t, --state=job_state_name
SCANCEL_USER        -u, --user=user_name
SCANCEL_VERBOSE     -v, --verbose
SCANCEL_WCKEY       --wckey=wckey
SLURM_CLUSTERS      -M, --clusters
If multiple filters are supplied (e.g. --partition and --name) only the jobs satisfying all of the filtering options will be signaled.
Cancelling a job step will not result in the job being terminated.  The job must be cancelled to release a resource allocation.
To cancel a job, invoke scancel without --signal option.  This will send first a SIGCONT to all steps to eventually wake them up followed by a SIGTERM, then wait the KillWait duration defined in the slurm.conf file and finally if they have not terminated send a SIGKILL.  This gives time for the running job/step(s) to clean up.
If a signal value of "KILL" is sent to an entire job, this will cancel the active job steps but not cancel the job itself.
On Cray systems, all signals except SIGCHLD, SIGCONT, SIGSTOP, SIGTSTP, SIGTTIN, SIGTTOU, SIGURG, or SIGWINCH cause the ALPS reservation to be released.  The job however will not be terminated except in the case of SIGKILL and may then be used for post processing.
When using SlurmDBD, users who have an AdminLevel defined (Operator or Admin) and users who are account coordinators are given the authority to invoke scancel on other users jobs.
Send SIGTERM to steps 1 and 3 of job 1234: scancel --signal=TERM 1234.1 1234.3
Cancel job 1234 along with all of its steps: scancel 1234
Send SIGKILL to all steps of job 1235, but do not cancel the job itself: scancel --signal=KILL 1235
Send SIGUSR1 to the batch shell processes of job 1236: scancel --signal=USR1 --batch 1236
Cancel job all pending jobs belonging to user "bob" in partition "debug": scancel --state=PENDING --user=bob --partition=debug
Cancel only array ID 4 of job array 1237 scancel 1237_4
Copyright (C) 2002-2007 The Regents of the University of California. Produced at Lawrence Livermore National Laboratory (cf, DISCLAIMER). Copyright (C) 2008-2011 Lawrence Livermore National Security. Copyright (C) 2010-2015 SchedMD LLC.
slurm_kill_job (3), slurm_kill_job_step (3)
YOUTUBE-VIEWER(1)      User Contributed Perl Documentation     YOUTUBE-VIEWER(1)
youtube-viewer - YouTube from command line.
See: youtube-viewer --help youtube-viewer --tricks youtube-viewer --examples youtube-viewer --stdin-help
auto_captions When set to 1, auto-generated captions will be retrieved. By default, auto-generated captions are ignored.
autoplay_mode Enable autoplay mode, which will continuously play related videos.
cache_dir Cache directory where to save temporary files.
colors Use colors for text.
comments_order The sorting order for comments. Valid values: "time", "relevance".
confirm Display a confirmation message after each video played.
convert_cmd Command to convert videos.
Default value:
"ffmpeg -i *IN* *OUT*"
*IN* gets replaced with the input file.
*OUT* gets replaced with the output file.
convert_to Format to convert each downloaded video into. (e.g.: "mp3").
cookie_file Load cookies from a file. Useful to overcome the "429: Too Many Requests" issue.
The file must be a "# Netscape HTTP Cookie File". Same format as "youtube-dl" requires.
https://github.com/ytdl-org/youtube-dl#how-do-i-pass-cookies-to-youtube-dl
copy_caption When downloading a video, copy the closed-caption (if any) in the same folder with the video.
If "merge_into_mkv" and "merge_with_captions" are both enabled, there is no need to enable this option.
custom_layout_format An array of hash values specifying a custom layout for video results.
align       # "left" or "right" color       # any color supported by Term::ANSIColor text        # the actual text width       # width allocated for the text
The value for "width" can be either a number of characters (e.g.: 20) or can be a percentage of the terminal width (e.g.: "15%").
The special tokens for "text" are listed in:
youtube-viewer --tricks
For better formatting, it's highly recommended to install Unicode::GCString or Text::CharWidth.
custom_channel_layout_format An array of hash values specifying a custom layout for channel results.
custom_playlist_layout_format An array of hash values specifying a custom layout for playlist results.
dash_mp4_audio Include or exclude MP4/M4A (AAC) audio files.
dash_segmented Include or exclude streams in "Dynamic Adaptive Streaming over HTTP" (DASH) format.
dash_support Enable or disable support for split videos.
debug Enable debug/verbose mode, which will print some extra information.
Valid values: 0, 1, 2, 3.
download_and_play Play downloaded videos.
download_with_wget Download videos with "wget".
downloads_dir Directory where to download files and where to save converted files.
env_proxy Load proxy settings from *_proxy environment variables (if any).
fat32safe When downloading a video, make the filename compatible with the FAT32 filesystem.
ffmpeg_cmd Path to the "ffmpeg" program.
fullscreen Play videos in fullscreen mode.
get_captions Download closed-captions for videos (if any).
get_term_width Read the terminal width (`stty size`).
hfr Prefer or ignore High Frame Rate (HFR) video streams.
Try to disable this option if the videos are lagging or dropping frames.
highlight_color Highlight color used to highlight watched videos.
Any color supported by Term::ANSIColor can be used.
highlight_watched Highlight watched videos.
history Enable or disable support for input history.
Requires Term::ReadLine::Gnu.
history_file File where to save the input history.
history_limit Maximum number of entries in the history file.
When the limit is reached, the first half of the history file will be deleted.
Set the value to "-1" for no limit.
hl Language code for categories. Default: "en_US".
http_proxy Set HTTP(S)/SOCKS proxy, using the format:
'proto://domain.tld:port/'
If authentication is required, use:
'proto://user:pass@domain.tld:port/'
ignore_av1 Ignore videos in AV1 format.
interactive Interactive mode, prompting for user-input.
keep_original_video Keep the original video after conversion. When set to 0, the original video will be deleted.
maxResults How many results to display per page.
merge_into_mkv During download, merge the audio+video files into an MKV container.
Requires "ffmpeg".
merge_into_mkv_args Arguments for "ffmpeg" how to merge the files.
merge_with_captions Include closed-captions inside the MKV container (if any).
order Search order for videos.
Valid values:
date       – Sorted in reverse chronological order. rating     – Sorted from highest to lowest rating. relevance  – By relevance to the search query. (default) title      – Sorted alphabetically by title. videoCount – Sory by number of videos (for channels). viewCount  – Sorted from highest to lowest number of views.
page Page number of results.
prefer_av1 Prefer videos in AV1 format. (just for testing)
prefer_mp4 Prefer videos in MP4 (AVC) format.
publishedAfter The "publishedAfter" option indicates that the API response should only contain resources created at or after the specified time. The value is an RFC 3339 formatted date-time value (1970-01-01T00:00:00Z).
publishedBefore The "publishedBefore" option indicates that the API response should only contain resources created before or at the specified time. The value is an RFC 3339 formatted date-time value (1970-01-01T00:00:00Z).
regionCode The "regionCode" option instructs the API to return search results for videos that can be viewed in the specified country. The parameter value is an ISO 3166-1 alpha-2 country code. (default: "US")
remove_played_file When "download_and_play" is enabled, remove the file after playing it.
resolution Preferred resolution for videos.
Valid values: best, 2160p, 1440p, 1080p, 720p, 480p, 360p, 240p, 144p, audio.
safeSearch The "safeSearch" option indicates whether the search results should include restricted content as well as standard content.
Valid values: "strict", "moderate", "none".
show_video_info Show extra info for videos when selected.
skip_if_exists When downloading, skip if the file already exists locally.
skip_watched Skip already watched/downloaded videos.
srt_languages List of SRT languages in the order of preference.
subscriptions_order Sorting order for subscriptions.
alphabetical – Sort alphabetically. relevance    – Sort by relevance. unread       – Sort by order of activity.
thousand_separator Thousands separator character for numbers >= 1000.
timeout HTTPS timeout value in seconds. The default value is 10 seconds.
user_agent Token that is used to identify the user agent on the network. The agent value is sent as the "User-Agent" header in the requests.
video_filename_format The format of filename for downloaded files.
The available special tokens are listed in:
video_player_selected The selected video player defined the "video_players" table.
video_players A table of video players.
The keys for each player are:
arg        # any arguments for the video player audio      # option specifying the *AUDIO* file cmd        # the main player command fs         # the fullscreen option novideo    # the no-video mode option srt        # option specifying the *SUB* file
videoCaption The "videoCaption" option indicates whether the API should filter video search results based on whether they have captions.
any           – Do not filter results based on caption availability. closedCaption – Only include videos that have captions. none          – Only include videos that do not have captions.
videoDefinition The "videoDefinition" option lets you restrict a search to only include either high definition (HD) or standard definition (SD) videos.
any      – Return all videos, regardless of their resolution. high     – Only retrieve HD videos. standard – Only retrieve videos in standard definition.
videoDimension The "videoDimension" option lets you restrict a search to only retrieve 2D or 3D videos.
2d  – Restrict search results to exclude 3D videos. 3d  – Restrict search results to only include 3D videos. any – Include both 3D and non-3D videos in returned results.
videoDuration The "videoDuration" parameter filters video search results based on their duration.
Valid values: "any", "short", "long".
any     – Do not filter video search results based on their duration. long    – Only include videos longer than 20 minutes. medium  – Only include videos that are between 4-20 minutes. short   – Only include videos that are less than 4 minutes long.
videoLicense The "videoLicense" option filters search results to only include videos with a particular license.
any            – All videos, regardless of which license they have. creativeCommon – Only return videos that have a "Creative Commons" license. youtube        – Only return videos that have the standard YouTube license.
videoSyndicated The "videoSyndicated" option lets you to restrict a search to only videos that can be played outside youtube.com.
any  – Return all videos, syndicated or not. true – Only retrieve syndicated videos.
watch_history Remember watched videos across multiple sessions.
The video IDs are saved in the filename specified by "watch_history_file".
This option is also required for "--watched-videos".
watch_history_file File where to save the video IDs of watched/downloaded videos when "watch_history" is set to a true value.
wget_cmd Command for "wget" when "download_with_wget" is set to a true value.
youtube_users_file Path to a list of YouTube channels, using the following format:
ChannelID NAME
The channels can be listed with the command-line option: "-fc".
youtube_video_url Format for "sprintf()" for constructing an YouTube video URL given the video ID.
ytdl Use "youtube-dl" for videos with encrypted signatures.
When set to 0, invidious instances will be used instead.
ytdl_cmd Command for "youtube-dl" when "ytdl" is set to a true value.
The configuration files are:
~/.config/youtube-viewer/youtube-viewer.conf ~/.config/youtube-viewer/gtk-youtube-viewer.conf
https://developers.google.com/youtube/v3/docs/
https://github.com/trizen/youtube-viewer
Copyright 2010-2021 Trizen.
This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See <https://dev.perl.org/licenses/> for more information.
MPlayer(1)                      The Movie Player                      MPlayer(1)
mplayer  - movie player mencoder - movie encoder
mplayer [options] [file|URL|playlist|-] mplayer [options] file1 [specific options] [file2] [specific options] mplayer [options] {group of files and options} [group-specific options] mplayer [br]://[title][/device] [options] mplayer [dvd|dvdnav]://[title|[start_title]-end_title][/device] [options] mplayer vcd://track[/device] mplayer tv://[channel][/input_id] [options] mplayer radio://[channel|frequency][/capture] [options] mplayer pvr:// [options] mplayer dvb://[card_number@]channel [options] mplayer mf://[filemask|@listfile] [-mf options] [options] mplayer [cdda|cddb]://track[-endtrack][:speed][/device] [options] mplayer cue://file[:track] [options] mplayer [file|mms[t]|http|http_proxy|rt[s]p|ftp|udp|unsv|icyx|noicyx|smb]:// [user:pass@]URL[:port] [options] mplayer sdp://file [options] mplayer mpst://host[:port]/URL [options] mplayer tivo://host/[list|llist|fsid] [options] gmplayer [options] [file|URL|playlist] [-skin skin] mencoder [options] file [file|URL|-] [-o file | file://file | smb://[user:pass@]host/filepath] mencoder [options] file1 [specific options] [file2] [specific options]
mplayer is a movie player for Linux (runs on many other platforms and CPU architectures, see the documentation).  It plays most MPEG/VOB, AVI, ASF/ WMA/WMV, RM, QT/MOV/MP4, Ogg/OGM, MKV, VIVO, FLI, NuppelVideo, yuv4mpeg, FILM and RoQ files, supported by many native and binary codecs.  You can watch VCD, SVCD, DVD, Blu-ray, 3ivx, DivX 3/4/5, WMV and even H.264 movies, too.
MPlayer supports a wide range of video and audio output drivers.  It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, libcaca, DirectFB, Quartz, Mac OS X CoreVideo, but you can also use GGI, SDL (and all their drivers), VESA (on every VESA-compatible card, even without X11), some low-level card-specific drivers (for Matrox, 3dfx and ATI) and some hardware MPEG decoder boards, such as the Siemens DVB, Hauppauge PVR (IVTV), DXR2 and DXR3/Hollywood+.  Most of them support software or hardware scaling, so you can enjoy movies in fullscreen mode.
MPlayer has an onscreen display (OSD) for status information, nice big antialiased shaded subtitles and visual feedback for keyboard controls. European/ISO8859-1,2 (Hungarian, English, Czech, etc), Cyrillic and Korean fonts are supported along with 12 subtitle formats (MicroDVD, SubRip, OGM, SubViewer, Sami, VPlayer, RT, SSA, AQTitle, JACOsub, PJS and our own: MPsub) and DVD subtitles (SPU streams, VOBsub and Closed Captions).
mencoder (MPlayer's Movie Encoder) is a simple movie encoder, designed to encode MPlayer-playable movies (see above) to other MPlayer-playable formats (see below).  It encodes to MPEG-4 (DivX/Xvid), one of the libavcodec codecs and PCM/MP3/VBRMP3 audio in 1, 2 or 3 passes. Furthermore it has stream copying abilities, a powerful filter system (crop, expand, flip, postprocess, rotate, scale, noise, RGB/YUV conversion) and more.
gmplayer is MPlayer with a graphical user interface.  Besides some own options (stored in gui.conf), it has the same options as MPlayer, however some MPlayer options will be stored in gui.conf so that they can be chosen independently from MPlayer. (See GUI CONFIGURATION FILE below.)
Usage examples to get you started quickly can be found at the end of this man page.
Also see the HTML documentation!
MPlayer has a fully configurable, command-driven control layer which allows you to control MPlayer using keyboard, mouse, joystick or remote control (with LIRC).  See the -input option for ways to customize it.
keyboard control LEFT and RIGHT Seek backward/forward 10 seconds. UP and DOWN Seek forward/backward 1 minute. PGUP and PGDWN Seek forward/backward 10 minutes. [ and ] Decrease/increase current playback speed by 10%. { and } Halve/double current playback speed. BACKSPACE Reset playback speed to normal. < and > Go backward/forward in the playlist. ENTER Go forward in the playlist, even over the end. HOME and END next/previous playtree entry in the parent list INS and DEL (ASX playlist only) next/previous alternative source. p / SPACE Pause (pressing again unpauses). . Step forward.  Pressing once will pause movie, every consecutive press will play one frame and then go into pause mode again (any other key unpauses). q / ESC Stop playing and quit. U Stop playing (and quit if -idle is not used). + and - Adjust audio delay by +/- 0.1 seconds. / and * Decrease/increase volume. 9 and 0 Decrease/increase volume. ( and ) Adjust audio balance in favor of left/right channel. m Mute sound. _ (MPEG-TS, AVI and libavformat only) Cycle through the available video tracks. # (DVD, Blu-ray, MPEG, Matroska, AVI and libavformat only) Cycle through the available audio tracks. TAB (MPEG-TS and libavformat only) Cycle through the available programs. f Toggle fullscreen (also see -fs). T Toggle stay-on-top (also see -ontop). w and e Decrease/increase pan-and-scan range. o Toggle OSD states: none / seek / seek + timer / seek + timer + total time. d Toggle frame dropping states: none / skip display / skip decoding (see -framedrop and -hardframedrop). v Toggle subtitle visibility. j and J Cycle through the available subtitles. y and g Step forward/backward in the subtitle list. F Toggle displaying "forced subtitles". a Toggle subtitle alignment: top / middle / bottom. x and z Adjust subtitle delay by +/- 0.1 seconds. c (-capture only) Start/stop capturing the primary stream. r and t Move subtitles up/down. i (-edlout mode only) Set start or end of an EDL skip and write it out to the given file. s (-vf screenshot only) Take a screenshot. S (-vf screenshot only) Start/stop taking screenshots. I Show filename on the OSD. P Show progression bar, elapsed time and total duration on the OSD. ! and @ Seek to the beginning of the previous/next chapter. D (-vo xvmc, -vo vdpau, -vf yadif, -vf kerndeint only) Activate/deactivate deinterlacer. A    Cycle through the available DVD angles.
(The following keys are valid only when using a hardware accelerated video output (xv, (x)vidix, (x)mga, etc), the software equalizer (-vf eq or -vf eq2) or hue filter (-vf hue).)
1 and 2 Adjust contrast. 3 and 4 Adjust brightness. 5 and 6 Adjust hue. 7 and 8 Adjust saturation.
(The following keys are valid only when using the quartz or corevideo video output driver.)
command + 0 Resize movie window to half its original size. command + 1 Resize movie window to its original size. command + 2 Resize movie window to double its original size. command + f Toggle fullscreen (also see -fs). command + [ and command + ] Set movie window alpha.
(The following keys are valid only when using the sdl video output driver.)
c Cycle through available fullscreen modes. n Restore original mode.
(The following keys are valid if you have a keyboard with multimedia keys.)
PAUSE Pause. STOP Stop playing and quit. PREVIOUS and NEXT Seek backward/forward 1 minute.
(The following keys are only valid if you compiled with TV or DVB input support and will take precedence over the keys defined above.)
h and k Select previous/next channel. n Change norm. u Change channel list.
(The following keys are only valid if you compiled with dvdnav support: They are used to navigate the menus.)
keypad 8 Select button up. keypad 2 Select button down. keypad 4 Select button left. keypad 6 Select button right. keypad 5 Return to main menu. keypad 7 Return to nearest menu (the order of preference is: chapter->title->root). keypad ENTER Confirm choice.
(The following keys are used for controlling TV teletext. The data may come from either an analog TV source or an MPEG transport stream.)
X Switch teletext on/off. Q and W Go to next/prev teletext page.
mouse control button 3 and button 4 Seek backward/forward 1 minute. button 5 and button 6 Decrease/increase volume.
joystick control left and right Seek backward/forward 10 seconds. up and down Seek forward/backward 1 minute. button 1 Pause. button 2 Toggle OSD states: none / seek / seek + timer / seek + timer + total time. button 3 and button 4 Decrease/increase volume.
Every 'flag' option has a 'noflag' counterpart, e.g. the opposite of the -fs option is -nofs.
If an option is marked as (XXX only), it will only work in combination with the XXX option or if XXX is compiled in.
NOTE: The suboption parser (used for example for -ao pcm suboptions) supports a special kind of string-escaping intended for use with external GUIs. It has the following format: %n%string_of_length_n EXAMPLES: mplayer -ao pcm:file=%10%C:test.wav test.avi Or in a script: mplayer -ao pcm:file=%`expr length "$NAME"`%"$NAME" test.avi
You can put all of the options in configuration files which will be read every time MPlayer/MEncoder is run.  The system-wide configuration file 'mplayer.conf' is in your configuration directory (e.g. /etc/mplayer or /usr/local/etc/mplayer), the user specific one is '~/.mplayer/config'. The configuration file for MEncoder is 'mencoder.conf' in your configuration directory (e.g. /etc/mplayer or /usr/local/etc/mplayer), the user specific one is '~/.mplayer/mencoder.conf'.  User specific options override system-wide options (in case of gmplayer, gui.conf options override user specific options) and options given on the command line override all.  The syntax of the configuration files is 'option=<value>', everything after a '#' is considered a comment. Options that work without values can be enabled by setting them to 'yes' or '1' or 'true' and disabled by setting them to 'no' or '0' or 'false'. Even suboptions can be specified in this way.
You can also write file-specific configuration files.  If you wish to have a configuration file for a file called 'movie.avi', create a file named 'movie.avi.conf' with the file-specific options in it and put it in ~/.mplayer/.  You can also put the configuration file in the same directory as the file to be played, as long as you give the -use-filedir-conf option (either on the command line or in your global config file).  If a file-specific configuration file is found in the same directory, no file-specific configuration is loaded from ~/.mplayer.  In addition, the -use-filedir-conf option enables directory-specific configuration files.  For this, MPlayer first tries to load a mplayer.conf from the same directory as the file played and then tries to load any file-specific configuration.
EXAMPLE MPLAYER CONFIGURATION FILE:
# Use Matrox driver by default. vo=xmga # I love practicing handstands while watching videos. flip=yes # Decode/encode multiple files from PNG, # start with mf://filemask mf=type=png:fps=25 # Eerie negative images are cool. vf=eq2=1.0:-0.8 # OSD progress bar vertical alignment progbar-align=50
EXAMPLE MENCODER CONFIGURATION FILE:
# Make MEncoder output to a default filename. o=encoded.avi # The next 4 lines allow mencoder tv:// to start capturing immediately. oac=pcm=yes ovc=lavc=yes lavcopts=vcodec=mjpeg tv=driver=v4l2:input=1:width=768:height=576:device=/dev/video0:audiorate=48000 # more complex default encoding option set lavcopts=vcodec=mpeg4:autoaspect=1 lameopts=aq=2:vbr=4 ovc=lavc=1 oac=lavc=1 passlogfile=pass1stats.log noautoexpand=1 subfont-autoscale=3 subfont-osd-scale=6 subfont-text-scale=4 subalign=2 subpos=96 spuaa=20
GUI CONFIGURATION FILE
GUI's own options are (MPlayer option names in parentheses): ao_alsa_device (alsa:device=) (ALSA only), ao_alsa_mixer (mixer) (ALSA only), ao_alsa_mixer_channel (mixer-channel) (ALSA only), ao_esd_device (esd:) (ESD only), ao_extra_stereo (af extrastereo) (default: 1.0), ao_extra_stereo_coefficient (af extrastereo=), ao_oss_device (oss:) (OSS only), ao_oss_mixer (mixer) (OSS only), ao_oss_mixer_channel (mixer- channel) (OSS only), ao_sdl_subdriver (sdl:) (SDL only), ao_surround (unused), ao_volnorm (af volnorm), autosync (enable/disable), autosync_size (autosync), cache (enable/disable), cache_size (cache), enable_audio_equ (af equalizer), equ_band_00 ... equ_band_59, (af equalizer=), equ_channel_1 ... equ_channel_6 (af channels=), gui_main_pos_x, gui_main_pos_y, gui_save_pos (yes/no), gui_tv_digital (yes/no), gui_video_out_pos_x, gui_video_out_pos_y, playbar (enable/disable), replay_gain (enable/disable), replay_gain_adjustment (-30..10), show_videowin (yes/no), vf_lavc (vf lavc) (DXR3 only), vf_pp (vf pp), vo_dxr3_device (unused) (DXR3 only).
MPlayer options stored in gui.conf (GUI option names, MPlayer option names in parentheses) are: a_afm (afm), ao_driver (ao), ass_bottom_margin (ass-bottom-margin) (ASS only), ass_enabled (ass) (ASS only), ass_top_margin (ass-top-margin) (ASS only), ass_use_margins (ass-use- margins) (ASS only), cdrom_device (cdrom-device), dvd_device (dvd- device), font_autoscale (subfont-autoscale) (FreeType only), font_blur (subfont-blur) (FreeType only), font_encoding (subfont-encoding), font_factor (ffactor), font_name (font), font_osd_scale (subfont-osd- scale) (FreeType only), font_outline (subfont-outline) (FreeType only), font_text_scale (subfont-text-scale) (FreeType only), gui_skin (skin), idle (idle), load_fullscreen (fs), osd_level (osdlevel), playlist_support (allow-dangerous-playlist-parsing), softvol (softvol), stopxscreensaver (stop-xscreensaver), sub_auto_load (autosub), sub_cp (subcp) (iconv only), sub_overlap (overlapsub), sub_pos (subpos), sub_unicode (unicode), sub_utf8 (utf8), v_flip (flip), v_framedrop (framedrop), v_idx (idx), v_ni (ni), v_vfm (vfm), vf_autoq (autoq), vo_direct_render (panscan), vo_doublebuffering (dr), vo_driver (vo), vo_panscan (double).
To ease working with different configurations profiles can be defined in the configuration files.  A profile starts with its name between square brackets, e.g. '[my-profile]'.  All following options will be part of the profile.  A description (shown by -profile help) can be defined with the profile-desc option.  To end the profile, start another one or use the profile name 'default' to continue with normal options.
EXAMPLE MPLAYER PROFILE:
[protocol.dvd] profile-desc="profile for dvd:// streams" vf=pp=hb/vb/dr/al/fd alang=en
[protocol.dvdnav] profile-desc="profile for dvdnav:// streams" profile=protocol.dvd mouse-movements=yes nocache=yes
[extension.flv] profile-desc="profile for .flv files" flip=yes
[vo.pnm] outdir=/tmp
[ao.alsa] device=spdif
EXAMPLE MENCODER PROFILE:
[mpeg4] profile-desc="MPEG4 encoding" ovc=lacv=yes lavcopts=vcodec=mpeg4:vbitrate=1200
[mpeg4-hq] profile-desc="HQ MPEG4 encoding" profile=mpeg4 lavcopts=mbd=2:trell=yes:v4mv=yes
-codecpath <dir> Specify a directory for binary codecs.
-codecs-file <filename> (also see -afm, -ac, -vfm, -vc) Override the standard search path and use the specified file instead of the builtin codecs.conf.
-include <configuration file> (also see -gui-include) Specify configuration file to be parsed after the default ones.
-list-options Prints all available options.
-msgcharset <charset> Convert console messages to the specified character set (default: autodetect).  Text will be in the encoding specified with the --charset configure option.  Set this to "noconv" to disable conversion (for e.g. iconv problems). NOTE: The option takes effect after command line parsing has finished.  The MPLAYER_CHARSET environment variable can help you get rid of the first lines of garbled output.
-msgcolor Enable colorful console output on terminals that support ANSI color.
-msglevel <all=<level>:<module>=<level>:...> Control verbosity directly for each module.  The 'all' module changes the verbosity of all the modules not explicitly specified on the command line.  See '-msglevel help' for a list of all modules. NOTE: Some messages are printed before the command line is parsed and are therefore not affected by -msglevel.  To control these messages you have to use the MPLAYER_VERBOSE environment variable, see its description below for details. Available levels: -1   complete silence 0   fatal messages only 1   error messages 2   warning messages 3   short hints 4   informational messages 5   status messages (default) 6   verbose messages 7   debug level 2 8   debug level 3 9   debug level 4
-msgmodule Prepend module name in front of each console message.
-noconfig <options> Do not parse selected configuration files. NOTE: If -include or -use-filedir-conf options are specified at the command line, they will be honoured.
Available options are: all all configuration files gui (GUI only) GUI configuration file system system configuration file user user configuration file
-quiet Make console output less verbose; in particular, prevents the status line (i.e. A:   0.7 V:   0.6 A-V:  0.068 ...) from being displayed.  Particularly useful on slow terminals or broken ones which do not properly handle carriage return (i.e. \r).
-priority <prio> (Windows and OS/2 only) Set process priority for MPlayer according to the predefined priorities available under Windows and OS/2.  Possible values of <prio>: idle|belownormal|normal|abovenormal|high|realtime
WARNING: Using realtime priority can cause system lockup.
-profile <profile1,profile2,...> Use the given profile(s), -profile help displays a list of the defined profiles.
-really-quiet (also see -quiet) Display even less output and status messages than with -quiet. Also suppresses the GUI error message boxes.
-show-profile <profile> Show the description and content of a profile.
-use-filedir-conf Look for a file-specific configuration file in the same directory as the file that is being played. WARNING: May be dangerous if playing from untrusted media.
-v Increment verbosity level, one level for each -v found on the command line.
PLAYER OPTIONS (MPLAYER ONLY) -autoq <quality> (use with -vf [s]pp) Dynamically changes the level of postprocessing depending on the available spare CPU time.  The number you specify will be the maximum level used.  Usually you can use some big number.  You have to use -vf [s]pp without parameters in order for this to work.
-autosync <factor> Gradually adjusts the A/V sync based on audio delay measurements. Specifying -autosync 0, the default, will cause frame timing to be based entirely on audio delay measurements.  Specifying -autosync 1 will do the same, but will subtly change the A/V correction algorithm.  An uneven video framerate in a movie which plays fine with -nosound can often be helped by setting this to an integer value greater than 1.  The higher the value, the closer the timing will be to -nosound.  Try -autosync 30 to smooth out problems with sound drivers which do not implement a perfect audio delay measurement.  With this value, if large A/V sync offsets occur, they will only take about 1 or 2 seconds to settle out.  This delay in reaction time to sudden A/V offsets should be the only side-effect of turning this option on, for all sound drivers.
-benchmark Prints some statistics on CPU usage and dropped frames at the end of playback.  Use in combination with -nosound and -vo null for benchmarking only the video codec. NOTE: With this option MPlayer will also ignore frame duration when playing only video (you can think of that as infinite fps).
-colorkey <number> Changes the colorkey to an RGB value of your choice.  0x000000 is black and 0xffffff is white.  Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix, xover, xv (see -vo xv:ck), xvmc (see -vo xv:ck) and directx video output drivers.
-nocolorkey Disables colorkeying.  Only supported by the cvidix, fbdev, svga, vesa, winvidix, xmga, xvidix, xover, xv (see -vo xv:ck), xvmc (see -vo xv:ck) and directx video output drivers.
-correct-pts (EXPERIMENTAL) Switches MPlayer to an experimental mode where timestamps for video frames are calculated differently and video filters which add new frames or modify timestamps of existing ones are supported.  The more accurate timestamps can be visible for example when playing subtitles timed to scene changes with the -ass option.  Without -correct-pts the subtitle timing will typically be off by some frames.  This option does not work correctly with some demuxers and codecs.
-crash-debug (DEBUG CODE) Automatically attaches gdb upon crash or SIGTRAP.  Support must be compiled in by configuring with --enable-crash-debug.
-doubleclick-time Time in milliseconds to recognize two consecutive button presses as a double-click (default: 300).  Set to 0 to let your windowing system decide what a double-click is (-vo directx only). NOTE: You will get slightly different behaviour depending on whether you bind MOUSE_BTN0_DBL or MOUSE_BTN0-MOUSE_BTN0_DBL.
-edlout <filename> Creates a new file and writes edit decision list (EDL) records to it.  During playback, the user hits 'i' to mark the start or end of a skip block.  This provides a starting point from which the user can fine-tune EDL entries later.  See http://www.mplayerhq.hu/DOCS/HTML/en/edl.html for details.
-edl-backward-delay <number> When using EDL during playback and jumping backwards it is possible to end up in the middle of an EDL record.  In that case MPlayer will seek further backwards to the start position of the EDL record and then immediately skip the scene specified in the EDL record.  To avoid this kind of behavior, MPlayer jumps to a fixed time interval before the start of the EDL record.  This parameter allows you to specify that time interval in seconds (default: 2 seconds).
-edl-start-pts Adjust positions in EDL records according to playing file's start time.  Some formats, especially MPEG TS usually start with non- zero PTS values and when producing EDL file with -edlout option, EDL records contain absolute values that are correct only for this particular file.  If re-encoded into a different format, this EDL file no longer applies.  Specifying -edl-start-pts will automatically adjust EDL positions according to start time: when producing EDL file, it will substract start time from every EDL record, when playing with EDL file, it will add file's start time to every EDL position.
-noedl-start-pts Disable adjusting EDL positions.
-enqueue (GUI only) Enqueue files given on the command line in the playlist instead of playing them immediately.
-fixed-vo Enforces a fixed video system for multiple files (one (un)initialization for all files).  Therefore only one window will be opened for all files.  Currently the following drivers are fixed-vo compliant: gl, gl_tiled, mga, svga, x11, xmga, xv, xvidix and dfbmga.
-framedrop (also see -hardframedrop, experimental without -nocorrect-pts) Skip displaying some frames to maintain A/V sync on slow systems. Video filters are not applied to such frames.  For B-frames even decoding is skipped completely.
-(no)gui Enable or disable the GUI interface (default depends on binary name).  Only works as the first argument on the command line. Does not work as a config-file option.
-gui-include <GUI configuration file> (also see -include) (GUI only) Specify a GUI configuration file to be parsed after the default gui.conf.
-h, -help, --help Show short summary of options.
-hardframedrop (experimental without -nocorrect-pts) More intense frame dropping (breaks decoding).  Leads to image distortion!  Note that especially the libmpeg2 decoder may crash with this, so consider using "-vc ffmpeg12,".
-heartbeat-cmd Command that is executed every 30 seconds during playback via system() - i.e. using the shell.
NOTE: MPlayer uses this command without any checking, it is your responsibility to ensure it does not cause security problems (e.g. make sure to use full paths if "." is in your path like on Windows).  It also only works when playing video (i.e. not with -novideo but works with -vo null).
This can be "misused" to disable screensavers that do not support the proper X API (also see -stop-xscreensaver).  If you think this is too complicated, ask the author of the screensaver program to support the proper X APIs.
EXAMPLE for xscreensaver: mplayer -heartbeat-cmd "xscreensaver-command -deactivate" file
EXAMPLE for GNOME screensaver: mplayer -heartbeat-cmd "gnome-screensaver-command -p" file
-heartbeat-interval Specify how often the -heartbeat-cmd should be executed, in seconds between executions (default: 30.0).
-identify Shorthand for -msglevel identify=4.  Show file parameters in an easily parseable format.  Also prints more detailed information about subtitle and audio track languages and IDs.  In some cases you can get more information by using -msglevel identify=6.  For example, for a DVD or Blu-ray it will list the chapters and time length of each title, as well as a disk ID.  Combine this with -frames 0 to suppress all video output.  The wrapper script TOOLS/ midentify.sh suppresses the other MPlayer output and (hopefully) shellescapes the filenames.
-idle (also see -slave) Makes MPlayer wait idly instead of quitting when there is no file to play.  Mostly useful in slave mode where MPlayer can be controlled through input commands. For gmplayer -idle is the default, -noidle will quit the GUI after all files have been played.
-input <commands> This option can be used to configure certain parts of the input system.  Paths are relative to ~/.mplayer/. NOTE: Autorepeat is currently only supported by joysticks.
Available commands are:
conf=<filename> Specify input configuration file other than the default ~/ .mplayer/input.conf.  ~/.mplayer/<filename> is assumed if no full path is given. ar-dev=<device> Device to be used for Apple IR Remote (default is autodetected, Linux only). ar-delay Delay in milliseconds before we start to autorepeat a key (0 to disable). ar-rate Number of key presses to generate per second on autorepeat. (no)default-bindings Use the key bindings that MPlayer ships with by default. keylist Prints all keys that can be bound to commands. cmdlist Prints all commands that can be bound to keys. js-dev Specifies the joystick device to use (default: /dev/input/ js0). file=<filename> Read commands from the given file.  Mostly useful with a FIFO. NOTE: When the given file is a FIFO MPlayer opens both ends so you can do several 'echo "seek 10" > mp_pipe' and the pipe will stay valid.
-key-fifo-size <2-65000> Specify the size of the FIFO that buffers key events (default: 7). A FIFO of size n can buffer (n-1) events.  If it is too small some events may be lost.  If it is too big, MPlayer may seem to hang while it processes the buffered events.  To get the same behavior as before this option was introduced, set it to 2 for Linux or 1024 for Windows.  For small value you should disable double- clicks by setting -doubleclick-time to 0 so they do not compete with regular events for buffer space.
-lircconf <filename> (LIRC only) Specifies a configuration file for LIRC (default: ~/.lircrc).
-list-properties Print a list of the available properties.
-loop <number> Loops movie playback <number> times.  0 means forever.  Use -loop 0 to automatically reconnect to live streaming URLs.
-menu (OSD menu only) Turn on OSD menu support.
-menu-cfg <filename> (OSD menu only) Use an alternative menu.conf.
-menu-chroot <path> (OSD menu only) Chroot the file selection menu to a specific location.
EXAMPLE: -menu-chroot /home Will restrict the file selection menu to /home and downward (i.e. no access to / will be possible, but /home/user_name will).
-menu-keepdir (OSD menu only) File browser starts from the last known location instead of current directory.
-menu-root <value> (OSD menu only) Specify the main menu.
-menu-startup (OSD menu only) Display the main menu at MPlayer startup.
-mouse-movements Permit MPlayer to receive pointer events reported by the video output driver.  Necessary to select the buttons in DVD menus. Supported for X11-based VOs (x11, xv, xvmc, etc) and the gl, gl_tiled, direct3d and corevideo VOs.
-noar  Turns off AppleIR remote support.
-noconsolecontrols Prevent MPlayer from reading key events from standard input. Useful when reading data from standard input.  This is automatically enabled when - is found on the command line.  There are situations where you have to set it manually, e.g. if you open /dev/stdin (or the equivalent on your system), use stdin in a playlist or intend to read from stdin later on via the loadfile or loadlist slave commands.
-nojoystick Turns off joystick support.
-nolirc Turns off LIRC support.
-nomouseinput Disable mouse button press/release input (mozplayerxp's context menu relies on this option).
-rtc (RTC only) Turns on usage of the Linux RTC (realtime clock - /dev/rtc) as timing mechanism.  This wakes up the process every 1/1024 seconds to check the current time.  Useless with modern Linux kernels configured for desktop use as they already wake up the process with similar accuracy when using normal timed sleep.
-pausing <0-3> (MPlayer only) Specifies the default pausing behaviour of commands, i.e. whether MPlayer will continue playback or stay paused after the command has finished.  See DOCS/tech/slave.txt for further details. 0    resume 1    pause (pausing) 2    keep the paused / playing status (pausing_keep) 3    toggle the paused / playing status (pausing_toggle) 4    pause without frame step (experimental) (pausing_keep_force)
-playing-msg <string> Print out a string before starting playback.  The following expansions are supported:
${NAME} Expand to the value of the property NAME.
?(NAME:TEXT) Expand TEXT only if the property NAME is available.
?(!NAME:TEXT) Expand TEXT only if the property NAME is not available.
-playlist <filename> Play files according to a playlist file (ASX, Winamp, SMIL, or one-file-per-line format). WARNING: The way MPlayer parses and uses playlist files is not safe against maliciously constructed files.  Such files may trigger harmful actions.  This has been the case for all MPlayer versions, but unfortunately this fact was not well documented earlier, and some people have even misguidedly recommended use of -playlist with untrusted sources.  Do NOT use -playlist with random internet sources or files you don't trust! NOTE: This option is considered an entry so options found after it will apply only to the elements of this playlist. FIXME: This needs to be clarified and documented thoroughly.
-allow-dangerous-playlist-parsing This enables parsing any file as a playlist if e.g. a server advertises a file as playlist.  Only enable if you know all servers involved are trustworthy.  MPlayer's playlist code is not designed to handle malicious playlist files.
-rtc-device <device> Use the specified device for RTC timing.
-shuffle Play files in random order.
-skin <name> (GUI only) Loads a skin from the directory given as parameter below the default skin directories, ~/.mplayer/skins/ and /usr/local/share/ mplayer/skins/.
EXAMPLE: -skin fittyfene Tries ~/.mplayer/skins/fittyfene and afterwards /usr/ local/share/mplayer/skins/fittyfene.
-slave (also see -input) Switches on slave mode, in which MPlayer works as a backend for other programs.  Instead of intercepting keyboard events, MPlayer will read commands separated by a newline (\n) from stdin. NOTE: See -input cmdlist for a list of slave commands and DOCS/tech/slave.txt for their description.  Also, this is not intended to disable other inputs, e.g. via the video window, use some other method like -input nodefault-bindings:conf=/dev/null for that.
-softsleep Time frames by repeatedly checking the current time instead of asking the kernel to wake up MPlayer at the correct time.  Useful if your kernel timing is imprecise and you cannot use the RTC either.  Comes at the price of higher CPU consumption.
-sstep <sec> Skip <sec> seconds after every frame.  The normal framerate of the movie is kept, so playback is accelerated.  Since MPlayer can only seek to the next keyframe this may be inexact.
-udp-ip <ip> Sets the destination address for datagrams sent by the -udp-master.  Setting it to a broadcast address allows multiple slaves having the same broadcast address to sync to the master (default: 127.0.0.1).
-udp-master Send a datagram to -udp-ip on -udp-port just before playing each frame.  The datagram indicates the master's position in the file.
-udp-port <port> Sets the destination port for datagrams sent by the -udp-master, and the port a -udp-slave listens on (default: 23867).
-udp-seek-threshold <sec> When the master seeks, the slave has to decide whether to seek as well, or to catch up by decoding frames without pausing between frames.  If the master is more than <sec> seconds away from the slave, the slave seeks.  Otherwise, it "runs" to catch up or waits for the master.  This should almost always be left at its default setting of 1 second.
-udp-slave Listen on -udp-port and match the master's position.
DEMUXER/STREAM OPTIONS -a52drc <level> Select the Dynamic Range Compression level for AC-3 audio streams. <level> is a float value ranging from 0 to 1, where 0 means no compression and 1 (which is the default) means full compression (make loud passages more silent and vice versa).  Values up to 2 are also accepted, but are purely experimental.  This option only shows an effect if the AC-3 stream contains the required range compression information.
-aid <ID> (also see -alang) Select audio channel (MPEG: 0-31, AVI/OGM: 1-99, ASF/RM: 0-127, VOB(AC-3): 128-159, VOB(LPCM): 160-191, MPEG-TS 17-8190).  MPlayer prints the available audio IDs when run in verbose (-v) mode. When playing an MPEG-TS stream, MPlayer/MEncoder will use the first program (if present) with the chosen audio stream.
-ausid <ID> (also see -alang) Select audio substream channel.  Currently the valid range is 0x55..0x75 and applies only to MPEG-TS when handled by the native demuxer (not by libavformat).  The format type may not be correctly identified because of how this information (or lack thereof) is embedded in the stream, but it will demux correctly the audio streams when multiple substreams are present.  MPlayer prints the available substream IDs when run with -identify.
-alang <language code[,language code,...]> (also see -aid) Specify a priority list of audio languages to use.  Different container formats employ different language codes.  DVDs use ISO 639-1 two letter language codes, Matroska, MPEG-TS and NUT use ISO 639-2 three letter language codes while OGM uses a free-form identifier.  MPlayer prints the available languages when run in verbose (-v) mode.