Skip to content

Leaving Google Photos

Google Photos can be left, but what it hands you is a mess. This is the whole path from export to a library you can actually search, written for someone who has not used a terminal tool for this before.

There is no shortcut through an API: since March 2025 Google no longer lets other applications read your library, so Takeout is the only route out. That is fine. Takeout gives you the actual files, and files are what videre works on.

Go to takeout.google.com, deselect everything, then select Google Photos only.

Choose .zip, and set the file size to the largest offered. Fewer, bigger archives are much less tedious than dozens of small ones.

Google emails you when it is ready. For a large library this takes hours, and sometimes more than a day.

Download every archive and extract them all into one folder. If Google split your library across several files, they are meant to be merged back together.

Terminal window
mkdir ~/Takeout
cd ~/Downloads
for z in takeout-*.zip; do unzip -q "$z" -d ~/Takeout; done

You should end up with ~/Takeout/Google Photos/ containing folders like Photos from 2019 and any albums you made.

Look at the extracted folder and you will see three problems.

Photos without a camera date have today’s date. WhatsApp and Viber images, screenshots and scans carry no date of their own, so they arrive dated the day you unpacked the export. Their real dates, and often their places, are in the .json files sitting beside them, which most tools ignore.

Photos appear several times. A photo in three albums is exported three times, so a 40 GB library can extract to considerably more.

Edited photos appear twice. Every photo you edited in Google Photos comes as the original, IMG_1.jpg, and Google’s render of the edit, IMG_1-edited.jpg, side by side.

videre fixes all three.

Terminal window
videre import ~/Takeout

This changes nothing. It reports what it found:

Google Takeout at ~/Takeout
12,431 media file(s) in 84 folder(s)
11,902 matched a sidecar (95.7%)
529 unmatched, left untouched
11,902 with a capture date and 9,214 with a place; videre scan reads both

The percentage is the number to watch. Above about 95% is normal. Far below that suggests something unusual about the export, and is worth asking about before continuing.

Terminal window
videre --library ~/Takeout scan

This records what you have in a database at .videre/hashes.db inside the library. It reads every file, so on a large library it takes a while. A photo with no camera date takes its date, and a photo with no GPS its place, from its sidecar, so it lands on the right day and the right spot on the map. videre status shows how many dates came from sidecars. Your photos are not modified.

Then, to give the files themselves those dates, so any other tool sorts them correctly too:

Terminal window
videre --library ~/Takeout fix-dates

This one does change your files (only their modification times), so it asks first. See fix-dates.

Terminal window
videre dedupe review # look at what would go
videre dedupe trash # move the copies to the trash, once you agree

videre dedupe review writes a page, and prints its path, showing every duplicate group with KEEP and REMOVE badges; open it in your browser. Look before you delete.

This is where the album duplication disappears. Those copies are byte-identical, so removing them loses nothing at all.

The -edited renders are not byte-identical to their originals, so the step above leaves them. videre import counts them and says so; remove them with:

Terminal window
videre dedupe review --kind creation # each original beside its edit
videre dedupe trash --kind creation # keep the originals, trash the creations
videre dedupe undo # changed your mind? put the edits back

The original is kept because it is the file the camera wrote; the edit is Google’s re-encoded copy. Faces you named on an edit are not moved to its original. See dedupe --kind creation.

Optional, and the reason to bother with any of this:

Terminal window
videre embed # one-time, downloads about 1.5 GB
videre search "sunset over water"
videre faces # one-time, downloads about 180 MB
videre gallery # name the people
videre search --person "Alice"

Both steps take hours on a large library and can be interrupted with Ctrl-C at any point; rerunning continues where it stopped.

A folder you own, on a disk you control, with no account and nothing syncing. The photos are ordinary files: if you stop using videre tomorrow, they are exactly as they are now.

Terminal window
videre stats

Keep the Takeout archives until you have checked the result. Once you are satisfied, they are just a duplicate copy of what you already have.

If you add photos later, the same three commands bring them in:

Terminal window
videre --library ~/Takeout scan
videre embed
videre faces

See workflows for what needs what.