Create an easy to use alias for running remote control scripts

This commit is contained in:
Kovid Goyal
2023-10-18 20:29:50 +05:30
parent f8ab5f3f67
commit 1332cf8ac7
4 changed files with 33 additions and 5 deletions

View File

@@ -46,7 +46,7 @@ Detailed list of changes
0.31.0 [future]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Allow :ref:`easily running arbitrarily complex remote control scripts <rc_mapping>` without needing to turn on remote control (:iss:`6712`)
- Allow :ac:`easily running arbitrarily complex remote control scripts <remote_control_script>` without needing to turn on remote control (:iss:`6712`)
- A new option :opt:`menu_map` that allows adding entries to the global menubar on macOS (:disc:`6680`)

View File

@@ -283,10 +283,14 @@ are matched::
If you wish to run a more complex script, you can use::
map f1 launch --type=background --allow-remote-control /path/to/myscript
map f1 remote_control_script /path/to/myscript
In this script you can use the ``kitten @`` command to run as many remote
control commands as you like.
In this script you can use ``kitten @`` to run as many remote
control commands as you like and process their output.
:ac:`remote_control_script` is really just an alias for the
:ac:`launch` command with ``--type=background --allow-remote-control``.
For more advanced usage, including fine grained permissions, setting
env vars, etc. see the docs for the :doc:`launch <launch>` command.
.. note:: You do not need :opt:`allow_remote_control` to use these mappings,
as they are not actual remote programs, but are simply a way to reuse the