Help › Functions
Transfer files
Send files both ways during a session. Files from other people only land once you agree.
Files work only in a running session, and only if Transfer files is allowed there. For people outside your account it starts off; the person at the other device can switch it on in the request or later in the indicator of the running session.
Send files
macOS
Drag files onto the session picture or into the side panel (⌃⌥⌘S), or choose Send Files… for several files at once. Only files work, not folders.


iPhone & iPad
In the session menu: Send Files…. Running and finished transfers are under Transfers (…).


Linux
Drag files onto the session picture or into the side panel, or choose Send Files… for several files at once. You open the side panel with the “Exchange” icon in the header bar (Ctrl+Alt+Shift+S); it shows files, the clipboard and the session's connection. Every transfer has a progress bar, the cross cancels it, and you show a received file in the file manager. Open shared folders opens this device's shared folders on the Files page. Only files work, not folders.
Receive files
From your own devices DeskRanger saves files at once. From other people it asks first: Save or Decline. If you don’t answer, the offer expires after a waiting period.
macOS
Files are saved in the Downloads folder. To use another folder, go to Settings (⌘,) › Files › Received files, Save received files in, and choose Change…; Reset goes back to Downloads. If the chosen folder is gone or DeskRanger can’t save there, files go to Downloads meanwhile, and the settings say why; DeskRanger does not recreate the folder.
If the name exists already, DeskRanger adds a number, such as “Report (1).pdf”; nothing is overwritten. Received files are marked like downloads from a browser: macOS checks a program before it first runs.


iPhone & iPad
Files are saved in the Files app under “DeskRanger”.


Web
In the browser (web console) you send files with Send Files… in the bar above the picture, or drag them onto the picture; each transfer shows its progress at the bottom right, and the cross cancels it. The web console hands on a received file only once it has arrived whole and checked: it becomes a browser download, saved where your browser saves downloads. A file-size limit applies in the browser.
Android
Files are saved in the Downloads folder, or in the folder you chose in Settings under Save received files in. This also holds while someone is connected to your Android device: tap the red bar, send files to that person with Send Files…, and below you see every transfer of the session. The switch Transfer files takes the right back.


If the background service hosts a Windows PC (reachable before sign-in too), the PC takes files while someone is signed in there. It saves them as that person into the folder their DeskRanger app names for received files, otherwise into “Downloads”. From your own devices they arrive without a question. A file from another account or a support session is asked about by the app there, as without the background service; if the app is not running, the PC declines it, because nobody can be asked. In the menu of the red icon in the notification area the person at the PC sends files to the session with Send Files…; the background service opens them with that person’s rights. Browsing the PC’s files from another device needs someone signed in there: at the sign-in screen, or when the PC’s session is disconnected, that device says nobody is signed in and the files appear after the sign-in.
Tabs, copying and this device
iPhone & iPad
Under Files the “This iPhone” section (on the iPad “This iPad”) shows this device's folders: the “DeskRanger” folder that the Files app shows too, and folders you add from the Files app with Add Folder…. iOS gives DeskRanger no more than that; other devices see none of it unless you copy it there. Remove from List (swipe left) takes an added folder out of the list; the folder itself stays.
Press and hold a file or folder and choose Copy To: you pick the destination folder on this device or on another device and tap Copy here. Your iPhone only gives the order; the data goes straight from device to device, and the transfer appears under Transfers. Between a server and another device DeskRanger does not copy directly yet. The same menu offers Open in New Tab.
The tabs are at the bottom: each tab has its own place; the number of tabs you can open at once is limited, and they are kept across a restart. New Tab adds one, the cross closes the active one. On the iPad Side by Side shows two tabs next to each other; then you drag files from one side onto a folder of the other, or from other apps onto a folder to upload them. When you drag a file out of DeskRanger into another app, it arrives complete.
Files from an SSH server
iPhone & iPad
On iPhone and iPad your SSH hosts are under Files in the Servers (SFTP) section. Tap a host: the first time DeskRanger asks for the fingerprint and the password, then you see the home folder and “/”. Download puts a file in the “DeskRanger” folder of the Files app, uploading sends files from the Files app to the server. Nothing is overwritten; an interrupted transfer resumes where it stopped. Swipe a file or folder to the left (or press and hold it) for Rename and Delete; a server has no trash, so DeskRanger asks first. The search field at the top (Search on …) searches from the top of the home folder or of “/”; tap a result to open its folder. Editing files is on the Mac and the PC.
Tabs, this phone and copying on the phone
iPhone & iPad
This function is coming soon to iPhone & iPad.
Android
Under Files the phone shows one tab at a time. Tabs at the top right opens the list: switch the tab there, close it or open a new one with New Tab; the number of tabs you can open at once is limited. The three dots of a row open a device, a folder or a server with Open in New Tab. Your tabs stay after a restart.
This phone is the first place on the page. Pick a folder of this device with Add Folder…; DeskRanger shows only folders you add, and other devices cannot see them.
To copy between two devices, open the target folder in a second tab, go to the file in the first tab and choose Copy To in the three dots. The data goes straight from device to device; Transfers shows the path, and when the two devices cannot reach each other it also says the data goes through your phone. The same menu copies a file of this phone to a device and back. DeskRanger doesn’t copy directly between a server and a device yet. Drag files from another app in split screen onto the list and they are uploaded to that folder.
Arrived safely
DeskRanger checks every piece and the whole file with a checksum. If the connection drops, the transfer continues where it was. If the person at the other device ends the connection or cancels the transfer there, it stops, the row says “Ended on the device”, and DeskRanger does not reconnect by itself; Reconnect starts it again, and what arrived stays. A damaged file is not saved. Limits apply to file size and the number of simultaneous transfers.
If it doesn’t work
The person at the other device has not allowed files for this session. They can enable Transfer files on the other device in its live-session controls.
Too many transfers are already running in this direction. Wait until one is finished.
The file arrived damaged, and DeskRanger did not save it. Send it again.