summaryrefslogtreecommitdiffstats
path: root/DOCS/tech/slave.txt
blob: 8dd0301fe2532e9ad3b30b5d528c841d40c809c5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
SLAVE MODE PROTOCOL
-------------------

FIXME: Some of these options are still not documented, patches welcome.

Most slave mode commands are equivalent to command line options.
Have a look at the man page for more detailed descriptions.

If the -slave option is given, playback is controlled by a line-based protocol.
Each line must contain one of the following commands:

seek <value> [<type>]
    Seek to some place in the movie.
        0 is a relative seek of +/- <value> seconds (default).
        1 is a seek to <value> % in the movie.
        2 is a seek to an absolute position of <value> seconds.

speed_set <value>
    Set the speed to <value>.

speed_incr <value>
    Add <value> to the current playback speed.

speed_mult <value>
    Multiply the current speed by <value>.

edl_mark
    ???

audio_delay <value>
    Adjust the audio delay by <value> seconds.

quit [<value>]
    Quit MPlayer. The optional integer value is used as the return code
    for the mplayer process (default: 0).

pause
    Pause/unpause the playback.

frame_step
    Play one frame, then pause again.

grab_frames
    ???

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.

alt_src_step <value> (ASX playlist only)
    When more than one source is available it selects the next/previous one.

sub_delay <value> [<abs>]
    Adjust the subtitle delay by +/- <value> seconds or set it to <value>
    seconds when <abs> is nonzero.

sub_step
    ???

osd [<level>]
    Toggle OSD mode or set it to level when <level> >= 0.

osd_show_text <value>
    ???

volume <value>
    Increase/decrease volume.

use_master
    Switch volume control between master and PCM.

mute
    Mute/unmute sound output.

[contrast|gamma|brightness|hue|saturation] <-100 - 100> [<abs>]
    Set/adjust video parameters.

frame_drop [<value>]
    Toggle/set frame dropping mode.

sub_pos <value>
    Adjust subtitle position.

sub_alignment <value>
    Set subtitle alignment.

sub_visibility
    Toggle subtitle visibility.

get_sub_visibility
    Print out subtitle visibility (1 == on, 0 == off).

sub_select
    Cycle through the available subtitles. Supported subtitle sources are
    -sub options on the command line, VOBsubs, DVD subtitles, and Ogg text
    streams.

vobsub_lang
    This is a stub linked to sub_select for backwards compatibility.

get_percent_pos
    Print out the current position in the file, as integer percentage [0-100).

get_time_length
    Print out the length of the current file in seconds.

vo_fullscreen
    Switch to fullscreen mode.

get_vo_fullscreen
    Print out fullscreen status (1 == fullscreened, 0 == windowed).

vo_ontop
    Toggle stay-on-top.

vo_rootwin
    Toggle playback on the root window.

switch_vsync [<value>]
    Toggle vsync (1 == on, 0 == off). If no value is provided,
    vsync status is inverted.

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.

panscan <value> [value2]
    ???

loadfile <file|url>
    Load the given file/URL.

loadlist <file>
    Load the given playlist file.

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.

dvdnav <button>
    Press the given dvdnav button.
        1 up
        2 down
        3 left
        4 right
        5 menu
        6 select

dvdnav_event <value>
    ???

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_set_norm <norm>
    Set the TV tuner norm (PAL, SECAM, NTSC, ...).

tv_set_brightness <-100 - 100>
    Set TV tuner brightness.

tv_set_contrast <-100 -100>
    Set TV tuner contrast.

tv_set_hue <-100 - 100>
    Set TV tuner hue.

tv_set_saturation <-100 - 100>
    Set TV tuner saturation.

gui_[loadfile|loadsubtitle|about|play|stop|gui_playlist|gui_preferences|skinbrowser]
    GUI actions

forced_subs_only
    Display forced subtitles only.

dvb_set_channel <channel_number> <card_number>
    Set DVB channel.

screenshot
    Take a screenshot.

menu <value>
    ???

set_menu <value>
    ???

help
    ???

exit
    ???

hide
    ???

run <value>
    ???

All commands can be prefixed with "pausing ", causing MPlayer to get into
paused mode as soon as possible after processing the command.
Please note that this can be before the command is fully executed.