Files
proton-drive-linux/docs
nvrl 1c50797772 feat(gui,core): modern Photos layout
Lay the timeline out in justified rows. Each photo keeps its own shape,
clamped between 1:2 and 5:2, and every row but a section's last spans
the width to the pixel. "Square Tiles" in the page menu restores the
even grid, and the Year zoom stays square. The zoom level and the
tile shape persist in a new `photos_view` config section.

Move Timeline/Albums/Places into the header as an icon-and-label
switch that shows only icons in a narrow window. The filters take a
single row whose kind tabs scroll sideways.

Selection mode follows GNOME apps:
- the header shows "N selected" and Cancel;
- an ActionBar along the bottom offers Favorite (or unfavorite), Add
  to Album, Remove from Album, Save Copies and Move to Trash;
- each section heading gets a check that selects the whole section.
One function, sync_header, decides the header for the page, an open
album or place, and selection mode.

The heading of the section at the top of the grid floats over the
grid. Favorites get a star badge, and video placeholders a video
glyph. New bundled icons: pdfs-photos, pdfs-album and pdfs-slideshow.

Upload takes several photos and videos at once, and files dropped on
the timeline upload too. The media type comes from the MIME database,
except that a recording-sized .ts counts as video.

The viewer's details panel moves into an OverlaySplitView that lies
over the photo below 800sp.
2026-11-14 02:40:38 +01:00
..
2026-11-02 15:18:39 +01:00
2026-11-05 19:12:21 +01:00

Proton Drive for Linux documentation

Proton Drive for Linux is an unofficial Proton Drive client for the Linux desktop. Your Drive appears as a folder that downloads files when you open them, local folders are backed up and kept in sync, and a GTK app with a tray icon and a search launcher covers Photos, sharing and more. A command-line client does all of it from a terminal.

These pages are also published as the wiki, generated from the docs/ folder of the repository.

Where to start

  • New here? Getting started takes you from installing to your first synced folder.
  • Installing or updating? Installation covers Fedora (COPR), Arch (AUR), Debian and Ubuntu, NixOS, and building from source.
  • Something not working? Troubleshooting starts with pdfs diagnose and goes through common problems.
  • New computer, or the old one is gone? Recovering on a new computer gets your synced folders back.
  • Quick question? Try the FAQ.

Using it

Page What it covers
User guide How the pieces fit together, the words the app uses, preferences
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

Reference

Page What it covers
Command-line reference Every pdfs command, grouped by task, and scripting with --json
Configuration config.json, environment variables, file locations, the systemd service
Security model What protects your files, what is kept on this computer, what the client connects to
Changelog What changed in each release

Contributing

Page What it covers
Development guide Building, running and debugging from source; common changes; releasing
Architecture Crates, the local tree, read and write paths, the queue, the sync engine, the control protocol, threads, threat model
Testing Unit tests, simulation runs and the FUSE acceptance suite
Translating Adding and updating translations
Roadmap Planned work and verification still owed
Bug ledger Every tracked defect with its analysis and status

Also see CONTRIBUTING.md, and SECURITY.md to report a vulnerability privately.