Files
proton-drive-linux/docs/FILES.md
T
nvrl d0f9681593 fix(trash): list a large trash, empty it, and browse it by folder
A large trash never finished listing, so the Trash page kept the rows of
the last refresh that got anywhere, and Empty Trash listed the trash before
sending the delete and hung there (B293). The paging fix is in
proton-drive-rs 0.12.5.

- The refresh reads only nodes it has not stored yet, without unlocking
  file keys, keeps the time the server says each was trashed, and drops
  rows only once the whole listing is in.
- Empty Trash sends the delete at once under the trash call time limit
  and clears the stored listing. Restore and Delete Permanently drop their
  rows right away.
- Schema v47 indexes trash.parent_uid and drops the stored rows once, so
  they are read again with real deletion times.
- The Trash page groups items by the folder they were deleted from, opens
  deleted folders through the new ListTrashedFolder request, and has a
  search box and a switch back to one list. Restore and Delete Permanently
  on a folder row act on everything deleted from it.
- pdfs trash takes --by-folder and --folder UID.
2026-11-22 02:38:48 +01:00

5.4 KiB

Files and offline access

Your Proton Drive appears on this computer as a folder, ~/ProtonDrive. Every file and folder in it is listed straight away, but a file only downloads when a program opens it. This page covers working in that folder, keeping files on this computer, the Trash, and earlier versions of a file.

Your Drive as a folder

~/ProtonDrive is your Proton Drive, called My files in the app. It is not a copy. A file you change there changes on Proton Drive, and a file you delete there goes to the Proton Drive Trash. Every program can use it, from your file manager to a terminal.

  • Only what you read is downloaded. A video player that seeks, or a tool that reads only the start of a file, downloads only those parts. Videos and music start playing before the whole file is down.
  • Changes are instant, online or offline. Creating, renaming, moving and deleting return at once. When a program saves and closes a file, the new content is stored on this computer and sent to Proton Drive in the background. Changes survive a lost connection, a crash or a reboot. See Changes waiting for Proton Drive.
  • Recently opened files are cached up to a size limit (5 GiB by default, set in Preferences → Storage). The oldest are removed first to make room.
  • Shared with me is a folder inside ~/ProtonDrive that holds what other people share with you. Shares where you are a viewer are read-only.

Proton Drive cannot store symbolic links, hard links, device files or FIFOs. A program that tries to create one gets an error at once. For a project that needs them, use a synced folder and exclude those paths.

To move the folder somewhere else, change Preferences → General → Location.

Keep files available offline

Files you mark Available offline are downloaded completely and stay on this computer, so they open without a connection.

  • In the app: select a file or folder in My files and turn on Available offline.
  • From a terminal: pdfs pin ~/ProtonDrive/Documents/Taxes

For a folder, every file in it and in its subfolders downloads in the background. The tray and the app show the progress. Preferences → Storage → Available offline and pdfs pins list what is kept.

Turn it off again with the same switch, or pdfs unpin PATH. This frees the space. The files stay on Proton Drive. A file inside a folder that is kept offline stays with its folder: turn the folder off instead.

Browse in the app

My files in the app

The My files page shows the same files without going through the folder. It has a grid and a list view, sorting, thumbnails (including camera RAW previews), multi-select, and drag and drop to upload. Details (Alt+Enter) shows the size, dates, sharing and version history of the selected item. For a folder, the size and the number of items in it come from Proton Drive and include items in the trash; pdfs du PATH prints the same.

Right-click an item for more. Make a Copy copies it into the same folder, and Copy To… copies it, or a whole selection, into another folder in My files. The copy is made on Proton Drive, so nothing is downloaded or uploaded, and a name already taken gets a " (1)" suffix. An item with changes that have not reached Proton Drive yet can be copied once they have. From a terminal: pdfs copy PATH... NEW_PARENT.

Trash

Deleted files go to the Trash, both from ~/ProtonDrive and from the app. The Trash page shows the folders things were deleted from, with how many items each holds and when the last one went. Open a folder to see what was deleted from it, and open a deleted folder to see what it held. The folder button in the header switches to one list of everything, newest deletion first, and the search box finds an item anywhere in the Trash by name.

  • Restore puts an item back where it was, together with any trashed folders above it.

  • Delete Forever and Empty Trash are permanent.

  • Restore or delete a whole folder row to act on everything deleted from that folder.

From a terminal: pdfs trash lists the Trash with an ID for each item, and pdfs restore, pdfs delete-forever and pdfs empty-trash take those IDs. pdfs trash --by-folder groups the list by the folder each item was deleted from, and pdfs trash --folder ID shows what a deleted folder holds.

Earlier versions of a file

Proton Drive keeps earlier versions of every file. Open them with Details → Versions… in the app, or pdfs versions list PATH. You can:

  • Restore a version. This happens on Proton Drive, so nothing is uploaded again.
  • Save a version to a separate file, without touching the current one.
  • Delete an old version permanently. The current version cannot be deleted.

Choose which program opens a file

The app and the search launcher open files with your desktop's default program (xdg-open). To open some file types differently, for example text files in Neovim inside a terminal, add open_with rules to config.json. See Configuration → open_with.