Skip to content

Switch from another photo app

Frameleaf Manager can bring a library across from eight other photo apps, with its photos, videos, albums and accounts. Manager only reads the other app. Its photos and its own data are left exactly as they were, so you can go back to it at any time.

App How Manager reads it
PhotoPrism From the app running on this server
Photoview From the app running on this server
PiGallery2 From the app running on this server
Lychee From the app running on this server
Nextcloud From the app running on this server
Piwigo From the app running on this server
LibrePhotos From the app running on this server
Ente Photos From a folder you export yourself

Coming from Immich or Noodle Gallery? Use Switch from Immich or Switch from Noodle Gallery instead. For Google Photos, iCloud Photos or plain folders, see Bring an existing library.

  • Your photos are copied. Manager copies each original into Frameleaf’s own Photos and videos folder and checks every copy. The other app’s folder isn’t changed. You need free space for a second copy of the library; the review tells you how much, as Media space required.
  • The other app is stopped while Manager works. Stopping it means nothing changes part-way through. If you cancel before the import starts, Manager starts the app again. Ente Photos is different: there’s nothing to stop, because you export it yourself.
  • Accounts come across. Each account in the other app becomes a Frameleaf account, with its own photos and albums. You give each one an email address to sign in with.
  • Private photos arrive in Locked. Private photos in PhotoPrism, and hidden photos in Ente Photos and LibrePhotos, go into Locked, behind a PIN. A private photo that was also archived goes back to the Archive when it’s unlocked.
  • A photo that was in the library twice comes across once. When one account holds the same file in two places, Frameleaf keeps one photo and puts it in every album either copy was in. A copy in Locked is the one that’s kept. The other copy’s own description, tags and favourite don’t come across, and the review says so.
  • Frameleaf builds its own thumbnails, search and faces in the background after the import. Follow that in Activity.
  • Use a new Frameleaf installation. The import is offered on Manager’s first screen, before a library is set up. It isn’t offered once Frameleaf is installed.
  • Run Manager on the server that runs the other app. Manager finds the app through Docker on that server. For Ente Photos, any server works.
  • Make your own backup of the other app’s photos and database.
  • Check the free space. You need room for a full copy of the photos, plus Frameleaf’s thumbnails and database.
  • Update the other app if you can. An up-to-date app is the most likely to have been tested. See Versions that haven’t been tested.
  1. Follow Install with Frameleaf Manager to start Manager and create your Manager administrator. Stop at Choose how to begin.
  2. Find the Import from another photo app card, marked Beta. It lists each app Manager found, with its version and database, such as “Version 240915 · SQLite”. If yours isn’t there, start the app and select Look again.
  3. Select your app, then Import from with the app’s name, for example Import from PhotoPrism.
  4. Manager explains that the app stays stopped while it reads the library. Select Stop PhotoPrism and continue (with your app’s name).
  5. Wait while Manager reads the library. You can close the page and come back. Nothing is imported yet.
  6. On Review your library, go through each part. See Review what comes across.
  7. Choose where your Frameleaf library goes, as for a new installation, then select Check and review import.
  8. On Review library import, check the number of photos, albums and accounts and the Media space required. Enter a Name, Email and Password for the Frameleaf administrator when Manager asks; the password needs at least 8 characters, and Manager must be open over HTTPS to set it.
  9. Tick I’ve reviewed the transfer and recovery information. and select Start import.

The steps at the top of the page are Choose an app, Review your library and Start import.

An app Manager can’t import yet is greyed out, with the reason under its name:

Manager says What it means
The app on that database isn’t supported yet Manager reads this app only from the databases listed in its section below.
Manager couldn’t tell which database the app uses The app’s settings don’t say. Check how the app is set up.
Manager couldn’t find the app’s database Check that its database container is running, then select Look again.
The database runs on a version Manager can’t copy yet The database container isn’t one Manager recognises.
Manager couldn’t find the login the app uses for its database The database user or password isn’t in the app’s settings.
The photo folder isn’t mapped into its container Manager can’t find where the photos are on this server.
The app keeps your photos in a Docker volume Imports need a regular folder on the server. Move the photos to a folder mapped into the app, then try again.
The photo folders overlap or are nested Manager can’t import that layout safely yet.

