Import from Google Photos
Move from Google Photos with Takeout Watch on YouTube
Leaving Google Photos doesn’t mean leaving your memories’ details behind. Import from Google Photos brings a Google Takeout export into your Frameleaf library, with your original files and the details Google stores alongside them:
- the dates photos were taken
- descriptions and locations
- favourites and archived photos
- photos from Google’s Locked Folder
- album memberships
- Live Photos, with the photo and video kept together
Photos you already have in Frameleaf simply join their albums, without a second copy. The import runs on your server, in three steps: Upload, Check and Import. It moves on by itself, so you choose the ZIP files and press Import once.
Get your export
Section titled “Get your export”Export your Google Photos library with Google Takeout, and choose only Google Photos. For an upload from your browser, choose ZIP files. For an import from a folder on the server, ZIP or .tgz files both work, and so does an export you’ve already unpacked. Download every file of the export before you start, and keep them together. Google spreads a photo’s details, such as its date, place and albums, across different files of the export. You choose them all at once, and the import matches each photo with its details even when Google put them in a different file.
Open the import
Section titled “Open the import”Open Settings, then Import & export, then Google Photos. The Google Photos import page opens on where things stand: nothing imported yet, an import that’s running, one that’s waiting for you, or when your last one finished.
- Before you start has the three things to do first: Ask Google for your photos, Download every file and Add them all here.
- Your imports lists your earlier imports, each with its state, such as Checking, Ready to import or Complete. Select Open to carry on with one. Only you see your imports.
Select Import from Google Photos… to start. The Import from Google Photos window opens and shows the three steps. You can also search for Import from Google Photos.
Each new import is named after the day you start it, for example “Google Photos, 14 October”.
1. Upload
Section titled “1. Upload”Select Choose the ZIP files… and pick every ZIP file from one Takeout export.
The upload starts straight away and shows how much is uploaded and about how many minutes are left. Keep this page open until the upload finishes. You can Pause upload at any time.
If the upload stops, because the browser closed or the network dropped, open the import again from Your imports and select Choose the ZIP files…. Choose the same files: it carries on where it stopped, and files that are already on the server aren’t sent again. Frameleaf checks the parts already on the server against the file you chose, so a different file with the same name is refused rather than mixed in.
Each ZIP file needs to fit within your storage quota and the server’s free space.
Advanced: import from a folder on this server
Section titled “Advanced: import from a folder on this server”Administrators can skip the upload and import an export that’s already on the server. The folder can hold:
- the ZIP files of an export, including Google’s large ZIP files of 4 GB and more,
- the .tgz files of an export (also called .tar.gz),
- an export you’ve already unpacked, with its
TakeoutorGoogle Photosfolder.
The files are read where they are. Nothing is copied to the server first, and your files are never changed.
Put the export in the Imports folder
Section titled “Put the export in the Imports folder”Every server has an Imports folder, built into Frameleaf. It’s the imports folder inside Frameleaf’s storage folder, beside your library, and it’s always allowed. There’s nothing to set up. Nothing in it joins your library until you import it.
- On the Google Photos import page, open Advanced: import from a folder on this server.
- Imports folder shows where the folder is on your server. Select Copy to copy that path.
- Copy the ZIP or .tgz files, or the unpacked export, into that folder, over your network or on the server itself.
Choose the folder and import
Section titled “Choose the folder and import”- Beside Folder to import from, select Choose folder…. The Choose the folder to import from window opens on Allowed folders. Imports is always there, marked Built into Frameleaf.
- Open folders until you reach the one that holds your export. Under each folder you see what’s in it, for example “8 ZIP files · 41 GB”, “3 .tgz files · 12 GB”, “Google Photos folder” or “No Google export found”. Use the path at the top to go back.
- Select Choose this folder.
- Back on the page, check the folder and what was found, for example “3 .tgz files · 12 GB. Ready to check.”. Select Change to pick another folder.
- Select Import from this folder. It’s only offered when the folder holds an export.
The first step is then called Folder instead of Upload, and the import is listed under Your imports as From a folder on this server.
Import from another drive or share
Section titled “Import from another drive or share”To import from somewhere other than Imports, share that drive or folder with Frameleaf first. Other folders on the same page says which are allowed already.
- With Frameleaf Manager: select Add a folder in Manager…. On Manager’s Containers page, choose Add a folder…, pick the folder, and set Used for to Imports. Manager allows imports to read it, so there’s no variable to type. See Folders.
- Without Manager: mount the folder into the server and worker containers, and list it in
FRAMELEAF_IMPORT_ROOTS, a comma-separated list of absolute paths such asFRAMELEAF_IMPORT_ROOTS=/mnt/takeout. See Environment variables.
Each folder you allow appears in the folder chooser beside Imports.
Folders and archives are read without following links, and never from the rest of Frameleaf’s own library storage. Only administrators signed in to Frameleaf can browse or import server folders, never with an API key.
2. Check
Section titled “2. Check”The check starts by itself as soon as the last file is uploaded. It shows how many files it has read, for example “1,200 of 3,400 files read”.
The server reads each ZIP or .tgz file, or the unpacked folder, and matches every photo and video with Google’s details file for it (its sidecar). That includes translated folder names, Google’s shortened file names and sidecars that ended up in a different ZIP file of the same export. It also finds your albums, your Live Photos and the photos you already have.
You can close your browser. The check runs on the server, so with a large library you can come back later. It also shows in Activity.
A few things the check sorts out for you:
- Live Photos. When exactly one photo and one video share a name in the same folder, they’re linked as a Live Photo. When it isn’t clear which belong together, both files are still imported, just not linked.
- Two sets of details. When Google sent two sidecars for one photo, Frameleaf picks the most likely: the one whose title is the photo’s own name, then the one with the most details. You can choose yourself before you import.
- Unsafe files. Files with unsafe names or links, encrypted files and damaged data are refused and counted, never imported.
- Damaged archives in a server folder. A ZIP or .tgz file in the folder that is damaged, or isn’t a Google export, is counted as refused. The rest of the folder is still imported, along with any photos read from that file before the damage.
If the check stops with The check did not finish, select Check again.
3. Import
Section titled “3. Import”When the check finishes, the import is Ready to import. Nothing has been added to your library yet. You see what the check found:
| What it means | |
|---|---|
| New photos and videos | Added to your library. |
| Already in your library | Not copied again. They join their albums. |
| Albums | Made for you. |
| Live Photos | Photo and video kept together. |
Then choose what comes in:
| Option | What it does |
|---|---|
| Keep album memberships | On by default. Your Google albums are made here, with every photo in them, including photos you already had. Turn it off and no albums are made, and photos you already have are skipped. |
| Choose albums | Shows how many albums are ticked, for example Choose albums (12 of 14). Untick any you don’t want. Google’s year folders, such as “Photos from 2019”, start unticked. |
| Fill in missing details on photos you already have | Off by default. Adds dates, places and descriptions they’re missing. Nothing already there is changed. |
| Also bring in N photos from your Google Photos trash | Only shown when the export has photos from the trash. They’re left out unless you tick this. |
| Let me choose for N photos with two sets of details | Only shown when some photos came with two sidecars. See Photos with two sets of details. |
Dates, descriptions, locations, favourites and archived photos always come over, so there’s nothing to switch on. Photos from Google’s Locked Folder always go into Locked.
Select Import N photos to start. The import shows how many are done, for example “250 of 1,800 photos added”. It runs on the server, so you can close your browser here too. Select Pause to stop for a while, and Resume to carry on.
Photos with two sets of details
Section titled “Photos with two sets of details”If you turned on Let me choose for N photos with two sets of details, those photos wait while everything else is imported. Then you see each one with both sets of details: the date it was taken, its description and whether it has a place. Choose the right one for any you know. The rest get the most likely details. Select Add N photos to finish, or Later to come back to it.
With the option off, these photos get the most likely details straight away. You can correct a photo afterwards.
What happens during the import
Section titled “What happens during the import”- Each file is copied into your library. Your export files are never changed.
- A photo that’s already in your library (the same file, by checksum) isn’t copied again. It joins its albums and keeps its own date and details, unless you turned on Fill in missing details on photos you already have.
- A photo whose file was lost or damaged in your library gets its original back from the export. It counts as a photo you already had, so its details aren’t overwritten. See Uploading or importing the photo again.
- Running an import again, or retrying it, never creates a second copy of anything.
- Photos from Google’s Locked Folder go into Locked, and are locked before anything else is written to them. They don’t join albums, just as in Google Photos. While your session is locked, the import only says how many photos go into Locked. Unlock Locked to see them.
- Each step that fails is retried once automatically, and photos that couldn’t be added get one more attempt before they’re reported.
When it’s finished
Section titled “When it’s finished”The import tells you how many photos were added, for example 1,800 photos added, and sums up the rest: how many photos you already had joined their albums, how many albums were made and how many Live Photos were kept together.
If some photos couldn’t be added, they’re listed with the reason. Select Try again to retry them. If the import stopped before it finished, Try again carries on with the rest. What was already added stays in your library.
Select Download report to save a CSV file listing every photo and what happened to it, then Done.
Cancel an import
Section titled “Cancel an import”While the files upload, or once the check is done and before you import, you can select Cancel import. Select Cancel import again to confirm. It removes the import and what was uploaded for it. Photos already added to your library stay there.
Other ways to bring in photos
Section titled “Other ways to bring in photos”- From an iPhone or iCloud: Import from iCloud Photos.
- From a folder: Import from a folder.
- From another photo app: Bring an existing library.
© 2026 Frameleaf Inc. All rights reserved.
Frameleaf and the Frameleaf logo are Trademarks of Frameleaf Inc.
