Skip to content

Uploads and downloads

Upload whole folders with the Frameleaf CLI: API keys, dry run and albums Watch on YouTube

Add photos from your computer and take them back out whenever you like. The web app handles both through two panels, Uploads and Downloads, which sit in the bottom corner of the window and stay on screen while you keep browsing. Minimise them when you want more room.

For backing up a phone, use the iPhone and Android apps. For moving a whole library from another service, see Migrate. To save pictures and pages you find on the web, use the Save to Frameleaf browser extension, which saves into Boards.

  1. Select Upload in the top bar.
  2. Choose files or a folder, and optionally an album to put them in.

You can also drag files onto a library page, or choose Upload from computer inside an album.

Each file gets a row with its size and state:

State Meaning
Waiting In the queue
Uploading On its way, with a percentage
Uploaded In your library
Already in your library An identical file is already there. It’s recognised by its content and not stored twice. If the one in your library has lost its file, or its file is damaged, your upload is put in its place instead; see Uploading or importing the photo again
Error The upload failed, with the reason

From the panel you can:

  • Retry failed to upload the failed files again, to the same album or to Locked if that’s where they were going.
  • Cancel remaining to stop the files still waiting or on their way. Files already uploaded stay.
  • Clear finished to remove the uploaded and duplicate rows while the rest carry on.

Uploads keep going while you move between pages of the app, so you can carry on browsing. New photos can appear in your library before their thumbnails are ready; they fill in by themselves. To follow a large import, see Activity.

Upload into Locked and new photos are hidden from the moment they arrive. See Locked and private content.

Choose photos and their matching .xmp files together, or choose the folder that contains both. Frameleaf attaches each sidecar to its photo and reads its details; the sidecar does not become a separate library item. Unmatched sidecars are reported. The command-line tool also finds sidecars beside photos. See Attach a sidecar for naming, size limits and replacing one later.

Keep the tab open until your upload finishes. Reloading or closing it stops the files still waiting or on their way, and the panel starts empty afterwards.

Files that finished uploading are safely in your library. To finish the rest, simply upload the same files again: Frameleaf recognises the ones already there and skips them.

  • Download a single item to get its current version, which is the edited version if you’ve edited it.
  • Download original gets the untouched file of an edited item. In the viewer, open More actions to find it.
  • Several items, an album or a whole view download as zip archives. An archive bigger than your size limit is split into several parts, each with its own row.
  • The short video that belongs to a Live Photo or a motion photo comes with it when you turn on Include the short video with Live Photos and motion photos.

Each row shows what’s being prepared, then Save. A failed row offers Retry, and Cancel stops a download that’s still being prepared.

A prepared download lives in the tab you started it in, so save it before you reload.

Go to Settings, then Your preferences, then Downloads. Changes wait for the Save bar.

Setting What it does Default
Include the short video with Live Photos and motion photos Downloads get the moving part as well as the still Off
Add a details file beside each photo Adds a small file with the date, place and tags. The photo itself is not changed On
Split big downloads into files of Large downloads arrive as several zip files of this size, so one interrupted file doesn’t cost you the rest. Choose 2 GB, 4 GB (recommended), 10 GB or Custom, from 1 to 100 GB 4 GB

See Downloads.

The panels list only what you’re allowed to download:

  • A Locked item is downloaded or named only after you unlock your session.
  • A shared link offers downloads when its owner turns on Allow download.
  • Locking your session or signing out clears both panels.

To hand a photo straight to another app on your phone or computer, open it in the viewer and choose Send a copy…. It uses your device’s share sheet, up to 50 items and 500 MB at a time.