Review your library opens once Manager has read the app. Nothing has been imported at this point.

What Manager found counts the photos and videos, albums and accounts, and the size of the library.

What won’t come across lists every detail Frameleaf can’t keep, one line each, with how many photos or albums it affects. Read the list, then tick I understand these details won’t come across to Frameleaf. When nothing is lost, it says Everything Manager found comes across. The usual lines for each app are in its section below.

Accounts lists each account in the other app with its number of photos and videos. Enter the Frameleaf email each person will sign in with. Every account needs its own valid address.

An account that was limited in the other app shows why, for example:

  • This account is turned off in the app.
  • This account can’t sign in with a password in the app.
  • This account uses two-step sign-in in the app.
  • This account signs in through another service in the app.
  • This account can only see part of its library in the app.

Tick Import name**’s account anyway** to bring it across. Check afterwards who can sign in and what they can see; see Users.

Manager recognises an app by what it is, not by one exact version. When your version isn’t one Frameleaf has been tested with, the review opens with This version hasn’t been tested. Photos and albums should come across, and anything that can’t is listed. Manager suggests the version to upgrade to first for the best result.

  • Select Continue anyway to see what Manager found and carry on.
  • Select Cancel import to stop, upgrade the app, and start again.

Select Cancel import at any point before the import starts. Cancel this import? explains that Manager discards what it read and starts the app again. Nothing is imported, and the app’s photos and data stay as they were. Choose Cancel import to confirm, or Keep import to carry on.

Manager reads PhotoPrism from its built-in SQLite database or from MariaDB or MySQL.

Photos, videos, albums, accounts, descriptions, dates, places, favourites and the labels you added by hand (as tags) come across. Private photos arrive in Locked.

The review can list:

  • Albums PhotoPrism fills automatically, such as moments, months and searches, don’t come across. Other smart albums become regular albums holding the photos they show today.
  • Albums you deleted in PhotoPrism stay deleted.
  • Automatic labels don’t come across. Frameleaf’s search finds things on its own.
  • Named people and face groups don’t come across. Frameleaf finds faces again.
  • Photo titles don’t come across. Descriptions do.
  • Shared links and sharing between accounts don’t come across. Share again in Frameleaf.
  • A photo someone added to another person’s album stays with its owner, outside that album.

Manager reads Photoview from SQLite. Photoview on MySQL or PostgreSQL isn’t supported yet.

The review can list:

  • An album with photos from several accounts is split into one album per account.
  • Albums inside other albums come across side by side, without the nesting.
  • Favourites other people set don’t come across. Each owner’s own favourites do.
  • Named people and face groups, photo titles and sharing don’t come across.
  • Some photos have no time zone, so they keep the time exactly as recorded.

Manager reads PiGallery2 from SQLite or MySQL.

The review can list:

  • Saved searches don’t come across. Smart albums become regular albums holding the photos they show today.
  • Named people and face groups, photo titles and sharing don’t come across.
  • Some photos have no time zone, so they keep the time exactly as recorded.

Manager reads Lychee from SQLite.

The review can list:

  • Albums inside other albums come across side by side, without the nesting.
  • Smart albums become regular albums holding the photos they show today.
  • Tags on albums don’t come across. Tags on photos do.
  • Ratings other people gave don’t come across. Each owner’s own rating does.
  • Photos still waiting for approval in Lychee come across out of sight.
  • Photos with no recorded date use their file date instead.
  • Named people and face groups, photo titles and sharing don’t come across.

Manager reads the photos in Nextcloud’s Photos and Memories apps, from a Nextcloud that uses SQLite.

