.. _org.freedesktop.portal.FileTransfer: =================================== File Transfer =================================== Portal for transferring files between apps The `org.freedesktop.portal.FileTransfer`_ portal operates as a middle-man between apps when transferring files via drag-and-drop or copy-paste, taking care of the necessary exporting of files in the document portal. Toolkits are expected to use the application/vnd.portal.filetransfer mimetype when using this mechanism for file exchange via copy-paste or drag-and-drop. The data that is transmitted with this mimetype should be the key returned by the `org.freedesktop.portal.FileTransfer.StartTransfer`_ method. Upon receiving this mimetype, the target should call `org.freedesktop.portal.FileTransfer.RetrieveFiles`_ with the key, to obtain the list of files. The portal will take care of exporting files in the document store as necessary to make them accessible to the target. Files added to the :ref:`Documents portal` by this portal do not stay accessible across sessions. The D-Bus interface for the this portal is available under the bus name org.freedesktop.portal.Documents and the object path ``/org/freedesktop/portal/documents``. This documentation describes version 1 of this interface. .. include:: doc-org.freedesktop.portal.FileTransfer.properties.rst .. include:: doc-org.freedesktop.portal.FileTransfer.methods.rst .. include:: doc-org.freedesktop.portal.FileTransfer.signals.rst