RepoMirrors
/
mpv
mirror of https://github.com/mpv-player/mpv
1
0
Fork 0
Code Issues Releases Wiki Activity
mpv/etc/input.conf

190 lines
7.3 KiB
Plaintext
Raw Permalink Normal View History

input.conf: make explanatory text more readable Or at leats this is the intention. It's a bit hard to tell which information is needed, and which not.
2014-08-11 21:32:37 +00:00
# mpv keybindings
etc/input.conf: make file contents match default key bindings There were some slight differences between what input.conf mapped, and what was in input.c def_cmd_binds[]. Make them match. Add some minor documentation improvements in input.cfg. Also remove double comments ('##'), because they were confusing.
2012-01-17 01:49:27 +00:00
#
input.conf: make explanatory text more readable Or at leats this is the intention. It's a bit hard to tell which information is needed, and which not.
2014-08-11 21:32:37 +00:00
# Location of user-defined bindings: ~/.config/mpv/input.conf
etc/input.conf: make file contents match default key bindings There were some slight differences between what input.conf mapped, and what was in input.c def_cmd_binds[]. Make them match. Add some minor documentation improvements in input.cfg. Also remove double comments ('##'), because they were confusing.
2012-01-17 01:49:27 +00:00
#
input.conf: make explanatory text more readable Or at leats this is the intention. It's a bit hard to tell which information is needed, and which not.
2014-08-11 21:32:37 +00:00
# Lines starting with # are comments. Use SHARP to assign the # key.
# Copy this file and uncomment and edit the bindings you want to change.
etc/input.conf: make file contents match default key bindings There were some slight differences between what input.conf mapped, and what was in input.c def_cmd_binds[]. Make them match. Add some minor documentation improvements in input.cfg. Also remove double comments ('##'), because they were confusing.
2012-01-17 01:49:27 +00:00
#
input.conf: make explanatory text more readable Or at leats this is the intention. It's a bit hard to tell which information is needed, and which not.
2014-08-11 21:32:37 +00:00
# List of commands and further details: DOCS/man/input.rst
# List of special keys: --input-keylist
# Keybindings testing mode: mpv --input-test --force-window --idle
etc/input.conf: make file contents match default key bindings There were some slight differences between what input.conf mapped, and what was in input.c def_cmd_binds[]. Make them match. Add some minor documentation improvements in input.cfg. Also remove double comments ('##'), because they were confusing.
2012-01-17 01:49:27 +00:00
#
input.conf: make explanatory text more readable Or at leats this is the intention. It's a bit hard to tell which information is needed, and which not.
2014-08-11 21:32:37 +00:00
# Use 'ignore' to unbind a key fully (e.g. 'ctrl+a ignore').
etc/input.conf: make file contents match default key bindings There were some slight differences between what input.conf mapped, and what was in input.c def_cmd_binds[]. Make them match. Add some minor documentation improvements in input.cfg. Also remove double comments ('##'), because they were confusing.
2012-01-17 01:49:27 +00:00
#
input: handle escapes always in command parser Previously, both the command parser and property expansion (m_properties_expand_string) handled escapes with '\'. Move all escape handling into the command parser, and remove it from the property code. This removes the need to escape strings twice for commands that use property expansion. The command parser is practically rewritten: it uses m_option for the actual parsing, and reduces hackish C-string handling.
2012-09-22 12:54:57 +00:00
# Strings need to be quoted and escaped:
input: allow - as separator between commands, instead of _ Wnile it seems quite logical to me that commands use _ as word separator, while properties use -, I can't really explain the difference, and it tends to confuse users as well. So always prefer - as separator for everything. Using _ still works, and will probably forever. Not doing so would probably create too much chaos and confusion.
2015-05-25 19:59:44 +00:00
# KEY show-text "This is a single backslash: \\ and a quote: \" !"
etc/input.conf: make file contents match default key bindings There were some slight differences between what input.conf mapped, and what was in input.c def_cmd_binds[]. Make them match. Add some minor documentation improvements in input.cfg. Also remove double comments ('##'), because they were confusing.
2012-01-17 01:49:27 +00:00
#
# You can use modifier-key combinations like Shift+Left or Ctrl+Alt+x with
input.conf: make explanatory text more readable Or at leats this is the intention. It's a bit hard to tell which information is needed, and which not.
2014-08-11 21:32:37 +00:00
# the modifiers Shift, Ctrl, Alt and Meta (may not work on the terminal).
#
# The default keybindings are hardcoded into the mpv binary.
# You can disable them completely with: --no-input-default-bindings
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
input.conf: clarify the magic how default key bindings are added This is a confusing mechanism, so the explanation should bit more clear.
2013-11-06 19:27:19 +00:00
# Developer note:
input.conf: make explanatory text more readable Or at leats this is the intention. It's a bit hard to tell which information is needed, and which not.
2014-08-11 21:32:37 +00:00
# On compilation, this file is baked into the mpv binary, and all lines are
# uncommented (unless '#' is followed by a space) - thus this file defines the
# default key bindings.
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
input: allow input.conf bindings to be declared as builtin This might be helpful if we ever want cascading config files. Also, we will probably need it if we change the default input.conf bindings, and want to provide compatibility input.conf files.
2014-02-25 21:09:20 +00:00
# If this is enabled, treat all the following bindings as default.
#default-bindings start
input: use mnemonic names for mouse buttons mpv's mouse button numbering is based on X11 button numbering, which allows for an arbitrary number of buttons and includes mouse wheel input as buttons 3-6. This button numbering was used throughout the codebase and exposed in input.conf, and it was difficult to remember which physical button each number actually referred to and which referred to the scroll wheel. In practice, PC mice only have between two and five buttons and one or two scroll wheel axes, which are more or less in the same location and have more or less the same function. This allows us to use names to refer to the buttons instead of numbers, which makes input.conf syntax a lot easier to remember. It also makes the syntax robust to changes in mpv's underlying numbering. The old MOUSE_BTNx names are still understood as deprecated aliases of the named buttons. This changes both the input.conf syntax and the MP_MOUSE_BTNx symbols in the codebase, since I think both would benefit from using names over numbers, especially since some platforms don't use X11 button numbering and handle different mouse buttons in different windowing system events. This also makes the names shorter, since otherwise they would be pretty long, and it removes the high-numbered MOUSE_BTNx_DBL names, since they weren't used. Names are the same as used in Qt: https://doc.qt.io/qt-5/qt.html#MouseButton-enum
2017-08-08 11:34:38 +00:00
#MBTN_LEFT ignore # don't do anything
#MBTN_LEFT_DBL cycle fullscreen # toggle fullscreen on/off
#MBTN_RIGHT cycle pause # toggle pause on/off
input: Add default bindings for MBTN_BACK and MBTN_FORWARD
2019-07-06 15:56:40 +00:00
#MBTN_BACK playlist-prev
#MBTN_FORWARD playlist-next
etc/input.conf: make file contents match default key bindings There were some slight differences between what input.conf mapped, and what was in input.c def_cmd_binds[]. Make them match. Add some minor documentation improvements in input.cfg. Also remove double comments ('##'), because they were confusing.
2012-01-17 01:49:27 +00:00
input: add support for precise scroll axes Support horizontal and vertical axes of input devices. If the input device support precise scrolling with an input value then it should first be scaled to a standard multiplier, where 1.0 is the default. The multiplier will then applied to the following commands if possible: * MP_CMD_SEEK * MP_CMD_SPEED_MULT * MP_CMD_ADD All other commands will triggered on every axis event, without change the values specified in the config file.
2013-07-25 16:08:57 +00:00
# Mouse wheels, touchpad or other input devices that have axes
input.conf: better documentation and sane defaults Uses the same defaults as BTN3/4/5/6 which are hardcoded by most backends for the mouse wheel.
2013-08-07 20:20:10 +00:00
# if the input devices supports precise scrolling it will also scale the
# numeric value accordingly
input: merge mouse wheel and axis keycodes Mouse wheel bindings have always been a cause of user confusion. Previously, on Wayland and macOS, precise touchpads would generate AXIS keycodes and notched mouse wheels would generate mouse button keycodes. On Windows, both types of device would generate AXIS keycodes and on X11, both types of device would generate mouse button keycodes. This made it pretty difficult for users to modify their mouse-wheel bindings, since it differed between platforms and in some cases, between devices. To make it more confusing, the keycodes used on Windows were changed in 18a45a42d524 without a deprecation period or adequate communication to users. This change aims to make mouse wheel binds less confusing. Both the mouse button and AXIS keycodes are now deprecated aliases of the new WHEEL keycodes. This will technically break input configs on Wayland and macOS that assign different commands to precise and non-precise scroll events, but this is probably uncommon (if anyone does it at all) and I think it's a fair tradeoff for finally fixing mouse wheel-related confusion on other platforms.
2017-09-02 14:00:52 +00:00
#WHEEL_UP seek 10
#WHEEL_DOWN seek -10
#WHEEL_LEFT add volume -2
#WHEEL_RIGHT add volume 2
input: add support for precise scroll axes Support horizontal and vertical axes of input devices. If the input device support precise scrolling with an input value then it should first be scaled to a standard multiplier, where 1.0 is the default. The multiplier will then applied to the following commands if possible: * MP_CMD_SEEK * MP_CMD_SPEED_MULT * MP_CMD_ADD All other commands will triggered on every axis event, without change the values specified in the config file.
2013-07-25 16:08:57 +00:00
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
## Seek units are in seconds, but note that these are limited by keyframes
input.conf: change LEFT/RIGHT keys to seek 5s instead of 10s
2014-08-11 11:37:18 +00:00
#RIGHT seek 5
#LEFT seek -5
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#UP seek 60
#DOWN seek -60
input: add default keybindings Shift+[arrow] for small exact seeks
2010-12-19 11:34:06 +00:00
# Do smaller, always exact (non-keyframe-limited), seeks with shift.
commands: make exact seeking default bindings not use OSD The OSD bar is very annoying when seeking. Especially when the seeks are very small, the OSD doesn't show any interesting information. The exact seeking commands are a use case where the user definitely never wants to see a seek bar.
2012-09-25 01:25:44 +00:00
# Don't show them on the OSD (no-osd).
input: use flag option type for some input commands This gets rid of the need for a second (or more) parameters; instead it can be all in one parameter. The (now) redundant parameter is still parsed for compatibility, though. The way the flags make each other conflict is a bit tricky: they have overlapping bits, and the option parser disallows setting already set bits.
2015-03-04 16:21:02 +00:00
#Shift+RIGHT no-osd seek 1 exact
#Shift+LEFT no-osd seek -1 exact
#Shift+UP no-osd seek 5 exact
#Shift+DOWN no-osd seek -5 exact
input.conf: add some additional bindings
2014-11-19 22:03:42 +00:00
# Skip to previous/next subtitle (subject to some restrictions; see manpage)
input: allow - as separator between commands, instead of _ Wnile it seems quite logical to me that commands use _ as word separator, while properties use -, I can't really explain the difference, and it tends to confuse users as well. So always prefer - as separator for everything. Using _ still works, and will probably forever. Not doing so would probably create too much chaos and confusion.
2015-05-25 19:59:44 +00:00
#Ctrl+LEFT no-osd sub-seek -1
#Ctrl+RIGHT no-osd sub-seek 1
input: minor additions to default key bindings This adds key bindings for some semi-popular features. It also tries to cleanup some old bindings. For example w/e for panscan is now changed to w/W. In all cases, the old bindings are still kept and work, though. Part of an ongoing attempt to cleanup the default key bindings. See #973 for some context.
2018-03-01 14:10:59 +00:00
# Adjust timing to previous/next subtitle
#Ctrl+Shift+LEFT sub-step -1
#Ctrl+Shift+RIGHT sub-step 1
# Move video rectangle
#Alt+left add video-pan-x 0.1
#Alt+right add video-pan-x -0.1
#Alt+up add video-pan-y 0.1
#Alt+down add video-pan-y -0.1
# Zoom/unzoom video
#Alt++ add video-zoom 0.1
#Alt+- add video-zoom -0.1
# Reset video zoom/pan settings
#Alt+BS set video-zoom 0 ; set video-pan-x 0 ; set video-pan-y 0
input.conf: map shift+pgup/dwn to the old seek bindings
2014-08-09 00:24:10 +00:00
#PGUP add chapter 1 # skip to next chapter
#PGDWN add chapter -1 # skip to previous chapter
#Shift+PGUP seek 600
#Shift+PGDWN seek -600
input.conf: use exact value for [ binding This is supposed to undo the ] binding. This uses a value closer to the inverse. (Although it's not fully exact since the values are still stored as floating point instead as fractions.)
2018-01-29 12:34:15 +00:00
#[ multiply speed 1/1.1 # scale playback speed
command: replace speed_mult with multiply command The compatibility layer still takes care of the old speed_mult command.
2013-10-31 22:25:55 +00:00
#] multiply speed 1.1
#{ multiply speed 0.5
#} multiply speed 2.0
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#BS set speed 1.0 # reset speed to normal
input: minor additions to default key bindings This adds key bindings for some semi-popular features. It also tries to cleanup some old bindings. For example w/e for panscan is now changed to w/W. In all cases, the old bindings are still kept and work, though. Part of an ongoing attempt to cleanup the default key bindings. See #973 for some context.
2018-03-01 14:10:59 +00:00
#Shift+BS revert-seek # undo previous (or marked) seek
#Shift+Ctrl+BS revert-seek mark # mark position for revert-seek
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#q quit
input: allow - as separator between commands, instead of _ Wnile it seems quite logical to me that commands use _ as word separator, while properties use -, I can't really explain the difference, and it tends to confuse users as well. So always prefer - as separator for everything. Using _ still works, and will probably forever. Not doing so would probably create too much chaos and confusion.
2015-05-25 19:59:44 +00:00
#Q quit-watch-later
player: use exit code 0 by default for quit, 4 for signals, etc. Default key bindings in encoding mode also use code 4, because scripts will probably want to fail if encoding is aborted (leaving an incomplete file).
2015-07-11 18:07:58 +00:00
#q {encode} quit 4
input.conf: map ESC to exiting fullscreen Apparently making ESC exit fullscreen mode is the more popular convention compared to ESC quitting the program. It was also concluded that ESC should do nothing when the windows is already in normal state. See discussion in #973.
2014-09-15 21:22:21 +00:00
#ESC set fullscreen no
player: use exit code 0 by default for quit, 4 for signals, etc. Default key bindings in encoding mode also use code 4, because scripts will probably want to fail if encoding is aborted (leaving an incomplete file).
2015-07-11 18:07:58 +00:00
#ESC {encode} quit 4
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#p cycle pause # toggle pause/playback mode
input: allow - as separator between commands, instead of _ Wnile it seems quite logical to me that commands use _ as word separator, while properties use -, I can't really explain the difference, and it tends to confuse users as well. So always prefer - as separator for everything. Using _ still works, and will probably forever. Not doing so would probably create too much chaos and confusion.
2015-05-25 19:59:44 +00:00
#. frame-step # advance one frame and pause
#, frame-back-step # go back by one frame and pause
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#SPACE cycle pause
input: allow - as separator between commands, instead of _ Wnile it seems quite logical to me that commands use _ as word separator, while properties use -, I can't really explain the difference, and it tends to confuse users as well. So always prefer - as separator for everything. Using _ still works, and will probably forever. Not doing so would probably create too much chaos and confusion.
2015-05-25 19:59:44 +00:00
#> playlist-next # skip to next file
#ENTER playlist-next # skip to next file
#< playlist-prev # skip to previous file
Use - as command-name separator everywhere Old-style commands using _ as separator (e.g. show_progress) were still used in some places, including documentation and configuration files. This commit updates all such instances to the new style (show-progress) so that commands are easier to find in the manual.
2016-07-14 18:04:59 +00:00
#O no-osd cycle-values osd-level 3 1 # cycle through OSD mode
input: allow - as separator between commands, instead of _ Wnile it seems quite logical to me that commands use _ as word separator, while properties use -, I can't really explain the difference, and it tends to confuse users as well. So always prefer - as separator for everything. Using _ still works, and will probably forever. Not doing so would probably create too much chaos and confusion.
2015-05-25 19:59:44 +00:00
#o show-progress
#P show-progress
input.conf: explicit bindings for stats overlay
2017-10-12 19:25:50 +00:00
#i script-binding stats/display-stats
#I script-binding stats/display-stats-toggle
console.lua: add this script Merged from mpv-repl git repo commit 5ea2bf64f9c239f0326b02. Some changes were made on top of it: - Tabs were converted to 4 spaces indentation (plus some manual indentation fixes in some places). - All user-visible mentions of "repl" were renamed to "console". - The README was converted to a manpage (with heavy changes, some additions taken from stats.rst; rossy converted the key bindings table to RST). - The method to change the default key binding was changed. - Change minor detail about "font" default value setting (not a functional change). - Integrate into the player as builtin script, including an option to prevent loading it. Above changes and commit message done by wm4. Signed-off-by: wm4 <wm4@nowhere>
2019-12-07 16:16:10 +00:00
#` script-binding console/enable
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#z add sub-delay -0.1 # subtract 100 ms delay from subs
input: minor additions to default key bindings This adds key bindings for some semi-popular features. It also tries to cleanup some old bindings. For example w/e for panscan is now changed to w/W. In all cases, the old bindings are still kept and work, though. Part of an ongoing attempt to cleanup the default key bindings. See #973 for some context.
2018-03-01 14:10:59 +00:00
#Z add sub-delay +0.1 # add
#x add sub-delay +0.1 # same as previous binding (discouraged)
input.conf: add some bindings for changing audio-delay Requested on: https://github.com/mpv-player/mpv/commit/90ec3334174e80c16f00971886223a3afabc1aca#commitcomment-7331673 Might remove or remap them again later.
2014-08-11 21:40:35 +00:00
#ctrl++ add audio-delay 0.100 # this changes audio/video sync
#ctrl+- add audio-delay -0.100
options: remove --volstep It's just confusing; users are encouraged to edit input.conf instead (changing the argument to the "add" command). Update input.conf to keep the old behavior.
2014-09-21 13:41:33 +00:00
#9 add volume -2
#/ add volume -2
#0 add volume 2
#* add volume 2
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#m cycle mute
#1 add contrast -1
#2 add contrast 1
#3 add brightness -1
#4 add brightness 1
#5 add gamma -1
#6 add gamma 1
#7 add saturation -1
#8 add saturation 1
input.conf: add default bindings for changing window scale These are very much inspired by the hardcoded Cocoa bindings on OSX. Fixes #2500.
2015-11-17 20:49:30 +00:00
#Alt+0 set window-scale 0.5
#Alt+1 set window-scale 1.0
#Alt+2 set window-scale 2.0
input.conf: unmap some more obscure bindings Changing audio-delay is probably not needed. Changing balance "works", but not as expected (sets up a pan matrix to change left/right contributions to each other, rather than changing the relative volumes of each channel). I expect that the rest are not in use by anyone.
2014-08-07 22:43:14 +00:00
# toggle deinterlacer (automatically inserts or removes required filter)
input.conf: remap d/D keys Drop d for toggling framedrop. Toggling this is way too special to be at such a prominent place, and in fact I believe toggling it is pointless. Remap deinterlacing from D to d. It's relatively useful and non- destructive. As suggested in #973 (almost).
2015-08-03 23:04:26 +00:00
#d cycle deinterlace
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#r add sub-pos -1 # move subtitles up
input: minor additions to default key bindings This adds key bindings for some semi-popular features. It also tries to cleanup some old bindings. For example w/e for panscan is now changed to w/W. In all cases, the old bindings are still kept and work, though. Part of an ongoing attempt to cleanup the default key bindings. See #973 for some context.
2018-03-01 14:10:59 +00:00
#R add sub-pos +1 # down
#t add sub-pos +1 # same as previous binding (discouraged)
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#v cycle sub-visibility
etc/input.conf: make file contents match default key bindings There were some slight differences between what input.conf mapped, and what was in input.c def_cmd_binds[]. Make them match. Add some minor documentation improvements in input.cfg. Also remove double comments ('##'), because they were confusing.
2012-01-17 01:49:27 +00:00
# stretch SSA/ASS subtitles with anamorphic videos to match historical
player: fix previous commit ...
2016-10-03 15:16:02 +00:00
#V cycle sub-ass-vsfilter-aspect-compat
input.conf: add key binding to override ASS subtitle styles
2015-03-08 14:57:25 +00:00
# switch between applying no style overrides to SSA/ASS subtitles, and
# overriding them almost completely with the normal subtitle style
options: fix some missing --sub-ass-style-override renames The option was renamed not to include "-style", but not all uses were updated.
2017-06-07 18:18:25 +00:00
#u cycle-values sub-ass-override "force" "no"
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#j cycle sub # cycle through subtitles
#J cycle sub down # ...backwards
#SHARP cycle audio # switch audio streams
#_ cycle video
#T cycle ontop # toggle video window ontop of other windows
#f cycle fullscreen # toggle fullscreen
screenshot: change async behavior to be in line with new semantics Basically reimplement the async behavior on top of the async command code. With this, all screenshot commands are async, and the "async" prefix basically does nothing. The prefix now behaves exactly like with other commands that use spawn_thread. This also means using the prefix in the preset input.conf is pointless (without effect) and misleading, so remove that. The each_frame mode was actually particularly painful in making this change, since the player wants to block for it when writing a screenshot, and generally doesn't fit into the new infrastructure. It was still relatively easy to reimplement by copying the original command and then repeating it on each frame. The waiting is reentrant now, so move the call in video.c to a "safer" spot. One way to observe how the new semantics interact with everything is using the mpv repl script and sending a screenshot command through it. Without async flag, the script will freeze while writing the screenshot (while playback continues), while with async flag it continues.
2018-05-09 20:38:21 +00:00
#s screenshot # take a screenshot
#S screenshot video # ...without subtitles
#Ctrl+s screenshot window # ...with subtitles and OSD, and scaled
input: use flag option type for some input commands This gets rid of the need for a second (or more) parameters; instead it can be all in one parameter. The (now) redundant parameter is still parsed for compatibility, though. The way the flags make each other conflict is a bit tricky: they have overlapping bits, and the option parser disallows setting already set bits.
2015-03-04 16:21:02 +00:00
#Alt+s screenshot each-frame # automatically screenshot every frame
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#w add panscan -0.1 # zoom out with -panscan 0 -fs
input: minor additions to default key bindings This adds key bindings for some semi-popular features. It also tries to cleanup some old bindings. For example w/e for panscan is now changed to w/W. In all cases, the old bindings are still kept and work, though. Part of an ongoing attempt to cleanup the default key bindings. See #973 for some context.
2018-03-01 14:10:59 +00:00
#W add panscan +0.1 # in
#e add panscan +0.1 # same as previous binding (discouraged)
input.conf: bind 'A' to cycling aspect ratios Apparently broken files are popular enough that this is still needed. It's relatively often asked on the IRC channel, and I also found it on the archwiki mpv page. The list of aspect ratios is taken from the archwiki page, with "16:10" removed (because I doubt there are actually files with this aspect ratio).
2015-01-26 02:03:19 +00:00
# cycle video aspect ratios; "-1" is the container aspect
options: rename --video-aspect to --video-aspect-override The justification for this is the fact that the `video-aspect` property doesn't work well with `cycle_values` commands that include the value "-1". The "video-aspect" property has effectively no change in behavior, but we may want to make it read-only in the future. I think it's probably fine to leave as-is, though. Fixes #6068.
2019-10-04 16:45:37 +00:00
#A cycle-values video-aspect-override "16:9" "4:3" "2.35:1" "-1"
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#POWER quit
#PLAY cycle pause
#PAUSE cycle pause
#PLAYPAUSE cycle pause
input: add new PLAYONLY and PAUSEONLY MP_KEY key codes since the old PLAY and PAUSE key codes cycle through the pause property, the new key codes only explicitly set the pause property.
2020-01-21 18:15:51 +00:00
#PLAYONLY set pause no
#PAUSEONLY set pause yes
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#STOP quit
#FORWARD seek 60
#REWIND seek -60
input: allow - as separator between commands, instead of _ Wnile it seems quite logical to me that commands use _ as word separator, while properties use -, I can't really explain the difference, and it tends to confuse users as well. So always prefer - as separator for everything. Using _ still works, and will probably forever. Not doing so would probably create too much chaos and confusion.
2015-05-25 19:59:44 +00:00
#NEXT playlist-next
#PREV playlist-prev
options: remove --volstep It's just confusing; users are encouraged to edit input.conf instead (changing the argument to the "add" command). Update input.conf to keep the old behavior.
2014-09-21 13:41:33 +00:00
#VOLUME_UP add volume 2
#VOLUME_DOWN add volume -2
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#MUTE cycle mute
#CLOSE_WIN quit
player: use exit code 0 by default for quit, 4 for signals, etc. Default key bindings in encoding mode also use code 4, because scripts will probably want to fail if encoding is aborted (leaving an incomplete file).
2015-07-11 18:07:58 +00:00
#CLOSE_WIN {encode} quit 4
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
#E cycle edition # next edition
command: if only ab-loop-b is set, loop from start of file Commit 382bafcb changed the behavior for ab-loop-a. This commit changes ab-loop-b so that the behavior is symmetric. Adjust the OSD rendering accordingly to the two changes. Also fix mentions of the "ab_loop" command to the now preferred "ab-loop".
2016-04-21 20:15:17 +00:00
#l ab-loop # Set/clear A-B loop points
input.conf: change "L" to change loop-file by default
2017-01-31 10:46:43 +00:00
#L cycle-values loop-file "inf" "no" # toggle infinite looping
player: use exit code 0 by default for quit, 4 for signals, etc. Default key bindings in encoding mode also use code 4, because scripts will probably want to fail if encoding is aborted (leaving an incomplete file).
2015-07-11 18:07:58 +00:00
#ctrl+c quit 4
osc: make cycling visibility an input.conf key binding As builtin script, it should not register global key bindings, and add them to input.conf instead. This is similar to what stats.lua does.
2017-11-03 13:41:18 +00:00
#DEL script-binding osc/visibility # cycle OSC display
input: add a keybinding to toggle hardware decoding We sure as hell won't enable hardware decoding by default, but we can make it more accessible with a key binding.
2018-02-12 17:26:18 +00:00
#ctrl+h cycle-values hwdec "auto" "no" # cycle hardware decoding
input: minor additions to default key bindings This adds key bindings for some semi-popular features. It also tries to cleanup some old bindings. For example w/e for panscan is now changed to w/W. In all cases, the old bindings are still kept and work, though. Part of an ongoing attempt to cleanup the default key bindings. See #973 for some context.
2018-03-01 14:10:59 +00:00
#F8 show_text ${playlist} # show playlist
#F9 show_text ${track-list} # show list of audio/sub streams
core: add libquvi 0.9 support This adds support for libquvi 0.9.x, and these features: - start time (part of youtube URL) - youtube subtitles - alternative source switching ('l' and 'L' keys) - youtube playlists Note that libquvi 0.9 is still in development. Although this seems to be API stable now, it looks like there will be a 1.0 release, which is supposed to be the next stable release and the actual successor of libquvi 0.4.x.
2013-06-27 16:21:07 +00:00
input.conf: remap pgup/dwn to chapter seeks As discussed in #973. Keep the old bindings for now; there's no reason to unmap them yet.
2014-08-07 21:55:09 +00:00
#
# Legacy bindings (may or may not be removed in the future)
#
#! add chapter -1 # skip to previous chapter
#@ add chapter 1 # next
etc/input.conf: make file contents match default key bindings There were some slight differences between what input.conf mapped, and what was in input.c def_cmd_binds[]. Make them match. Add some minor documentation improvements in input.cfg. Also remove double comments ('##'), because they were confusing.
2012-01-17 01:49:27 +00:00
#
# Not assigned by default
# (not an exhaustive list of unbound commands)
#
Allow DVD Menus to be controlled by AppleIR Remote. git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@26800 b3059339-0415-0410-9bf9-f77b7e298cf2
2008-05-18 12:19:51 +00:00
input: comment all default bindings in input.conf I suspect most users will just copy etc/input.conf when they want to remap some default bindings. But usually this means the user even copies bindings he doesn't care about, and it's better if the user maps only the bindings in his input.conf the user intends to remap. Comment all bindings in etc/input.conf. Since this file also defines the builtin defaults and is baked into the mpv binary, we have to do something to get them anyway, even though they are commented. Do this by having input.c "uncomment" the bindings in the baked in input.conf. (Of course this is done only for the builtin config, not configs loaded from disk.)
2013-09-01 15:06:11 +00:00
# ? add sub-scale +0.1 # increase subtitle font size
# ? add sub-scale -0.1 # decrease subtitle font size
input.conf: unmap some more obscure bindings Changing audio-delay is probably not needed. Changing balance "works", but not as expected (sets up a pan matrix to change left/right contributions to each other, rather than changing the relative volumes of each channel). I expect that the rest are not in use by anyone.
2014-08-07 22:43:14 +00:00
# ? cycle angle # switch DVD/Bluray angle
# ? cycle sub-forced-only # toggle DVD forced subs
# ? cycle program # cycle transport stream programs
# ? stop # stop playback (quit or enter idle mode)