The review can list:

  • Live Photos come across as a separate photo and video. Rejoin them afterwards with Live Photo pairing; see After a big import.
  • A photo someone added to another person’s album stays with its owner, outside that album.
  • Nextcloud’s privacy settings and sharing don’t come across. Check who can see what in Frameleaf afterwards.
  • Nextcloud’s system tags don’t come across, and some tag names are tidied up, such as extra spaces removed.
  • Photos with no recorded date use their file date. Photos with no time zone show their time in UTC.

Manager reads Piwigo from MariaDB or MySQL.

The review can list:

  • Albums inside other albums come across side by side, without the nesting.
  • Photos their owner couldn’t see in an album are left out of that album.
  • Average visitor ratings, and ratings above 5 stars or from guests, don’t come across.
  • Rotations made in Piwigo don’t come across. Photos show the way their files are saved.
  • Album and tag links for photos missing from disk don’t come across.
  • Photos with no recorded date use their file date instead.
  • Photo titles and sharing don’t come across.

Manager reads LibrePhotos from PostgreSQL. Hidden photos arrive in Locked.

The review can list:

  • An album with photos from several accounts is split into one album per account.
  • Private photos are left out of the albums they were in.
  • Extra copies of the same photo in other folders are imported once.
  • Some grouped photos come across as separate photos.
  • Photos with no recorded date use their file date instead.
  • Named people and face groups, photo titles and sharing don’t come across.

Ente Photos keeps your library encrypted, so Manager doesn’t read it directly and never asks for your Ente password. You export your library with Ente’s own command-line tool, then point Manager at the folder. It works with ente.io and with a self-hosted Ente.

  1. On Choose how to begin, select Ente Photos on the Import from another photo app card. Three steps to bring Ente Photos across opens.

  2. Export your library. On a computer where Ente’s command-line tool is signed in to your account, run:

    Terminal window
    ente photos export ente-export
  3. Save the list of your files. This tells Manager which photos are yours. Run it in the same place:

    Terminal window
    ente photos file list --all --json > ente-export/ente-files.json
  4. Tell Manager where the export is. Put the ente-export folder somewhere Manager can reach, inside one of the folders it names, then enter its full path under Folder path, such as /mnt/user/photos/ente-export.

  5. Select Continue, then review and start the import as for an app on this server.

Manager only reads the export folder and never changes it. Your Ente account isn’t touched.

Only photos and videos you own come across. Anything other people shared with you stays in their library. Hidden photos arrive in Locked, and archived photos go to the Archive.

The review can list:

  • Hidden and archived albums come across as regular albums.
  • Some original file names don’t come across.
  • Shared links and sharing between accounts don’t come across.
  • Some photos have no time zone, so they keep the time exactly as recorded.

If the export isn’t quite like the ones Frameleaf has been tested with, the review says This version hasn’t been tested and suggests exporting again with a newer version of Ente’s tool.

When the import finishes, carry on in Manager to get the app and connect your phone, as in Install with Frameleaf Manager. Sign in to Frameleaf with the administrator you entered in the review.

Then check, before you retire the other app:

  • the accounts, albums and number of photos you expect, signed in as each person;
  • a sample of original photos and videos, opened at full size;
  • private photos, by unlocking Locked;
  • sharing, which starts fresh: share albums and add partners again in Sharing;
  • your backups.

Thumbnails, search and faces keep building in the background for a while after a big import.

Read the failure Manager recorded, fix the cause, then choose Resume safely. Resume the same import instead of starting a second one into the same place.

If an import won’t go through, import your originals from a folder instead. That brings the photos and videos, without the accounts and albums.

  • The other app’s sessions, API keys and sign-in providers don’t come across. People sign in to Frameleaf with the email address you gave their account.
  • Being an administrator in the other app doesn’t make someone an administrator in Frameleaf.
  • If an original is missing from the other app’s folder, Manager stops before importing instead of leaving a photo behind.
  • The Frameleaf apps for iPhone and Android replace the other app’s own apps.