# Uploads and downloads

Source: https://frameleaf.app/docs/using/uploads-and-downloads/

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](https://frameleaf.app/docs/using/mobile-apps/). For moving a whole library from another service, see [Migrate](https://frameleaf.app/docs/migrate/google-photos/). To save pictures and pages you find on the web, use the [Save to Frameleaf browser extension](https://frameleaf.app/docs/using/boards/#save-to-frameleaf-the-browser-extension), which saves into Boards.

## Upload

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

### Upload straight into Locked

Upload into Locked and new photos are hidden from the moment they arrive. See [Locked and private content](https://frameleaf.app/docs/using/private-content/#lock-a-photo).

### Sidecar files

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](https://frameleaf.app/docs/using/xmp-sidecars/#attach-a-sidecar) for naming, size limits and replacing one later.

### If you reload or close the tab

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.

:::tip
The iPhone and Android apps use resumable uploads, so an interrupted backup picks up where it stopped.
:::

## Download

- **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.

### Download settings

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](https://frameleaf.app/docs/using/account-settings/#downloads).

### What you can download

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

- A [Locked](https://frameleaf.app/docs/using/private-content/) 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.

## Send a copy

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.
