# Import from Google Photos

Source: https://frameleaf.app/docs/migrate/google-photos/

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

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](#advanced-import-from-a-folder-on-this-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

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

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

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 `Takeout` or `Google Photos` folder.

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

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.

1. On the **Google Photos import** page, open **Advanced: import from a folder on this server**.
2. **Imports folder** shows where the folder is on your server. Select **Copy** to copy that path.
3. 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

1. 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**.
2. 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.
3. Select **Choose this folder**.
4. 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.
5. 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

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](https://frameleaf.app/docs/admin/manager/#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 as `FRAMELEAF_IMPORT_ROOTS=/mnt/takeout`. See [Environment variables](https://frameleaf.app/docs/admin/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

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

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](#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

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

- 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](https://frameleaf.app/docs/using/damaged-and-missing-files/#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

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

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

- **From an iPhone or iCloud:** [Import from iCloud Photos](https://frameleaf.app/docs/migrate/icloud-photos/).
- **From a folder:** [Import from a folder](https://frameleaf.app/docs/migrate/from-a-folder/).
- **From another photo app:** [Bring an existing library](https://frameleaf.app/docs/migrate/from-another-library/).
