4
The On Screen Controller (short: OSC) is a minimal GUI integrated with mpv to
5
offer basic mouse-controllability. It is intended to make interaction easier
6
for new users and to enable precise and direct seeking.
8
The OSC is enabled by default if mpv was compiled with lua support. It can be
9
disabled using ``--osc=no``.
14
By default, the OSC will show up whenever the mouse is moved inside the
15
player window and will hide if the mouse is not moved outside the OSC for
16
0.5 seconds or if the mouse leaves the window.
23
+------------------+-----------+--------------------+
24
| playlist prev | title | playlist next |
25
+-------+------+---+--+------+-+----+------+--------+
26
| audio | skip | seek | | seek | skip | full |
27
+-------+ back | back | play | frwd | frwd | screen |
29
+-------+------+------+------+------+------+--------+
31
+----------------+--------------+-------------------+
32
| time passed | cache status | time remaining |
33
+----------------+--------------+-------------------+
37
============= ================================================
38
left-click play previous file in playlist
39
shift+L-click show playlist
40
============= ================================================
43
| Displays current media-title or filename
45
============= ================================================
46
left-click show playlist position and length and full title
47
right-click show filename
48
============= ================================================
51
============= ================================================
52
left-click play next file in playlist
53
shift+L-click show playlist
54
============= ================================================
57
| Displays selected track and amount of available tracks
59
============= ================================================
60
left-click cycle audio/sub tracks forward
61
right-click cycle audio/sub tracks backwards
62
shift+L-click show available audio/sub tracks
63
============= ================================================
66
============= ================================================
67
left-click go to beginning of chapter / previous chapter
68
shift+L-click show chapters
69
============= ================================================
72
============= ================================================
73
left-click skip back 5 seconds
74
right-click skip back 30 seconds
75
shift-L-click skip back 1 frame
76
============= ================================================
79
============= ================================================
80
left-click toggle play/pause
81
============= ================================================
84
============= ================================================
85
left-click skip forward 10 seconds
86
right-click skip forward 60 seconds
87
shift-L-click skip forward 1 frame
88
============= ================================================
91
============= ================================================
92
left-click go to next chapter
93
shift+L-click show chapters
94
============= ================================================
97
============= ================================================
98
left-click toggle fullscreen
99
============= ================================================
102
| Indicates current playback position and position of chapters
104
============= ================================================
105
left-click seek to position
106
============= ================================================
109
| Shows current playback position timestamp
111
============= ================================================
112
left-click toggle displaying timecodes with milliseconds
113
============= ================================================
116
| Shows current cache fill status (only visible when below 48%)
119
| Shows remaining playback time timestamp
121
============= ================================================
122
left-click toggle between total and remaining time
123
============= ================================================
129
The OSC offers limited configuration through a config file ``plugin_osc.conf``
130
placed in mpv's user dir.
135
The config file must exactly follow the following syntax::
141
``#`` can only be used at the beginning of a line and there may be no
142
spaces around the ``=`` or anywhere else.
144
Configurable parameters
145
~~~~~~~~~~~~~~~~~~~~~~~
149
| Show OSC when windowed?
153
| Show OSC when fullscreen?
157
| Scaling of the controller when windowed
161
| Scaling of the controller when fullscreen
163
``scaleforcedwindow``
165
| Scaling of the controller when rendered on a forced (dummy) window
169
| Scale the controller with the video?
173
| Vertical alignment, -1 (top) to 1 (bottom)
177
| Horizontal alignment, -1 (left) to 1 (right)
181
| Duration in ms until the OSC hides if no mouse movement, negative value
186
| Duration of fade out in ms, 0 = no fade
190
| Size of the deadzone. The deadzone is an area that makes the mouse act
191
like leaving the window. Movement there won't make the OSC show up and
192
it will hide immediately if the mouse enters it.
196
| Minimum amount of pixels the mouse has to move between ticks to make