Preferences gains two pages for the config.json settings that had no place in the app: - Sync: the patterns every synced folder leaves out (own patterns, and each built-in one on or off), and what the conflict sweep may do. - Apps: which program opens which kind of file (open_with), and how the search launcher opens (prompt). Each synced folder kept on this computer gets "Excluded Files…" in its menu for its own .pdfsignore: checked as typed, "Check a path" says which rule decides, and a version changed elsewhere is never written over without asking. `pdfs sync ignore list|add|remove|reset|check` does the same from a terminal, and `--page preferences-sync` (and -apps, -storage) opens Preferences at a page. Every writer of config.json now goes through AppDirs::update_config, which reads, changes and writes under an flock on config.json.lock, so the app, the tray and the daemon no longer undo each other's change (B292). The opener reads its rules on each open, so a new rule applies without a restart. The built-in ignore list also leaves out what Nextcloud, Dropbox and Syncthing leave out: desktop.ini, .directory, trash folders, NFS/FUSE leftovers, partial downloads, Kate swap and office lock files.
3.0 KiB
User guide
How Proton Drive for Linux works and how to use it day to day. To install it, see Installation. If you are new, Getting started is the quicker read.
Topics
| Page | What it covers |
|---|---|
| Files and offline access | The ~/ProtonDrive folder, keeping files available offline, the Trash, earlier versions |
| Synced folders | Backing up local folders, excluding files, changes waiting to upload, conflicts, pausing |
| Photos | Timeline, albums, places, duplicates, importing from Google Photos |
| Sharing | Invitations, public links, items shared with you |
| Computers | Other computers in your account, syncing several computers |
| Search launcher and tray | Finding files from a keyboard shortcut, the tray icon |
Every command mentioned in these pages is listed in the command-line reference.
How it works
A background service, proton-drive.service, runs pdfs daemon. It holds your session, talks to
Proton Drive, and shows your Drive as a folder. Everything else asks the service to do things:
| Program | What it is |
|---|---|
pdfs-app |
The desktop app: files, photos, sharing, sync, preferences |
pdfs-tray |
Tray icon with status, pause and quick actions |
pdfs-prompt |
A search launcher for a keyboard shortcut |
pdfs |
The command-line client, for everything above and for scripts |
Your files, file names and photos are end-to-end encrypted by Proton. To show them to you, the service decrypts them on this computer and keeps a cache, which is not encrypted. Use full-disk or home-folder encryption. The security model lists exactly what is stored.
Words used in the app
The app uses these words, and so do these pages:
| Term | Meaning |
|---|---|
| My files | Everything in your Proton Drive, apart from Photos and computer backups |
| Proton Drive folder | Where My files appears on this computer, ~/ProtonDrive by default |
| Online only | A file or folder that downloads when you open it |
| Available offline | A file, or a folder with everything in it, kept on this computer |
| Synced folder | A local folder with a full copy on this computer, backed up to Proton Drive |
| Proton Drive service | The background service (proton-drive.service) |
Preferences
| Page | Settings |
|---|---|
| General | Start on login · Proton Drive folder location · upload and download limits · Proton theme, street map for Places, tray icon · language · check for updates |
| Sync | Files and folders every synced folder leaves out · what happens to identical conflict copies |
| Apps | Which program opens which kind of file · how the search launcher opens |
| Storage | Cache size limit · clear the cache · files kept available offline |
The account menu shows the storage you use and holds Sign Out…. Settings that are not in the app are described in Configuration.