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.
42 lines
1.4 KiB
ReStructuredText
42 lines
1.4 KiB
ReStructuredText
Remote files
|
|
==============
|
|
|
|
|kitty| has the ability to easily *Edit*, *Open* or *Download* files from a
|
|
computer into which you are SSHed. In your SSH session run::
|
|
|
|
ls --hyperlink=auto
|
|
|
|
Then hold down :kbd:`Ctrl+Shift` and click the name of the file.
|
|
|
|
.. figure:: ../screenshots/remote_file.png
|
|
:alt: Remote file actions
|
|
:align: center
|
|
:width: 100%
|
|
|
|
Remote file actions
|
|
|
|
|kitty| will ask you what you want to do with the remote file. You can choose
|
|
to *Edit* it in which case kitty will download it and open it locally in your
|
|
:envvar:`EDITOR`. As you make changes to the file, they are automatically
|
|
transferred to the remote computer. Note that this happens without needing
|
|
to install *any* special software on the server, beyond :program:`ls` that
|
|
supports hyperlinks.
|
|
|
|
.. seealso:: See the :doc:`transfer` kitten
|
|
|
|
.. versionadded:: 0.19.0
|
|
|
|
.. note::
|
|
Nested SSH sessions are not supported. The kitten will always try to copy
|
|
remote files from the first SSH host. This is because there is no way for
|
|
|kitty| to detect and follow a nested SSH session robustly. Use the
|
|
:doc:`transfer` kitten for such situations.
|
|
|
|
.. note::
|
|
If you have not setup automatic password-less SSH access, then, when editing
|
|
starts you will be asked to enter your password just once, thereafter the SSH
|
|
connection will be re-used.
|
|
|
|
Similarly, you can choose to save the file to the local computer or download
|
|
and open it in its default file handler.
|