diff --git a/manual/master/index.html b/manual/master/index.html index 5f49373..ff27061 100644 --- a/manual/master/index.html +++ b/manual/master/index.html @@ -4185,7 +4185,7 @@
Default: 55.
+Default: 38
Size of the sub font outline in scaled pixels (see --sub-font-size for details). A value of 0 disables outlines.
--sub-border-size is an alias for --sub-outline-size.
-Default: 3.
+Default: 1.65
The style of the border.
@@ -4266,14 +4266,14 @@This option specifies the distance of the sub to the left, as well as at which distance from the right border long sub text will be broken.
-Default: 25.
+Default: 19
Top and bottom screen margin for the subs in scaled pixels (see --sub-font-size for details).
This option specifies the vertical margins of unstyled text subtitles. If you just want to raise the vertical subtitle position, use --sub-pos.
-Default: 22.
+Default: 34
Control to which corner of the screen text subtitles should be @@ -5615,7 +5615,7 @@
Specify the OSD font size. See --sub-font-size for details.
-Default: 55.
+Default: 30
Size of the OSD font outline in scaled pixels (see --sub-font-size for details). A value of 0 disables outlines.
--osd-border-size is an alias for --osd-outline-size.
-Default: 3.
+Default: 1.65
This option specifies the distance of the OSD to the left, as well as at which distance from the right border long OSD text will be broken.
-Default: 25.
+Default: 15
Top and bottom screen margin for the OSD in scaled pixels (see --sub-font-size for details).
This option specifies the vertical margins of the OSD.
-Default: 22.
+Default: 15
Set the list of tags that should be displayed on the terminal and stats. -Tags that are in the list, but are not present in the played file, will not -be shown. If a value ends with *, all tags are matched by prefix (though -there is no general globbing). Just passing * essentially filtering.
-The default includes a common list of tags, call mpv with --list-options -to see it.
-This is a string list option. See List Options for details.
-Set the list of tags that should be displayed on the terminal and stats. +Tags that are in the list, but are not present in the played file, will not +be shown. If a value ends with *, all tags are matched by prefix (though +there is no general globbing). Just passing * essentially filtering.
+The default includes a common list of tags, call mpv with --list-options +to see it.
+This is a string list option. See List Options for details.
+Remember to quote string arguments in input.conf (see Flat command syntax).
+Change the playback position. By default, seeks by a relative amount of seconds.
@@ -11312,6 +11315,24 @@Using it without any arguments gives you the default behavior.
+Change video and audio position such that the subtitle event after +<skip> subtitle events is displayed. For example, sub-seek 1 skips +to the next subtitle, sub-seek -1 skips to the previous subtitles, and +sub-seek 0 seeks to the beginning of the current subtitle.
+This is similar to sub-step, except that it seeks video and audio +instead of adjusting the subtitle delay.
+Secondary argument:
+For embedded subtitles (like with Matroska), this works only with subtitle +events that have already been displayed, or are within a short prefetch +range. See Cache for details on how to control the available prefetch range.
+This does not work with audio-only playback.
+Stop playback and clear playlist. With default settings, this is +essentially like quit. Useful for the client API: playback can be +stopped without terminating the player.
+The first argument is optional, and supports the following flags:
+Cycle the given property or option. The second argument can be up or down to set the cycle direction. On overflow, set the property back to @@ -11341,50 +11380,37 @@
Take a screenshot.
-Multiple flags are available (some can be combined with +):
-Older mpv versions required passing single and each-frame as -second argument (and did not have flags). This syntax is still understood, -but deprecated and might be removed in the future.
-If you combine this command with another one using ;, you can use the -async flag to make encoding/writing the image file asynchronous. For -normal standalone commands, this is always asynchronous, and the flag has -no effect. (This behavior changed with mpv 0.29.0.)
-On success, returns a mpv_node with a filename field set to the -saved screenshot location.
+Cycle through a list of values. Each invocation of the command will set the +given property to the next value in the list. The command will use the +current value of the property/option, and use it to determine the current +position in the list of values. Once it has found it, it will set the +next value in the list (wrapping around to the first item if needed).
+This command has a variable number of arguments, and cannot be used with +named arguments.
+The special argument !reverse can be used to cycle the value list in +reverse. The only advantage is that you don't need to reverse the value +list yourself when adding a second key binding for cycling backwards.
Take a screenshot and save it to a given file. The format of the file will -be guessed by the extension (and --screenshot-format is ignored - the -behavior when the extension is missing or unknown is arbitrary).
-The second argument is like the first argument to screenshot and -supports subtitles, video, window.
-If the file already exists, it's overwritten.
-Like all input command parameters, the filename is subject to property -expansion as described in Property Expansion.
+This command changes list options as described in List Options. The +<name> parameter is the normal option name, while <operation> is +the suffix or action used on the option.
+Some operations take no value, but the command still requires the value +parameter. In these cases, the value must be an empty string.
+Example
+change-list glsl-shaders append file.glsl
+Add a filename to the glsl-shaders list. The command line +equivalent is --glsl-shaders-append=file.glsl or alternatively +--glsl-shader=file.glsl.
+Go to the next entry on the playlist.
First argument:
@@ -11535,229 +11561,91 @@Run the given command. Unlike in MPlayer/mplayer2 and earlier versions of -mpv (0.2.x and older), this doesn't call the shell. Instead, the command -is run directly, with each argument passed separately. Each argument is -expanded like in Property Expansion.
-This command has a variable number of arguments, and cannot be used with -named arguments.
-The program is run in a detached way. mpv doesn't wait until the command -is completed, but continues playback right after spawning it.
-To get the old behavior, use /bin/sh and -c as the first two -arguments.
-Example
-run "/bin/sh" "-c" "echo ${title} > /tmp/playing"
-This is not a particularly good example, because it doesn't handle -escaping, and a specially prepared file might allow an attacker to -execute arbitrary shell commands. It is recommended to write a small -shell script, and call that with run.
+Similar to run, but gives more control about process execution to the -caller, and does not detach the process.
-You can avoid blocking until the process terminates by running this command -asynchronously. (For example mp.command_native_async() in Lua scripting.)
-This has the following named arguments. The order of them is not guaranteed, -so you should always call them with named arguments, see Named arguments.
+Array of strings with the command as first argument, and subsequent -command line arguments following. This is just like the run command -argument list.
-The first array entry is either an absolute path to the executable, or -a filename with no path components, in which case the executable is -searched in the directories in the PATH environment variable. On -Unix, this is equivalent to posix_spawnp and execvp behavior.
+Load the given subtitle file or stream. By default, it is selected as +current subtitle after loading.
+The flags argument is one of the following values:
+<select>
++Select the subtitle immediately (default).+
<auto>
++Don't select the subtitle. (Or in some special situations, let the +default stream selection mechanism decide.)+
<cached>
++Select the subtitle. If a subtitle with the same filename was already +added, that one is selected, instead of loading a duplicate entry. +(In this case, title/language are ignored, and if the was changed since +it was loaded, these changes won't be reflected.)+
The title argument sets the track title in the UI.
+The lang argument sets the track language, and can also influence +stream selection with flags set to auto.
Set a list of environment variables for the new process (default: empty). -If an empty list is passed, the environment of the mpv process is used -instead. (Unlike the underlying OS mechanisms, the mpv command cannot -start a process with empty environment. Fortunately, that is completely -useless.) The format of the list is as in the execle() syscall. Each -string item defines an environment variable as in NAME=VALUE.
-On Lua, you may use utils.get_env_list() to retrieve the current -environment if you e.g. simply want to add a new variable.
+Reload the given subtitle tracks. If the id argument is missing, reload +the current track. (Works on external subtitle files only.)
+This works by unloading and re-adding the subtitle track.
Change subtitle timing such, that the subtitle event after the next +<skip> subtitle events is displayed. <skip> can be negative to step +backwards.
+Secondary argument:
+The command returns the following result (as MPV_FORMAT_NODE_MAP):
-Typically this is the process exit code (0 or positive) if the process -terminates normally, or negative for other errors (failed to start, -terminated by mpv, and others). The meaning of negative values is -undefined, other than meaning error (and does not correspond to OS low -level exit status values).
-On Windows, it can happen that a negative return value is returned even -if the process terminates normally, because the win32 UINT exit -code is assigned to an int variable before being set as int64_t -field in the result map. This might be fixed later.
Empty string if the process terminated normally. The string killed -if the process was terminated in an unusual way. The string init if -the process could not be started.
-On Windows, killed is only returned when the process has been -killed by mpv as a result of playback_only being set to true.
-Load the given video file. See sub-add command for common options.
+Note that the command itself will always return success as long as the -parameters are correct. Whether the process could be spawned or whether -it was somehow killed or returned an error status has to be queried from -the result value.
-This command can be asynchronously aborted via API. Also see Asynchronous -command details. Only the run command can start processes in a truly -detached way.
-Note
-The subprocess will always be terminated on player exit if it -wasn't started in detached mode, even if playback_only is -false.
-Warning
-Don't forget to set the playback_only field to false if you want -the command to run while the player is in idle mode, or if you don't -want the end of playback to kill the command.
-Example
--local r = mp.command_native({ - name = "subprocess", - playback_only = false, - capture_stdout = true, - args = {"cat", "/proc/cpuinfo"}, -}) -if r.status == 0 then - print("result: " .. r.stdout) -end --
This is a fairly useless Lua example, which demonstrates how to run -a process in a blocking manner, and retrieving its stdout output.
-Load the given subtitle file or stream. By default, it is selected as -current subtitle after loading.
-The flags argument is one of the following values:
-<select>
--Select the subtitle immediately (default).-
<auto>
--Don't select the subtitle. (Or in some special situations, let the -default stream selection mechanism decide.)-
<cached>
--Select the subtitle. If a subtitle with the same filename was already -added, that one is selected, instead of loading a duplicate entry. -(In this case, title/language are ignored, and if the was changed since -it was loaded, these changes won't be reflected.)-
The title argument sets the track title in the UI.
-The lang argument sets the track language, and can also influence -stream selection with flags set to auto.
Reload the given subtitle tracks. If the id argument is missing, reload -the current track. (Works on external subtitle files only.)
-This works by unloading and re-adding the subtitle track.
-Change subtitle timing such, that the subtitle event after the next -<skip> subtitle events is displayed. <skip> can be negative to step -backwards.
-Secondary argument:
+Rescan external files according to the current --sub-auto, +--audio-file-auto and --cover-art-auto settings. This can be used +to auto-load external files after the file was loaded.
+The mode argument is one of the following:
Change video and audio position such that the subtitle event after -<skip> subtitle events is displayed. For example, sub-seek 1 skips -to the next subtitle, sub-seek -1 skips to the previous subtitles, and -sub-seek 0 seeks to the beginning of the current subtitle.
-This is similar to sub-step, except that it seeks video and audio -instead of adjusting the subtitle delay.
-Secondary argument:
-For embedded subtitles (like with Matroska), this works only with subtitle -events that have already been displayed, or are within a short prefetch -range. See Cache for details on how to control the available prefetch range.
-Show text on the OSD. The string can contain properties, which are expanded -as described in Property Expansion. This can be used to show playback -time, filename, and so on. no-osd has no effect on this command.
-This line of Lua prints "foo \{bar}" on the OSD.
Stop playback and clear playlist. With default settings, this is -essentially like quit. Useful for the client API: playback can be -stopped without terminating the player.
-The first argument is optional, and supports the following flags:
-Send a mouse event with given coordinate (<x>, <y>).
-Second argument:
-Third argument:
-Load the given video file. See sub-add command for common options.
-Rescan external files according to the current --sub-auto, ---audio-file-auto and --cover-art-auto settings. This can be used -to auto-load external files after the file was loaded.
-The mode argument is one of the following:
-Change video filter chain.
-The semantics are exactly the same as with option parsing (see -VIDEO FILTERS). As such the text below is a redundant and incomplete -summary.
-The first argument decides what happens:
-Check if the given filter (with the exact parameters) is already in the -video chain. If it is, remove the filter. If it isn't, add the filter. -(If several filters are passed to the command, this is done for -each filter.)
-A special variant is combining this with labels, and using @name -without filter name and parameters as filter entry. This toggles the -enable/disable flag.
-The argument is always needed. E.g. in case of clr use vf clr "".
-You can assign labels to filter by prefixing them with @name: (where -name is a user-chosen arbitrary identifier). Labels can be used to -refer to filters by name in all of the filter chain modification commands. -For add, using an already used label will replace the existing filter.
-The vf command shows the list of requested filters on the OSD after -changing the filter chain. This is roughly equivalent to -show-text ${vf}. Note that auto-inserted filters for format conversion -are not shown on the list, only what was requested by the user.
-Normally, the commands will check whether the video chain is recreated -successfully, and will undo the operation on failure. If the command is run -before video is configured (can happen if the command is run immediately -after opening a file and before a video frame is decoded), this check can't -be run. Then it can happen that creating the video chain fails.
-Example for input.conf
-Example how to toggle disabled filters at runtime
-Cycle through a list of values. Each invocation of the command will set the -given property to the next value in the list. The command will use the -current value of the property/option, and use it to determine the current -position in the list of values. Once it has found it, it will set the -next value in the list (wrapping around to the first item if needed).
-This command has a variable number of arguments, and cannot be used with -named arguments.
-The special argument !reverse can be used to cycle the value list in -reverse. The only advantage is that you don't need to reverse the value -list yourself when adding a second key binding for cycling backwards.
-This command is deprecated, except for mpv-internal uses.
-Enable all key bindings in the named input section.
-The enabled input sections form a stack. Bindings in sections on the top of -the stack are preferred to lower sections. This command puts the section -on top of the stack. If the section was already on the stack, it is -implicitly removed beforehand. (A section cannot be on the stack more than -once.)
-The flags parameter can be a combination (separated by +) of the -following flags:
+Apply the contents of a named profile. This is like using profile=name +in a config file, except you can map it to a key binding to change it at +runtime.
+The mode argument:
This command is deprecated, except for mpv-internal uses.
-Disable the named input section. Undoes enable-section.
+This command is deprecated, except for mpv-internal uses.
-Create a named input section, or replace the contents of an already existing -input section. The contents parameter uses the same syntax as the -input.conf file (except that using the section syntax in it is not -allowed), including the need to separate bindings with a newline character.
-If the contents parameter is an empty string, the section is removed.
-The section with the name default is the normal input section.
-In general, input sections have to be enabled with the enable-section -command, or they are ignored.
-The last parameter has the following meaning:
+Show text on the OSD. The string can contain properties, which are expanded +as described in Property Expansion. This can be used to show playback +time, filename, and so on. no-osd has no effect on this command.
+This command can be used to dispatch arbitrary keys to a script or a client -API user. If the input section defines script-binding commands, it is -also possible to get separate events on key up/down, and relatively detailed -information about the key state. The special key name unmapped can be -used to match any unmapped key.
Add an OSD overlay sourced from raw data. This might be useful for scripts and applications controlling mpv, and which want to display things on top @@ -12171,13 +11892,270 @@
This feature is experimental, and may change in some way again.
Note
+Always use named arguments (mpv_command_node()). Lua scripts should +use the mp.create_osd_overlay() helper instead of invoking this +command directly.
+Send a mouse event with given coordinate (<x>, <y>).
+Second argument:
+Third argument:
+This command is deprecated, except for mpv-internal uses.
+Enable all key bindings in the named input section.
+The enabled input sections form a stack. Bindings in sections on the top of +the stack are preferred to lower sections. This command puts the section +on top of the stack. If the section was already on the stack, it is +implicitly removed beforehand. (A section cannot be on the stack more than +once.)
+The flags parameter can be a combination (separated by +) of the +following flags:
+This command is deprecated, except for mpv-internal uses.
+Disable the named input section. Undoes enable-section.
+This command is deprecated, except for mpv-internal uses.
+Create a named input section, or replace the contents of an already existing +input section. The contents parameter uses the same syntax as the +input.conf file (except that using the section syntax in it is not +allowed), including the need to separate bindings with a newline character.
+If the contents parameter is an empty string, the section is removed.
+The section with the name default is the normal input section.
+In general, input sections have to be enabled with the enable-section +command, or they are ignored.
+The last parameter has the following meaning:
+This command can be used to dispatch arbitrary keys to a script or a client +API user. If the input section defines script-binding commands, it is +also possible to get separate events on key up/down, and relatively detailed +information about the key state. The special key name unmapped can be +used to match any unmapped key.
+Run the given command. Unlike in MPlayer/mplayer2 and earlier versions of +mpv (0.2.x and older), this doesn't call the shell. Instead, the command +is run directly, with each argument passed separately. Each argument is +expanded like in Property Expansion.
+This command has a variable number of arguments, and cannot be used with +named arguments.
+The program is run in a detached way. mpv doesn't wait until the command +is completed, but continues playback right after spawning it.
+To get the old behavior, use /bin/sh and -c as the first two +arguments.
+Example
+run "/bin/sh" "-c" "echo ${title} > /tmp/playing"
+This is not a particularly good example, because it doesn't handle +escaping, and a specially prepared file might allow an attacker to +execute arbitrary shell commands. It is recommended to write a small +shell script, and call that with run.
+Similar to run, but gives more control about process execution to the +caller, and does not detach the process.
+You can avoid blocking until the process terminates by running this command +asynchronously. (For example mp.command_native_async() in Lua scripting.)
+This has the following named arguments. The order of them is not guaranteed, +so you should always call them with named arguments, see Named arguments.
+Array of strings with the command as first argument, and subsequent +command line arguments following. This is just like the run command +argument list.
+The first array entry is either an absolute path to the executable, or +a filename with no path components, in which case the executable is +searched in the directories in the PATH environment variable. On +Unix, this is equivalent to posix_spawnp and execvp behavior.
+Set a list of environment variables for the new process (default: empty). +If an empty list is passed, the environment of the mpv process is used +instead. (Unlike the underlying OS mechanisms, the mpv command cannot +start a process with empty environment. Fortunately, that is completely +useless.) The format of the list is as in the execle() syscall. Each +string item defines an environment variable as in NAME=VALUE.
+On Lua, you may use utils.get_env_list() to retrieve the current +environment if you e.g. simply want to add a new variable.
+The command returns the following result (as MPV_FORMAT_NODE_MAP):
+Typically this is the process exit code (0 or positive) if the process +terminates normally, or negative for other errors (failed to start, +terminated by mpv, and others). The meaning of negative values is +undefined, other than meaning error (and does not correspond to OS low +level exit status values).
+On Windows, it can happen that a negative return value is returned even +if the process terminates normally, because the win32 UINT exit +code is assigned to an int variable before being set as int64_t +field in the result map. This might be fixed later.
+Empty string if the process terminated normally. The string killed +if the process was terminated in an unusual way. The string init if +the process could not be started.
+On Windows, killed is only returned when the process has been +killed by mpv as a result of playback_only being set to true.
+Note that the command itself will always return success as long as the +parameters are correct. Whether the process could be spawned or whether +it was somehow killed or returned an error status has to be queried from +the result value.
+This command can be asynchronously aborted via API. Also see Asynchronous +command details. Only the run command can start processes in a truly +detached way.
+Note
-Always use named arguments (mpv_command_node()). Lua scripts should -use the mp.create_osd_overlay() helper instead of invoking this -command directly.
+The subprocess will always be terminated on player exit if it +wasn't started in detached mode, even if playback_only is +false.
+Warning
+Don't forget to set the playback_only field to false if you want +the command to run while the player is in idle mode, or if you don't +want the end of playback to kill the command.
+Example
++local r = mp.command_native({ + name = "subprocess", + playback_only = false, + capture_stdout = true, + args = {"cat", "/proc/cpuinfo"}, +}) +if r.status == 0 then + print("result: " .. r.stdout) +end ++
This is a fairly useless Lua example, which demonstrates how to run +a process in a blocking manner, and retrieving its stdout output.
Send a message to all clients, and pass it the following list of arguments. What this message means, how many arguments it takes, and what the arguments @@ -12229,14 +12207,60 @@
Future versions can add more arguments and more key state characters to support more input peculiarities.
Load a script, similar to the --script option. Whether this waits for +the script to finish initialization or not changed multiple times, and the +future behavior is left undefined.
+On success, returns a mpv_node with a client_id field set to the +return value of the mpv_client_id() API call of the newly created script +handle.
+Take a screenshot.
+Multiple flags are available (some can be combined with +):
+Older mpv versions required passing single and each-frame as +second argument (and did not have flags). This syntax is still understood, +but deprecated and might be removed in the future.
+If you combine this command with another one using ;, you can use the +async flag to make encoding/writing the image file asynchronous. For +normal standalone commands, this is always asynchronous, and the flag has +no effect. (This behavior changed with mpv 0.29.0.)
+On success, returns a mpv_node with a filename field set to the +saved screenshot location.
+Take a screenshot and save it to a given file. The format of the file will +be guessed by the extension (and --screenshot-format is ignored - the +behavior when the extension is missing or unknown is arbitrary).
+The second argument is like the first argument to screenshot and +supports subtitles, video, window.
+If the file already exists, it's overwritten.
+Like all input command parameters, the filename is subject to property +expansion as described in Property Expansion.
+Return a screenshot in memory. This can be used only through the client API. The MPV_FORMAT_NODE_MAP returned by this command has the w, h, @@ -12254,6 +12278,75 @@
The flags argument is like the first argument to screenshot and supports subtitles, video, window.
Change video filter chain.
+The semantics are exactly the same as with option parsing (see +VIDEO FILTERS). As such the text below is a redundant and incomplete +summary.
+The first argument decides what happens:
+Check if the given filter (with the exact parameters) is already in the +video chain. If it is, remove the filter. If it isn't, add the filter. +(If several filters are passed to the command, this is done for +each filter.)
+A special variant is combining this with labels, and using @name +without filter name and parameters as filter entry. This toggles the +enable/disable flag.
+The argument is always needed. E.g. in case of clr use vf clr "".
+You can assign labels to filter by prefixing them with @name: (where +name is a user-chosen arbitrary identifier). Labels can be used to +refer to filters by name in all of the filter chain modification commands. +For add, using an already used label will replace the existing filter.
+The vf command shows the list of requested filters on the OSD after +changing the filter chain. This is roughly equivalent to +show-text ${vf}. Note that auto-inserted filters for format conversion +are not shown on the list, only what was requested by the user.
+Normally, the commands will check whether the video chain is recreated +successfully, and will undo the operation on failure. If the command is run +before video is configured (can happen if the command is run immediately +after opening a file and before a video frame is decoded), this check can't +be run. Then it can happen that creating the video chain fails.
+Example for input.conf
+Example how to toggle disabled filters at runtime
+Send a command to the filter. Note that currently, this only works with the lavfi filter. Refer to the libavfilter documentation for the list @@ -12267,51 +12360,19 @@
Apply the contents of a named profile. This is like using profile=name -in a config file, except you can map it to a key binding to change it at -runtime.
-The mode argument:
-Load a script, similar to the --script option. Whether this waits for -the script to finish initialization or not changed multiple times, and the -future behavior is left undefined.
-On success, returns a mpv_node with a client_id field set to the -return value of the mpv_client_id() API call of the newly created script -handle.
-This command changes list options as described in List Options. The -<name> parameter is the normal option name, while <operation> is -the suffix or action used on the option.
-Some operations take no value, but the command still requires the value -parameter. In these cases, the value must be an empty string.
-Example
-change-list glsl-shaders append file.glsl
-Add a filename to the glsl-shaders list. The command line -equivalent is --glsl-shaders-append=file.glsl or alternatively ---glsl-shader=file.glsl.
Dump the current cache to the given filename. The <filename> file is overwritten if it already exists. <start> and <end> give the @@ -12353,6 +12414,10 @@
This command is experimental, and all details about it may change in the future.
Essentially calls dump-cache with the current AB-loop points as arguments. Like dump-cache, this will overwrite the file at @@ -12376,10 +12441,14 @@
Undocumented commands: ao-reload (experimental/internal).
+This is a partial list of events. This section describes what mpv_event_to_node() returns, and which is what scripting APIs and the JSON IPC sees. Note that the C API has separate C-level declarations with @@ -12549,7 +12618,7 @@
Hooks are synchronous events between player core and a script or similar. This applies to client API (including the Lua scripting interface). Normally, events are supposed to be asynchronous, and the hook API provides an awkward @@ -12611,7 +12680,6 @@
These prefixes are placed between key name and the actual command. Multiple @@ -15141,7 +15209,7 @@
This builtin script displays information and statistics for the currently played file. It is enabled by default if mpv was compiled with Lua support. It can be disabled entirely using the --load-stats-overlay=no option.
-The following key bindings are active by default unless something else is already bound to them:
@@ -15231,12 +15299,12 @@This script can be customized through a config file script-opts/stats.conf placed in mpv's user directory and through the --script-opts command-line option. The configuration syntax is described in mp.options functions.
-Color of the text.
Default: 2
+Default: 1.65
Size of border drawn around the font.
This script can be customized through a config file script-opts/console.conf placed in mpv's user directory and through the --script-opts command-line option. The configuration syntax is described in mp.options functions.
Key bindings can be changed in a standard way, see for example stats.lua documentation.
-Default: 1.5
+Default: 1.65
Set the font border size used for the REPL and the console.
JavaScript support in mpv is near identical to its Lua support. Use this section as reference on differences and availability of APIs, but otherwise you should refer to the Lua documentation for API details and general scripting in mpv.
-JavaScript code which leaves fullscreen mode when the player is paused:
@@ -16996,7 +17064,7 @@Commands with named arguments
Currently, only "proper" commands (as listed by List of Input Commands) support named arguments.
In addition to the commands described in List of Input Commands, a few extra commands can also be used as part of the protocol: