mirror of
https://github.com/kovidgoyal/kitty
synced 2026-06-06 09:15:57 +02:00
54 lines
1.6 KiB
ReStructuredText
54 lines
1.6 KiB
ReStructuredText
Drag and Drop
|
|
==================================================
|
|
|
|
.. only:: man
|
|
|
|
Overview
|
|
--------------
|
|
|
|
*Drag and drop of files from the shell*
|
|
|
|
.. highlight:: sh
|
|
|
|
|
|
The ``dnd`` kitten can be used to drag and drop files between
|
|
the shell and arbitrary GUI programs, it even works over SSH, so you
|
|
can easily and seamlessly transfer files from one computer to another,
|
|
simply by dragging from one kitty window to another.
|
|
Using it is as simple as::
|
|
|
|
kitten dnd file-to-drag.xyz
|
|
|
|
Then, start dragging with the mouse inside the window, and :file:`file-to-drag.xyz`
|
|
will be dragged and you can drop it onto a GUI file manager or another window
|
|
running this kitten. You can specify directories as well to drag entire trees.
|
|
|
|
Similarly, dropping works by running the kitten::
|
|
|
|
kitten dnd
|
|
|
|
Then, drag some files from a GUI file manager or another window running the dnd kitten
|
|
and drop them onto this window. The files will be copied or moved (depending on
|
|
which area you drop them) into the current working directory.
|
|
|
|
The best part is this works even over SSH. So if you just want to quickly
|
|
transfer some files from one computer to another all you need to so is ssh into
|
|
the remote computer::
|
|
|
|
kitten ssh remote-computer-name
|
|
|
|
Then, run the dnd kitten on the remote computer::
|
|
|
|
kitten dnd files-or-dirs-to-drag
|
|
|
|
That's it, you can now drag form or drop to the remote computer. See below for
|
|
customising the behavior of the kitten via command line flags.
|
|
|
|
This kitten uses a new protocol developed by kitty to function, for details,
|
|
see :doc:`/dnd-protocol`.
|
|
|
|
.. program:: kitty +kitten dnd
|
|
|
|
|
|
.. include:: /generated/cli-kitten-dnd.rst
|