mirror of
https://github.com/narrrl/proton-drive-linux.git
synced 2026-11-20 02:13:48 +01:00
Keep album browsing and private galleries inside Photos. Build GTK tiles near the viewport and anchor relayouts on the visible photo. Migrate the Photos cache to persist pending event work with its cursor. Pin the published Gallery engine for scoped private album reads.
118 lines
5.4 KiB
Markdown
118 lines
5.4 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 the Gallery passphrase stored for this account in
|
|
your Linux keyring. It includes hidden Proton albums and hidden Drive gallery
|
|
folders, including folders inside public galleries. Leaving Hidden albums or
|
|
switching away from the window locks it and closes its previews.
|
|
|
|
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). Both ship with the app, so
|
|
nothing is fetched online.
|
|
|
|
A street map from [OpenFreeMap](https://openfreemap.org/) (© OpenStreetMap contributors) can be
|
|
turned on 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.
|