1
0
mirror of https://github.com/mpv-player/mpv synced 2024-12-25 16:33:02 +00:00
mpv/DOCS/OUTDATED-tech/slave.txt

593 lines
23 KiB
Plaintext
Raw Normal View History

SLAVE MODE PROTOCOL
-------------------
The -slave option 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.
To try slave mode out by hand, run
mplayer -slave -quiet <movie>
and type slave commands into the console window.
You can also use a fifo file (named pipe):
mkfifo </tmp/fifofile>
mplayer -slave -input file=</tmp/fifofile> <movie>
Most slave mode commands are equivalent to command line options, though not
necessarily under the same name. Detailed descriptions can be found in the
man page.
NOTE: the following paragraph is mostly obsolete; tricky pause handling
was required in old MPlayer versions where all commands unpaused by default.
Now running commands does not require leaving pause state any more, and
the prefixes described here should not be required in normal use.
All commands can be prefixed with one of "pausing ", "pausing_keep ", or
"pausing_toggle ". "pausing " tells MPlayer to pause as soon as possible
after processing the command. "pausing_keep " tells MPlayer to do so only if
it was already in paused mode. "pausing_toggle " tells MPlayer to do so
only if it was not already in paused mode. Please note that "as soon as
possible" can be before the command is fully executed.
As a temporary hack, there is also the _experimental_ "pausing_keep_force "
prefix, with which MPlayer will not exit the pause loop at all.
Like this you can avoid the "frame stepping" effect of "pausing_keep "
but most commands will either not work at all or behave in unexpected ways.
For "set_mouse_pos" and "key_down_event", "pausing_keep_force" is the default
since other values do not make much sense for them.
Various tips and tricks (please help expand it!):
- To ensure the user can't control MPlayer "behind your back" use
something like -input nodefault-bindings -noconfig all
Available commands ('mplayer -input cmdlist' will print a list):
af_add <filter_arguments_list> (comma separated list of audio filters with parameters)
(experimental) Load the given list of audio filters.
af_clr
(experimental) Unload all loaded audio filters.
af_cmdline <filter_name> <filter_arguments>
(experimental) Send new command-line options to a filter with the given name.
af_del <filter_name_list> (comma separated list of audio filter's names)
(experimental) Unload the first occurrence of the filters, if loaded.
af_switch <filter_arguments_list> (comma separated list of audio filters with parameters)
(experimental) Remove all the audio filters and replace them with the given list.
alt_src_step <value> (ASX playlist only)
When more than one source is available it selects the next/previous one.
audio_delay <value> [abs]
Set/adjust the audio delay.
If [abs] is not given or is zero, adjust the delay by <value> seconds.
If [abs] is nonzero, set the delay to <value> seconds.
[brightness|contrast|gamma|hue|saturation] <value> [abs]
Set/adjust video parameters.
If [abs] is not given or is zero, modifies parameter by <value>.
If [abs] is non-zero, parameter is set to <value>.
<value> is in the range [-100, 100].
capturing [value]
Toggle/set capturing the primary stream like -dumpstream.
Requires the -capture parameter to be given.
change_rectangle <val1> <val2>
Change the position of the rectangle filter rectangle.
<val1>
Must be one of the following:
0 = width
1 = height
2 = x position
3 = y position
<val2>
If <val1> is 0 or 1:
Integer amount to add/subtract from the width/height.
Positive values add to width/height and negative values
subtract from it.
If <val1> is 2 or 3:
Relative integer amount by which to move the upper left
rectangle corner. Positive values move the rectangle
right/down and negative values move the rectangle left/up.
dvb_set_channel <channel_number> <card_number>
Set DVB channel.
dvdnav <button_name>
Press the given dvdnav button.
up
down
left
right
menu
select
prev
mouse
edl_mark
Write the current position into the EDL file.
frame_drop [value]
Toggle/set frame dropping mode.
get_audio_bitrate
Print out the audio bitrate of the current file.
get_audio_codec
Print out the audio codec name of the current file.
get_audio_samples
Print out the audio frequency and number of channels of the current file.
get_file_name
Print out the name of the current file.
get_meta_album
Print out the 'Album' metadata of the current file.
get_meta_artist
Print out the 'Artist' metadata of the current file.
get_meta_comment
Print out the 'Comment' metadata of the current file.
get_meta_genre
Print out the 'Genre' metadata of the current file.
get_meta_title
Print out the 'Title' metadata of the current file.
get_meta_track
Print out the 'Track Number' metadata of the current file.
get_meta_year
Print out the 'Year' metadata of the current file.
get_percent_pos
Print out the current position in the file, as integer percentage [0-100).
get_property <property>
Print out the current value of a property.
get_sub_visibility
Print out subtitle visibility (1 == on, 0 == off).
get_time_length
Print out the length of the current file in seconds.
get_time_pos
Print out the current position in the file in seconds, as float.
get_vo_fullscreen
Print out fullscreen status (1 == fullscreened, 0 == windowed).
get_video_bitrate
Print out the video bitrate of the current file.
get_video_codec
Print out the video codec name of the current file.
get_video_resolution
Print out the video resolution of the current file.
screenshot <each_frame> <full_window>
Take a screenshot. Requires the screenshot filter to be loaded.
each_frame:
0 Take a single screenshot. (Default.)
1 Start/stop taking screenshot of each frame.
full_window:
0 Save the video image, in its original resolution. Typically without
OSD or subtitles. (Default.)
1 Save the contents of the mplayer window. Typically with OSD and
subtitles. If not available (no VO support), this may act as if 0 was
passed.
key_down_event <value>
Inject <value> key code event into MPlayer.
loadfile <file|url> <append>
Load the given file/URL, stopping playback of the current file/URL.
If <append> is nonzero playback continues and the file/URL is
appended to the current playlist instead.
loadlist <file> <append>
Load the given playlist file, stopping playback of the current file.
If <append> is nonzero playback continues and the playlist file is
appended to the current playlist instead.
loop <value> [abs]
Adjust/set how many times the movie should be looped. -1 means no loop,
and 0 forever.
mute [value]
Toggle sound output muting or set it to [value] when [value] >= 0
(1 == on, 0 == off).
osd [level]
Toggle OSD mode or set it to [level] when [level] >= 0.
osd_show_progression
Show the progression bar, the elapsed time and the total duration of the
movie on the OSD.
osd_show_property_text <string> [duration] [level]
Show an expanded property string on the OSD, see -playing-msg for a
description of the available expansions. If [duration] is >= 0 the text
is shown for [duration] ms. [level] sets the minimum OSD level needed
for the message to be visible (default: 0 - always show).
osd_show_text <string> [duration] [level]
Show <string> on the OSD.
panscan <-1.0 - 1.0> | <0.0 - 1.0> <abs>
Increase or decrease the pan-and-scan range by <value>, 1.0 is the maximum.
Negative values decrease the pan-and-scan range.
If <abs> is != 0, then the pan-and scan range is interpreted as an
absolute range.
pause
Pause/unpause the playback (use "set_property pause X" to set a particular
value regardless of whether the player is already paused or not).
frame_step
Play one frame, then pause again.
pt_step <value> [force]
Go to the next/previous entry in the playtree. The sign of <value> tells
the direction. If no entry is available in the given direction it will do
nothing unless [force] is non-zero.
pt_up_step <value> [force]
Similar to pt_step but jumps to the next/previous entry in the parent list.
Useful to break out of the inner loop in the playtree.
quit [value]
Quit MPlayer. The optional integer [value] is used as the return code
for the mplayer process (default: 0).
radio_set_channel <channel>
Switch to <channel>. The 'channels' radio parameter needs to be set.
radio_set_freq <frequency in MHz>
Set the radio tuner frequency.
radio_step_channel <-1|1>
Step forwards (1) or backwards (-1) in channel list. Works only when the
'channels' radio parameter was set.
radio_step_freq <value>
Tune frequency by the <value> (positive - up, negative - down).
run <value>
Run <value> as shell command.
seek <value> [type] [hr-seek]
Seek to some place in the movie.
type = 0 is a relative seek of +/- <value> seconds (default).
type = 1 is a seek to <value> % in the movie.
type = 2 is a seek to an absolute position of <value> seconds.
The hr-seek parameter controls whether to use precise seeks (not limited
to keyframe positions in video).
hr-seek = 0 means use default set with option -hr-seek (default).
hr-seek = 1 means force precise seek if possible.
hr-seek = -1 means force non-precise seek.
seek_chapter <value> [type]
Seek to the start of a chapter.
0 is a relative seek of +/- <value> chapters (default).
1 is a seek to chapter <value>.
switch_angle <value>
Switch to the angle with the ID [value]. Cycle through the
available angles if [value] is omitted or negative.
set_mouse_pos <x> <y>
Tells MPlayer the coordinates of the mouse in the window.
This command doesn't move the mouse!
set_property <property> <value>
Set a property.
set_property_osd <property> <value>
Same as above, but show the new value on the OSD in the standard
manner defined for that property (if any).
speed_incr <value>
Add <value> to the current playback speed.
speed_mult <value>
Multiply the current speed by <value>.
speed_set <value>
Set the speed to <value>.
step_property <property> [value] [direction]
Change a property by value, or increase by a default if value is
not given or zero. The direction is reversed if direction is less
than zero.
step_property_osd <property> [value] [direction]
Same as above, but show the new value on the OSD in the standard
manner defined for that property (if any).
stop
Stop playback.
sub_alignment [value]
Toggle/set subtitle alignment.
0 top alignment
1 center alignment
2 bottom alignment
sub_delay <value> [abs]
Adjust the subtitle delay by +/- <value> seconds or set it to <value>
seconds when [abs] is nonzero.
sub_load <subtitle_file>
Loads subtitles from <subtitle_file>.
sub_log
Logs the current or last displayed subtitle together with filename
and time information to ~/.mplayer/subtitle_log. Intended purpose
is to allow convenient marking of bogus subtitles which need to be
fixed while watching the movie.
sub_pos <value> [abs]
Adjust/set subtitle position.
sub_remove [value]
If the [value] argument is present and non-negative, removes the subtitle
file with index [value]. If the argument is omitted or negative, removes
all subtitle files.
sub_select [value]
Display subtitle with index [value]. Turn subtitle display off if
[value] is -1 or greater than the highest available subtitle index.
Cycle through the available subtitles if [value] is omitted or less
than -1 (forward or backward respectively).
Supported subtitle sources are -sub options on the command
line, VOBsubs, DVD subtitles, and Ogg and Matroska text streams.
This command is mainly for cycling all subtitles, if you want to set
a specific subtitle, use sub_file, sub_vob, or sub_demux.
sub_source [source]
Display first subtitle from [source]. Here [source] is an integer:
SUB_SOURCE_SUBS (0) for file subs
SUB_SOURCE_VOBSUB (1) for VOBsub files
SUB_SOURCE_DEMUX (2) for subtitle embedded in the media file or DVD subs.
If [source] is -1, will turn off subtitle display.
If [value] is omitted or less than -1, will cycle between the first subtitle
of each currently available source (forward or backward respectively).
sub_file [value]
Display subtitle specifid by [value] for file subs. The [value] is
corresponding to ID_FILE_SUB_ID values reported by '-identify'.
If [value] is -1, will turn off subtitle display.
If [value] is omitted or less than -1, will cycle all file subs
(forward or backward respectively).
sub_vob [value]
Display subtitle specifid by [value] for vobsubs. The [value] is
corresponding to ID_VOBSUB_ID values reported by '-identify'.
If [value] is -1, will turn off subtitle display.
If [value] is omitted or less than -1, will cycle all vobsubs
(forward or backward respectively).
sub_demux [value]
Display subtitle specifid by [value] for subtitles from DVD or embedded
in media file. The [value] is corresponding to ID_SUBTITLE_ID values
reported by '-identify'. If [value] is -1, will turn off subtitle display.
If [value] is omitted or less than -1, will cycle all DVD subs or embedded subs
(forward or backward respectively).
sub_scale <value> [abs]
Adjust the subtitle size by +/- <value> or set it to <value> when [abs]
is nonzero.
vobsub_lang
This is a stub linked to sub_select for backwards compatibility.
sub_step <value>
Step forward in the subtitle list by <value> steps or backwards if <value>
is negative.
sub_visibility [value]
Toggle/set subtitle visibility.
forced_subs_only [value]
Toggle/set forced subtitles only.
switch_audio [value] (currently MPEG*, AVI, Matroska and streams handled by libavformat)
Switch to the audio track with the ID [value]. Cycle through the
available tracks if [value] is omitted or negative.
switch_angle [value] (DVDs only)
Switch to the DVD angle with the ID [value]. Cycle through the
available angles if [value] is omitted or negative.
switch_ratio [value]
Change aspect ratio at runtime. [value] is the new aspect ratio expressed
as a float (e.g. 1.77778 for 16/9).
There might be problems with some video filters.
switch_title [value] (DVDNAV only)
Switch to the DVD title with the ID [value]. Cycle through the
available titles if [value] is omitted or negative.
switch_vsync [value]
Toggle vsync (1 == on, 0 == off). If [value] is not provided,
vsync status is inverted.
teletext_add_digit <value>
Enter/leave teletext page number editing mode and append given digit to
previously entered one.
0..9 - Append apropriate digit. (Enables editing mode if called from normal
mode, and switches to normal mode when third digit is entered.)
- - Delete last digit from page number. (Backspace emulation, works only
in page number editing mode.)
teletext_go_link <1-6>
Follow given link on current teletext page.
tv_start_scan
Start automatic TV channel scanning.
tv_step_channel <channel>
Select next/previous TV channel.
tv_step_norm
Change TV norm.
tv_step_chanlist
Change channel list.
tv_set_channel <channel>
Set the current TV channel.
tv_last_channel
Set the current TV channel to the last one.
tv_set_freq <frequency in MHz>
Set the TV tuner frequency.
tv_step_freq <frequency offset in MHz>
Set the TV tuner frequency relative to current value.
tv_set_norm <norm>
Set the TV tuner norm (PAL, SECAM, NTSC, ...).
tv_set_brightness <-100 - 100> [abs]
Set TV tuner brightness or adjust it if [abs] is set to 0.
tv_set_contrast <-100 -100> [abs]
Set TV tuner contrast or adjust it if [abs] is set to 0.
tv_set_hue <-100 - 100> [abs]
Set TV tuner hue or adjust it if [abs] is set to 0.
tv_set_saturation <-100 - 100> [abs]
Set TV tuner saturation or adjust it if [abs] is set to 0.
use_master
Switch volume control between master and PCM.
vo_border [value]
Toggle/set borderless display.
vo_fullscreen [value]
Toggle/set fullscreen mode.
vo_ontop [value]
Toggle/set stay-on-top.
vo_rootwin [value]
Toggle/set playback on the root window.
volume <value> [abs]
Increase/decrease volume or set it to <value> if [abs] is nonzero.
show_chapters_osd
Show the list of chapters in the currently played file on the OSD.
show_tracks_osd
Show the list audio and subtitle tracks in the currently played file on the OSD.
Available properties:
name type min max get set step comment
=================================================================
osdlevel int 0 3 X X X as -osdlevel
speed float 0.01 100 X X X as -speed
loop int -1 X X X as -loop
hr_seek string X X X as -hr-seek
pts_association_mode string X X X as -pts-association-mode
pause flag 0 1 X 1 if paused
filename string X file playing wo path
path string X file playing
demuxer string X demuxer used
stream_pos pos 0 X X position in stream
stream_start pos 0 X start pos in stream
stream_end pos 0 X end pos in stream
stream_length pos 0 X (end - start)
stream_time_pos time 0 X present position in stream (in seconds)
titles int X number of titles
chapter int 0 X X X select chapter
chapters int X number of chapters
angle int 0 X X X select angle
length time X length of file in seconds
percent_pos int 0 100 X X X position in percent
time_pos time 0 X X X position in seconds
metadata str list X list of metadata key/value
metadata/* string X metadata values
volume float 0 100 X X X change volume
balance float -1 1 X X X change audio balance
mute flag 0 1 X X X
audio_delay float -100 100 X X X
audio_format int X
audio_codec string X
audio_bitrate int X
samplerate int X
channels int X
switch_audio int -2 255 X X X select audio stream
switch_angle int -2 255 X X X select DVD angle
switch_title int -2 255 X X X select DVD title
capturing flag 0 1 X X X dump primary stream if enabled
fullscreen flag 0 1 X X X
deinterlace flag 0 1 X X X
ontop flag 0 1 X X X
rootwin flag 0 1 X X X
border flag 0 1 X X X
framedropping int 0 2 X X X 1 = soft, 2 = hard
gamma int -100 100 X X X
brightness int -100 100 X X X
contrast int -100 100 X X X
saturation int -100 100 X X X
hue int -100 100 X X X
panscan float 0 1 X X X
vsync flag 0 1 X X X
video, options: implement better YUV->RGB conversion control Rewrite control of the colorspace and input/output level parameters used in YUV-RGB conversions, replacing VO-specific suboptions with new common options and adding configuration support to more cases. Add new option --colormatrix which selects the colorspace the original video is assumed to have in YUV->RGB conversions. The default behavior changes from assuming BT.601 to colorspace autoselection between BT.601 and BT.709 using a simple heuristic based on video size. Add new options --colormatrix-input-range and --colormatrix-output-range which select input YUV and output RGB range. Disable the previously existing VO-specific colorspace and level conversion suboptions in vo_gl and vo_vdpau. Remove the "yuv_colorspace" property and replace it with one named "colormatrix" and semantics matching the new option. Add new properties matching the options for level conversion. Colorspace selection is currently supported by vo_gl, vo_vdpau, vo_xv and vf_scale, and all can change it at runtime (previously only vo_vdpau and vo_xv could). vo_vdpau now uses the same conversion matrix generation as vo_gl instead of libvdpau functionality; the main functional difference is that the "contrast" equalizer control behaves somewhat differently (it scales the Y component around 1/2 instead of around 0, so that contrast 0 makes the image gray rather than black). vo_xv does not support level conversion. vf_scale supports range setting for input, but always outputs full-range RGB. The value of the slave properties is the policy setting used for conversions. This means they can be set to any value regardless of whether the current VO supports that value or whether there currently even is any video. Possibly separate properties could be added to query the conversion actually used at the moment, if any. Because the colorspace and level settings are now set with a single VF/VO control call, the return value of that is no longer used to signal whether all the settings are actually supported. Instead code should set all the details it can support, and ignore the rest. The core will use GET_YUV_COLORSPACE to check which colorspace details have been set and which not. In other words, the return value for SET_YUV_COLORSPACE only signals whether any kind of YUV colorspace conversion handling exists at all, and VOs have to take care to return the actual state with GET_YUV_COLORSPACE instead. To be changed in later commits: add missing option documentation.
2011-10-15 21:50:21 +00:00
colormatrix choice X X X as --colormatrix
colormatrix_input_range choice X X X as --colormatrix-input-range
colormatrix_output_range choice X X X as --colormatrix-output-range
video_format int X
video_codec string X
video_bitrate int X
width int X "display" width
height int X "display" height
fps float X
aspect float X
switch_video int -2 255 X X X select video stream
switch_program int -1 65535 X X X (see TAB default keybind)
sub int -1 X X X select subtitle stream
sub_source int -1 2 X X X select subtitle source
sub_file int -1 X X X select file subtitles
sub_vob int -1 X X X select vobsubs
sub_demux int -1 X X X select subs from demux
sub_delay float X X X
sub_pos int 0 100 X X X subtitle position
sub_alignment int 0 2 X X X subtitle alignment
sub_visibility flag 0 1 X X X show/hide subtitles
sub_forced_only flag 0 1 X X X
sub_scale float 0 100 X X X subtitles font size
ass_vsfilter_aspect_compat flag 0 1 X X X SSA/ASS aspect ratio correction
tv_brightness int -100 100 X X X
tv_contrast int -100 100 X X X
tv_saturation int -100 100 X X X
tv_hue int -100 100 X X X
teletext_page int 0 799 X X X
teletext_subpage int 0 64 X X X
teletext_mode flag 0 1 X X X 0 - off, 1 - on
teletext_format int 0 3 X X X 0 - opaque,
1 - transparent,
2 - opaque inverted,
3 - transp. inv.
teletext_half_page int 0 2 X X X 0 - off, 1 - top half,
2- bottom half