510022c3c1
Add more text roles and links. Add an example that broadcasts only to other windows in the current tab. Initial capitalization of the key names in the kbd text role. Add Python type hints for custom kittens. Note about hyperlink support for ls on macOS. Add description text for show_key.
19 lines
835 B
ReStructuredText
19 lines
835 B
ReStructuredText
Query terminal
|
|
=================
|
|
|
|
This kitten is used to query |kitty| from terminal programs about version, values
|
|
of various runtime options controlling its features, etc.
|
|
|
|
The querying is done using the (*semi*) standard XTGETTCAP escape sequence
|
|
pioneered by XTerm, so it works over SSH as well. The downside is that it is
|
|
slow, since it requires a roundtrip to the terminal emulator and back.
|
|
|
|
If you want to do some of the same querying in your terminal program without
|
|
depending on the kitten, you can do so, by processing the same escape codes.
|
|
Search `this page <https://invisible-island.net/xterm/ctlseqs/ctlseqs.html>`__
|
|
for *XTGETTCAP* to see the syntax for the escape code and read the source of
|
|
this kitten to find the values of the keys for the various queries.
|
|
|
|
|
|
.. include:: ../generated/cli-kitten-query_terminal.rst
|