2019-06-12 10:42:53 +03:00
|
|
|
Documentation for the kitty remote control protocol
|
|
|
|
======================================================
|
|
|
|
|
|
|
|
The kitty remote control protocol is a simple protocol that involves sending
|
2019-08-23 02:01:12 +03:00
|
|
|
data to kitty in the form of JSON. Any individual command of kitty has the
|
2019-06-12 10:42:53 +03:00
|
|
|
form::
|
|
|
|
|
|
|
|
<ESC>P@kitty-cmd<JSON object><ESC>\
|
|
|
|
|
|
|
|
Where ``<ESC>`` is the byte ``0x1b``. The JSON object has the form::
|
|
|
|
|
|
|
|
{
|
2020-08-11 10:31:33 +03:00
|
|
|
"cmd": "command name",
|
|
|
|
"version": <kitty version>,
|
|
|
|
"no_response": Optional Boolean,
|
|
|
|
"payload": <Optional JSON object>,
|
2019-06-12 10:42:53 +03:00
|
|
|
}
|
|
|
|
|
2020-08-11 05:22:32 +03:00
|
|
|
The ``version`` above is an array of the form :code:`[0, 14, 2]`. If you are developing a
|
2019-06-12 10:42:53 +03:00
|
|
|
standalone client, use the kitty version that you are developing against. Using
|
|
|
|
a version greater than the version of the kitty instance you are talking to,
|
|
|
|
will cause a failure.
|
|
|
|
|
2020-08-11 10:38:16 +03:00
|
|
|
Set ``no_response`` to ``true`` if you don't want a response from kitty.
|
2019-06-12 10:42:53 +03:00
|
|
|
|
|
|
|
The optional payload is a JSON object that is specific to the actual command being sent.
|
|
|
|
The fields in the object for every command are documented below.
|
|
|
|
|
|
|
|
.. include:: generated/rc.rst
|