1 files changed, 104 insertions, 0 deletions
diff --git a/DOCS/man/console.rst b/DOCS/man/console.rst
new file mode 100644
index 0000000000..89726b72a6
--- /dev/null
+++ b/DOCS/man/console.rst
@@ -0,0 +1,104 @@
+CONSOLE
+=======
+
+The console is a REPL for mpv input commands. It is displayed on the video
+window. It also shows log messages. It can be disabled entirely using the
+``--load-osd-console=no`` option.
+
+Keybindings
+-----------
+
+\`
+    Show the console.
+
+ESC
+    Hide the console.
+
+ENTER
+    Run the typed command.
+
+Shift+ENTER
+    Type a literal newline character.
+
+Ctrl+LEFT and Ctrl+RIGHT
+    Move cursor to previous/next word.
+
+UP and DOWN
+    Navigate command history.
+
+PGUP
+    Go to the first command in the history.
+
+PGDN
+    Stop navigating command history.
+
+INSERT
+    Toggle insert mode.
+
+Shift+INSERT
+    Paste text (uses the primary selection on X11.)
+
+TAB
+    Complete the command or property name at the cursor.
+
+Ctrl+C
+    Clear current line.
+
+Ctrl+K.
+    Delete text from the cursor to the end of the line.
+
+Ctrl+L
+    Clear all log messages from the console.
+
+Ctrl+U
+    Delete text from the cursor to the beginning of the line.
+
+Ctrl+V
+    Paste text (uses the clipboard on X11.)
+
+Ctrl+W
+    Delete text from the cursor to the beginning of the current word.
+
+Commands
+--------
+
+``script-message-to console type <text>``
+    Show the console and pre-fill it with the provided text.
+
+Known issues
+------------
+
+- Pasting text is slow on Windows
+- Non-ASCII keyboard input has restrictions
+- The cursor keys move between Unicode code-points, not grapheme clusters
+
+Configuration
+-------------
+
+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 `ON SCREEN CONTROLLER`_.
+
+Key bindings can be changed in a standard way, see for example stats.lua
+documentation.
+
+Configurable Options
+~~~~~~~~~~~~~~~~~~~~
+
+``scale``
+    Default: 1
+
+    All drawing is scaled by this value, including the text borders and the
+    cursor. Change it if you have a high-DPI display.
+
+``font``
+    Default: unset (picks a hardcoded font depending on detected platform)
+
+    Set the font used for the REPL and the console. This probably doesn't
+    have to be a monospaced font.
+
+``font_size``
+    Default: 16
+
+    Set the font size used for the REPL and the console. This will be
+    multiplied by "scale."