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

180 lines
9.6 KiB
Plaintext
Raw 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
input.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#MBTN_LEFT_DBL cycle fullscreen # toggle fullscreen
#MBTN_RIGHT cycle pause # toggle pause/playback mode
#MBTN_BACK playlist-prev # skip to the previous file
#MBTN_FORWARD playlist-next # skip to the next file
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.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#WHEEL_UP seek 10 # seek 10 seconds forward
#WHEEL_DOWN seek -10 # seek 10 seconds backward
input.conf: remove redundant comments
2021-08-19 13:32:55 +00:00
#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: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#RIGHT seek 5 # seek 5 seconds forward
#LEFT seek -5 # seek 5 seconds backward
#UP seek 60 # seek 1 minute forward
#DOWN seek -60 # seek 1 minute backward
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.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#Shift+RIGHT no-osd seek 1 exact # seek exactly 1 second forward
#Shift+LEFT no-osd seek -1 exact # seek exactly 1 second backward
#Shift+UP no-osd seek 5 exact # seek exactly 5 seconds forward
#Shift+DOWN no-osd seek -5 exact # seek exactly 5 seconds backward
#Ctrl+LEFT no-osd sub-seek -1 # seek to the previous subtitle
#Ctrl+RIGHT no-osd sub-seek 1 # seek to the next subtitle
#Ctrl+Shift+LEFT sub-step -1 # change subtitle timing such that the previous subtitle is displayed
#Ctrl+Shift+RIGHT sub-step 1 # change subtitle timing such that the next subtitle is displayed
#Alt+left add video-pan-x 0.1 # move the video right
#Alt+right add video-pan-x -0.1 # move the video left
#Alt+up add video-pan-y 0.1 # move the video down
#Alt+down add video-pan-y -0.1 # move the video up
#Alt++ add video-zoom 0.1 # zoom in
#Alt+- add video-zoom -0.1 # zoom out
#Alt+BS set video-zoom 0 ; set video-pan-x 0 ; set video-pan-y 0 # reset zoom and pan settings
#PGUP add chapter 1 # seek to the next chapter
#PGDWN add chapter -1 # seek to the previous chapter
#Shift+PGUP seek 600 # seek 10 minutes forward
#Shift+PGDWN seek -600 # seek 10 minutes backward
#[ multiply speed 1/1.1 # decrease the playback speed
#] multiply speed 1.1 # increase the playback speed
#{ multiply speed 0.5 # halve the playback speed
#} multiply speed 2.0 # double the playback speed
#BS set speed 1.0 # reset the speed to normal
#Shift+BS revert-seek # undo the previous (or marked) seek
#Shift+Ctrl+BS revert-seek mark # mark the position for revert-seek
input.conf: remove redundant comments
2021-08-19 13:32:55 +00:00
#q quit
input.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#Q quit-watch-later # exit and remember the playback position
input.conf: remove redundant comments
2021-08-19 13:32:55 +00:00
#q {encode} quit 4
input.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#ESC set fullscreen no # leave fullscreen
input.conf: remove redundant comments
2021-08-19 13:32:55 +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.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#SPACE cycle pause # toggle pause/playback mode
#> playlist-next # skip to the next file
#ENTER playlist-next # skip to the next file
#< playlist-prev # skip to the previous file
#O no-osd cycle-values osd-level 3 1 # toggle displaying the OSD on user interaction or always
#o show-progress # show playback progress
#P show-progress # show playback progress
#i script-binding stats/display-stats # display information and statistics
#I script-binding stats/display-stats-toggle # toggle displaying information and statistics
#` script-binding console/enable # open the console
#z add sub-delay -0.1 # shift subtitles 100 ms earlier
#Z add sub-delay +0.1 # delay subtitles by 100 ms
#x add sub-delay +0.1 # delay subtitles by 100 ms
#ctrl++ add audio-delay 0.100 # change audio/video sync by delaying the audio
#ctrl+- add audio-delay -0.100 # change audio/video sync by shifting the audio earlier
#Shift+g add sub-scale +0.1 # increase the subtitle font size
#Shift+f add sub-scale -0.1 # decrease the subtitle font size
input.conf: remove redundant comments
2021-08-19 13:32:55 +00:00
#9 add volume -2
#/ add volume -2
#0 add volume 2
#* add volume 2
input.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#m cycle mute # toggle mute
input.conf: remove redundant comments
2021-08-19 13:32:55 +00:00
#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 comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#Alt+0 set current-window-scale 0.5 # halve the window size
#Alt+1 set current-window-scale 1.0 # reset the window size
#Alt+2 set current-window-scale 2.0 # double the window size
#d cycle deinterlace # toggle the deinterlacing filter
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.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#R add sub-pos +1 # move subtitles down
#t add sub-pos +1 # move subtitles down
#v cycle sub-visibility # hide or show the subtitles
Revert "options: add --sub-visibility=<primary-only|secondary-only>" This reverts commit 04f0b0abe48d664aaa1400d1dddb02b434999b85. It's not a good idea to unify the names only for visibility, while keeping secondary-* for everything else. This needs a bit more thought before we allow secondary sub to be visible on its own.
2022-01-19 19:56:28 +00:00
#Alt+v cycle secondary-sub-visibility # hide or show the secondary subtitles
input.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#V cycle sub-ass-vsfilter-aspect-compat # toggle stretching SSA/ASS subtitles with anamorphic videos to match the historical renderer
#u cycle-values sub-ass-override "force" "no" # toggle overriding SSA/ASS subtitle styles with the normal styles
#j cycle sub # switch subtitle track
#J cycle sub down # switch subtitle track backwards
#SHARP cycle audio # switch audio track
#_ cycle video # switch video track
#T cycle ontop # toggle placing the video on top of other windows
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
#f cycle fullscreen # toggle fullscreen
input.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#s screenshot # take a screenshot of the video in its original resolution with subtitles
#S screenshot video # take a screenshot of the video in its original resolution without subtitles
#Ctrl+s screenshot window # take a screenshot of the window with OSD and subtitles
#Alt+s screenshot each-frame # automatically screenshot every frame; issue this command again to stop taking screenshots
#w add panscan -0.1 # decrease panscan
#W add panscan +0.1 # shrink black bars by cropping the video
#e add panscan +0.1 # shrink black bars by cropping the video
#A cycle-values video-aspect-override "16:9" "4:3" "2.35:1" "-1" # cycle the video aspect ratio ("-1" is the container aspect)
input.conf: remove redundant comments
2021-08-19 13:32:55 +00:00
#POWER quit
input.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#PLAY cycle pause # toggle pause/playback mode
#PAUSE cycle pause # toggle pause/playback mode
#PLAYPAUSE cycle pause # toggle pause/playback mode
#PLAYONLY set pause no # unpause
#PAUSEONLY set pause yes # pause
input.conf: remove redundant comments
2021-08-19 13:32:55 +00:00
#STOP quit
input.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#FORWARD seek 60 # seek 1 minute forward
#REWIND seek -60 # seek 1 minute backward
#NEXT playlist-next # skip to the next file
#PREV playlist-prev # skip to the previous file
input.conf: remove redundant comments
2021-08-19 13:32:55 +00:00
#VOLUME_UP add volume 2
#VOLUME_DOWN add volume -2
input.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#MUTE cycle mute # toggle mute
input.conf: remove redundant comments
2021-08-19 13:32:55 +00:00
#CLOSE_WIN quit
#CLOSE_WIN {encode} quit 4
#ctrl+w quit
input.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#E cycle edition # switch edition
#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
input.conf: remove redundant comments
2021-08-19 13:32:55 +00:00
#ctrl+c quit 4
input.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#DEL script-binding osc/visibility # cycle OSC visibility between never, auto (mouse-move) and always
#ctrl+h cycle-values hwdec "auto" "no" # toggle hardware decoding
#F8 show-text ${playlist} # show the playlist
#F9 show-text ${track-list} # show the list of video, audio and sub tracks
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)
#
input.conf: add comments These will be shown in the new keybinding list.
2021-07-20 17:27:22 +00:00
#! add chapter -1 # seek to the previous chapter
#@ add chapter 1 # seek to the next chapter
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
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.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 sub-forced-only # toggle DVD forced subs
# ? stop # stop playback (quit or enter idle mode)