mirror of
https://github.com/narrrl/proton-drive-linux.git
synced 2026-11-22 10:33:31 +01:00
Places now draws the proton-map-rs basemap that Proton Gallery uses: seas by depth, lakes, rivers, built-up areas, borders and town names, in light and dark. Tiles render on two worker threads into the existing tile layer, so caching, ancestor stand-ins and density restarts work as before. Opening Places sends no request. The OpenFreeMap street map stays opt-in and replaces the basemap while it is turned on. Without the basemap file the map falls back to the coarse Natural Earth outlines. scripts/fetch-basemap.sh downloads basemap-v1.pmtiles and checks it against a pinned SHA-256. The deb, rpm, tarball, local and AUR PKGBUILDs, COPR spec and Nix package install it to /usr/share/proton-drive-linux. PDFS_BASEMAP points the app at another copy. The new credit and preference text is translated in every catalog.
130 lines
6.3 KiB
Markdown
130 lines
6.3 KiB
Markdown
# Photos
|
|
|
|
## How Photos is organized
|
|
|
|
Timeline, Albums, and Places share the same Photos workspace. The Timeline opens
|
|
with the media type, Filters, and, where available, **On this day**. Albums
|
|
contains the two collections **Proton albums** and **Drive galleries**. Add a
|
|
gallery by choosing a folder from **My files**. Opening it or any subfolder
|
|
keeps you in Photos. Back or Escape returns to the parent and its scroll
|
|
position.
|
|
|
|
**Hidden albums** opens with your Linux sign-in. The app uses the desktop
|
|
polkit prompt, so it needs a running authentication agent and the installed
|
|
polkit policy. Existing hidden albums remain hidden after upgrading. This view
|
|
includes hidden Proton albums and hidden Drive folders, including folders
|
|
inside public galleries. Leaving Hidden albums or switching away from the
|
|
window locks it and closes its previews.
|
|
|
|
For a system package, the policy is installed with the app. For a source build
|
|
or a per-user tarball install, have your system administrator install
|
|
`packaging/io.narl.proton-drive-linux.policy` (or the corresponding file under the
|
|
tarball's `share/polkit-1/actions/`) into the system polkit actions directory.
|
|
On NixOS, enable `security.polkit` and install the package system-wide to
|
|
register its policy.
|
|
|
|
GTK pages Timeline, Proton albums, and Places through the Drive daemon's Photos
|
|
control requests backed by its SQLite database. Saved Drive galleries come from
|
|
the shared Proton Gallery catalog, which the daemon hosts for the signed-in
|
|
account. Photos applies that catalog's visibility rules to public queries.
|
|
Hidden albums use separate, unlock-gated requests. Thumbnails in the hidden
|
|
view are kept in memory and cleared on lock.
|
|
|
|
Ctrl+mousewheel changes timeline tile size. GTK updates only the changed row
|
|
range and keeps the visible photo in place. As you scroll, each new page
|
|
updates the last affected section and adds new sections below it.
|
|
|
|
The **Photos** page of the app shows your Proton Photos library. Photos are stored apart from
|
|
My files, so they do not appear in `~/ProtonDrive`.
|
|
|
|
- [Timeline](#timeline)
|
|
- [Albums](#albums)
|
|
- [Places](#places)
|
|
- [Viewer and duplicates](#viewer-and-duplicates)
|
|
- [Importing from Google Photos](#importing-from-google-photos)
|
|
- [Fixing photos filed under the wrong date](#fixing-photos-filed-under-the-wrong-date)
|
|
|
|

|
|
|
|
## Timeline
|
|
|
|
- The timeline groups photos by day, month or year as you zoom. Drag the scrubber on the right
|
|
edge to jump through the years.
|
|
- **On this day** shows photos taken on the same date in earlier years.
|
|
- **Filters** narrow the timeline to images, videos or RAW files, to favorites, or to photos that
|
|
are in no album.
|
|
- **RAW + JPEG pairs** of the same shot show as one tile. The viewer switches between the two, and
|
|
moving the tile to the Trash removes both.
|
|
- **Upload** adds photos from this computer.
|
|
|
|
## Albums
|
|
|
|
**Albums** lists your own albums and the albums others share with you. Create, rename and delete
|
|
albums, and add or remove photos. Deleting an album keeps its photos in the timeline.
|
|
|
|
## Places
|
|
|
|

|
|
|
|
**Places** groups photos by the town they were taken in, as cards or on a map. Town names come
|
|
from [GeoNames](https://www.geonames.org/) data (CC BY 4.0) and the map from
|
|
[Natural Earth](https://www.naturalearthdata.com/) (public domain): seas by depth, lakes, rivers,
|
|
built-up areas, borders and town names, in light and dark. Both ship with the app as
|
|
`/usr/share/proton-drive-linux/basemap-v1.pmtiles`, so nothing is fetched online. Without that file,
|
|
for example in a build from source that skipped `scripts/fetch-basemap.sh`, the map shows coarse
|
|
land outlines only. `PDFS_BASEMAP` points the app at another copy.
|
|
|
|
A street map from [OpenFreeMap](https://openfreemap.org/) (© OpenStreetMap contributors) can be
|
|
turned on instead under **Preferences → General → Appearance**. It is off by default, because the map
|
|
server learns which areas you look at.
|
|
|
|
## Viewer and duplicates
|
|
|
|
- The viewer marks favorites, shows EXIF details, shows a photo on the map, and runs a slideshow
|
|
(F5).
|
|
- **Find Duplicates…** in the page menu lists byte-identical copies. Turn on **Similar** to also
|
|
find resized or re-encoded copies and burst shots.
|
|
|
|
## Importing from Google Photos
|
|
|
|
1. Request a [Google Takeout](https://takeout.google.com/) export of Google Photos and download
|
|
every `.zip` of it.
|
|
2. In the app, open the **Upload** menu on the Photos page and choose **Import from Google
|
|
Photos…**. Select all the `.zip` files at once, because a photo and its details are often in
|
|
different parts of the export.
|
|
3. Choose **Scan** to see what an import would do without uploading anything, then **Import**.
|
|
|
|
From a terminal:
|
|
|
|
```bash
|
|
pdfs import-google-photos --dry-run ~/Downloads/takeout-*.zip # show what would happen
|
|
pdfs import-google-photos --wait ~/Downloads/takeout-*.zip
|
|
```
|
|
|
|
What the import takes from the export:
|
|
|
|
- **Albums** are recreated. A photo that is in several albums is uploaded once and added to each.
|
|
- **Dates** come from the export's details, else from a date in the file name, else from the
|
|
photo's EXIF.
|
|
- **Places** come from the export, so imported photos appear under [Places](#places).
|
|
- **Favorites** are kept.
|
|
- **Live photos and motion photos** stay one photo: the video is filed with its still.
|
|
|
|
What it leaves out: photos in Google's trash, and files from other Google services (Drive,
|
|
YouTube) that are in the same export. A `.zip` that cannot be read is left out and named in the
|
|
report; the rest still imports.
|
|
|
|
Photos already in your library are skipped, so an interrupted import can simply be run again.
|
|
If the import was cut short, for example by a restart, the Import page offers **Resume**, and
|
|
`pdfs import-google-photos --resume` does the same without naming the archives again.
|
|
`pdfs import-status` shows how far an import is, and `pdfs cancel-import` stops it.
|
|
|
|
## Fixing photos filed under the wrong date
|
|
|
|
Photos from an earlier import sometimes sit under the day they were uploaded instead of the day
|
|
they were taken. `pdfs redate-photos --dry-run` finds those whose file name carries a different
|
|
date, and `pdfs redate-photos` fixes them.
|
|
|
|
Proton cannot change a capture date in place. So each fix uploads the photo again with the right
|
|
date and moves the original to the Trash. Favorites and albums are kept.
|