Allow mapping arbitrary remote control commands to key presses in kitty.conf

docs/changelog.rst

@@ -14,6 +14,9 @@ To update |kitty|, :doc:`follow the instructions <binary>`.
 - Fix reverse video not being rendered correctly when using transparency or a
   background image (:iss:`2419`)
 
+- Allow mapping arbitrary remote control commands to key presses in
+  :file:`kitty.conf`
+
 - X11: Fix crash when doing drag and drop from some applications (:iss:`2505`)
 
 - Fix :option:`launch --stdin-add-formatting` not working (:iss:`2512`)

docs/remote-control.rst

@@ -134,6 +134,19 @@ still write to the pipes of any other program on the same computer and
 therefore can control |kitty|. It can, however, be useful to block programs
 running on other computers (for example, over ssh) or as other users.
 
+Mapping key presses to remote control commands
+--------------------------------------------------
+
+If you wish to trigger a remote control command easily with just a keypress,
+you can map it in :file:`kitty.conf`. For example::
+
+    map F1 remote_control set-spacing margin=30
+
+Then pressing the :kbd:`F1` key will set the active window margins to 30.
+The syntax for what follows :code:`remote_control` is exactly the same
+as the syntax for what follows :code:`kitty @` above.
+
+
 Documentation for the remote control protocol
 -----------------------------------------------