# iPhone and iPad

Source: https://frameleaf.app/docs/apps/iphone/

Frameleaf for iPhone and iPad backs up your camera roll to your own server, checks every photo arrived safely, and puts your whole library at your fingertips, at home or away. It's a native app with a built-in editor, widgets, Siri and Live Activities.

Install [Frameleaf from the App Store](https://apps.apple.com/us/app/frameleaf/id6821111014) on iPhone or iPad, then connect it to your server.

## What you need

- An iPhone or iPad on **iOS or iPadOS 26** or later. The background upload feature described below needs 26.1.
- A Frameleaf server you can sign in to.
- For Frameleaf Cloud services: a server linked to [Frameleaf Cloud](https://frameleaf.app/docs/cloud/overview/). You can also use your own [remote access](https://frameleaf.app/docs/admin/remote-access/) connection.

The app uses a dark theme, and one app covers both iPhone and iPad.

## Get started

Welcome has one button: **Continue with Frameleaf**. Enter your email and choose **Continue**. The app sends a 6-digit code, checked as soon as you type the sixth digit, or choose **Sign In with a Passkey**. If Frameleaf doesn't know your email yet, the same screen creates your free [Frameleaf account](https://frameleaf.app/docs/cloud/account/): add your country or region and accept the terms.

Signing in to your Frameleaf account happens entirely in the app; it never sends you to the browser. If your account has a passkey, an authenticator app or a password, Frameleaf may ask for one more step after the emailed code: "One more step: confirm it's you in another way". Choose from what your account has: **Sign In with a Passkey**, **Use a Code From My Authenticator App**, **Use a Recovery Code** or **Sign In with a Password**. **Send a New Code** emails another code, **Change Email** starts again, and **Recover Your Account** opens account recovery. Signing in pauses after 5 wrong codes. See [how signing in works](https://frameleaf.app/docs/cloud/account/#how-signing-in-works).

The first time you sign in without a passkey, the app offers **Sign In Faster Next Time**: choose **Create a Passkey** to sign in with Face ID or Touch ID from then on, or **Not Now**.

One Frameleaf sign-in opens every server on your account, ones you own and ones shared with you. They're all added at once, and the app signs in to each the first time you open it, with no second password and nothing to connect. If there's one server in reach, your library opens. Otherwise **Your Servers** takes Welcome's place for as long as you're signed in: choose a server to open, or pull down to check again. Its **Account** button opens your Frameleaf account, and **Not You? Sign Out** signs you out.

Under the button, **On This Wi-Fi** lists the Frameleaf servers on your network that aren't in the app yet, each with how you sign in to it ("Frameleaf or its own login", "Its own login" or "Set Up a New Server"), and **Enter a Server Address** comes last. The first time, choose **Look for Servers on This Wi-Fi**: the app explains why it needs your local network before iOS asks.

Choosing a server or entering an address opens that server's full-screen sign-in. On your Wi-Fi, the server's own email and password come first, then **Sign In with Frameleaf**; over the internet, Sign In with Frameleaf comes first. A server with its own sign-in provider (OAuth) also shows that provider's button, which opens the browser; a server that only offers its provider works too. No login for a server? The person who runs it adds you on its web page.

If your account uses [two-step sign-in](https://frameleaf.app/docs/using/two-step-sign-in/), signing in with a password then asks for the 6-digit code from your authenticator app, or a recovery code. iOS can fill the code from your password manager. Sign in with Frameleaf doesn't use the server's two-step sign-in: your Frameleaf account has [its own steps](https://frameleaf.app/docs/cloud/account/#how-signing-in-works).

### The discovery card

When a server on your Wi-Fi isn't in the app yet, a card slides up with its name, **Frameleaf server**, **New Frameleaf server** or **Not linked to Frameleaf Cloud**, and "Online · on this Wi-Fi". Choose **Sign In** (or **Set Up** for a new server), **Not Now** or **Don't Offer Again**. Nothing is typed into the card: **Sign In** closes it and opens the server's full-screen sign-in. Servers on your Frameleaf account are never offered, because they're already in your list.

If there are several servers, they page inside the same card. The card appears at most once per launch, only over Library or Collections, and never over the editor, a purchase or a permission prompt. Whether to back up this iPhone is asked later, inside the library: see [Back up your photos](#back-up-your-photos).

### Set up a brand-new server from your phone

On your home network you can claim a server that has no administrator yet. There's no setup code. Setup only works on the same Wi-Fi as the server, and only until it has an administrator, so set a new server up soon after installing it.

1. Choose **Set Up** on the discovery card, or the server's row under **On This Wi-Fi**.
2. **Name Your Server**.
3. Choose **Link to Your Frameleaf Account** and sign in with Frameleaf. You become the owner and don't need a server password. Setting up a server needs a passkey on your Frameleaf account; if you don't have one yet, the app asks you to **Add a Passkey** first.

On a server with Frameleaf Cloud, the app always uses Sign in with Frameleaf to create the owner. If you'd rather use a password administrator there, for example without a Frameleaf account, create it on the server's first-run web page instead. On a server without Frameleaf Cloud, the card asks you to **Set a Server Password**: your email and a password of at least 8 characters become a local administrator. That account works on its own, and you can reach it over a VPN or your own HTTPS server address. Optional Cloud services each have their own short setup, which you can do whenever you like.

### Local administrator password

After you pair a server with your Frameleaf account and its library opens, the app may ask you, as the owner, to choose a **Local Administrator Password**. It's the password you sign in to the server with at home when Frameleaf Cloud can't be reached. Enter at least 8 characters and choose **Set Password**.

**Not Now** closes the prompt; until the password is set, **Set a Local Administrator Password** stays in the account sheet under **Servers**. If the server's address starts with `http://`, the app warns first that the password will be sent without encryption, so continue only on a trusted local network.

### A server that's already linked

A server on your Wi-Fi that's already linked to a Frameleaf account is never set up or linked again. If it's on your Frameleaf account, it's already in your list. Otherwise its card shows **Frameleaf server** with **Sign In**, and **On This Wi-Fi** lists it with "Frameleaf or its own login". Both open its sign-in, where your Frameleaf account works because the server is linked. If the server has no administrator yet, the first sign-in of the account that owns it creates the administrator.

### Several servers

The account sheet lists every server on this iPhone and every other server on your Frameleaf account, with your role (Owner, Admin or User) and how the app is reaching it:

| Route | Meaning |
| --- | --- |
| **Home** | Your home network |
| **Direct** | A direct connection over the internet |
| **Relay** | The Frameleaf relay, part of [remote access](https://frameleaf.app/docs/cloud/remote-access/) |

The app picks the fastest route on its own and switches back to Home when it can. Tap a server to switch to it, and pull down to read your account's list again. To stop using the relay from this phone, turn off **Use the Frameleaf Relay** in **Settings**, then **Connection**.

**Manage Servers** in the account sheet lets you add, rename, reorder or remove servers, and choose which one this iPhone backs up to. **Sign Out and Remove** removes this phone's copy of that server's library, its caches and its upload queue. Nothing is deleted from the server.

### Servers behind a proxy

Most people never need this. A server at home, Frameleaf Cloud remote access and the Frameleaf relay all connect without it. It's only for a server you've put behind your own reverse proxy or access gateway that asks for extra headers or a client certificate (mutual TLS). Your server's administrator gives you what to enter.

In that case, open **Connection Options** on the server's page. It's also on **Enter a Server Address**, before you sign in, because a proxy can block even the first request.

- **Proxy Headers.** Choose **Add Header** and enter a name and value, such as Cloudflare Access's `CF-Access-Client-Id` and `CF-Access-Client-Secret`, or your proxy's shared token. The app sends them with every request to that server address: browsing, thumbnails, video, backup (including background uploads) and downloads. They're never sent to the Frameleaf relay or Frameleaf Cloud. Names the app or iOS sets itself, such as `Authorization`, `Host`, `Content-Length` and `Cookie`, are refused.
- **Client Certificate.** Choose **Add Certificate…** and pick a `.p12` or `.pfx` file from Files. You can also open the file in Frameleaf from Files or Mail: **Install Certificate** asks which server it's for and for its password. The password is used once to open the file and isn't kept. You can replace or remove the certificate later.

Headers and certificates are kept in the iOS Keychain. If the proxy refuses or revokes the certificate, or doesn't receive one, the app says the certificate was refused rather than that it can't reach the server.

Good to know:

- A certificate installed as a profile in the iOS **Settings** app can't be used by apps. Add it in Frameleaf instead.
- Signing in through the server's own OAuth provider opens the browser, which doesn't send the headers or the certificate. Behind such a proxy, sign in with a password or with **Sign In with Frameleaf**.
- A server with a client certificate is backed up by the app's own background uploads, not by iOS Photos' background upload feature, because Photos can't present a certificate. Backups still run in the background.
- The Android app has the same options. See [Servers behind a proxy](https://frameleaf.app/docs/apps/android/#servers-behind-a-proxy) on Android.

## Browse your library

- **Library** shows everything in one edge-to-edge grid, newest first. Pinch to change the size, or switch between **Years**, **Months** and **All**. The header shows the day and place you're looking at.
- **Times** are shown in the photo's own local time. A photo taken at 6:42 in Banff reads 6:42 wherever you are.
- **Press and hold** a photo for a preview with Favourite, Share, Add to Album, Save to iPhone, Hide and Delete.
- **Select** several photos to Share, Add To, Delete, or under **More**, Favourite, Hide, Lock or create a public link.

In the viewer, tap to hide the bars, double-tap or pinch to zoom, swipe down to close and swipe up for **Info**. The bottom bar has Share, Favourite, Info, Delete and Edit. Delete moves the photo to **Recently Deleted**.

**Info** shows the caption, date and time (with **Adjust** and a time zone picker), the camera and exposure, the file name and checksum, and a row showing whether the photo is on **this phone**, your **server** and **Cloud Backup**, each with the date since when.

### Search

Type in the search field to find places, things and the words in your photos. Before you type you'll see people, places, recent searches and suggestions. You can narrow results with tokens for a place, a year, photos or videos, and favourites.

Results come in two parts: instant matches from the copy of your library on the phone, then smart search results from your server, which understand what's in a photo. Text found in photos is highlighted in the results. See [Search](https://frameleaf.app/docs/using/search/) for how smart search works.

**Search In** above the results chooses what you search: **Photos**, **Spoken Words** or **Boards**. With **All**, a preview of spoken matches appears alongside your photos.

Choose **Spoken Words** to find what was said in your videos, once you've turned on [spoken words](https://frameleaf.app/docs/using/spoken-words/). Results are grouped by video, with each matching moment and its time; tap a moment to play the video from there. Place, year, media and favourite filters still apply. If indexing is off, the app says so and links to **Spoken Words Settings**.

### Frameleaf Assistant

When your server offers [Frameleaf Assistant](https://frameleaf.app/docs/using/search/#frameleaf-assistant-beta), you can ask about your photos in your own words. Open **Filters** in Search and, under **Search With**, choose **Frameleaf Assistant (Beta)** or **Classic Search**. One tap switches back, and the app remembers your choice for each account and server.

With the Assistant, the field reads "Ask about your photos". You get a short answer and the matching photos; tap a photo's caption to see **Why this matched**. If it can't answer, choose **Try Again** or **Classic search**. The Assistant searches your photos, not Boards, and needs a connection to your server.

### People, memories and collections

The **Collections** tab is for browsing:

- **Pinned** albums, people and pets you open often
- **Memories**: tap one to play it full screen. You can keep it, hide it ("Its photos stay in your library"), or ask to see less of a person, a type of memory or a date. **Make Highlight Video** renders a short video on your server; it stays private until you save it to your library.
- **Albums**: a shelf of covers, with a button to make a new album. The full Albums page is a cover grid. An album's menu renames it, locks it with **Lock Album…** or deletes it with **Delete Album…**. Press and hold an album and choose **Move…** to put it inside another album or collection.
- **People & Pets**: tap a face to see their photos. From a person's menu you can **Rename…**, **Set Birthday…**, **Merge With…** another person, or **Hide Person**.
- **Places**: a map of where your photos were taken
- **Media Types**: Favourites, Videos, Live Photos, Screenshots, Panoramas, RAW, Documents and Best Photos
- **Shared**: each partner's library, Shared Albums, Shared Links, and Invitations waiting for an answer
- **More**: Smart Albums, Folders, Archive, Locked and Recently Deleted

### Library Tools

The jobs that look after your library are in **Library Tools** in the account sheet: **Duplicates**, **Library Care**, **Import from Google Photos** and **Preservation**, then **Partners**, **Invitations** and **Groups** to manage who shares what. Each row says if something needs you. What isn't backed up from this iPhone is in [Backup](#back-up-your-photos), under **Not Backed Up**.

### Sharing

- **Partners** give someone on the same server their own copy of your whole library, including where photos were taken. Locked items arrive locked behind their own PIN.
- **Shared links** can have an expiry date, a password, and options to allow downloads and show details. Anyone with the link can open it without an account.
- **Shared spaces**: see members and their roles, invite people and remove them.

See [Sharing](https://frameleaf.app/docs/using/sharing/) and [Albums and shared spaces](https://frameleaf.app/docs/using/albums/) for how these work on the server.

### Boards

[Boards](https://frameleaf.app/boards), the workspace for references, mood boards and design files, has its own tab beside Library, Collections and Search (and Studio on iPad). Its home shows **Recently Saved**, your collections as cover cards, then **Links**, **Unfiled**, **Shared Spaces** and **Waiting to Save**.

- **Collections** nest as deep as you need. A collection's page shows the collections inside it, then its links, then its images and videos. Give each one a name, an icon and a colour.
- **File as you go**: choose **Select**, then **Add To**, **Remove** or **Delete**, with Undo. The picker drills down through your collections and only offers the ones you can edit.
- **Links** open in the browser, and you can edit their title, rating, tags and note.
- **Find by colour**: choose **Boards** under **Search In**, then pick one of 16 named colours or any colour, and how close the match should be.
- **Info** for a Boards item shows where it came from and its colours. Tap a swatch to find similar images or copy its hex value.

On iPad, drag items onto a collection, press ⌘N for a new collection and ⌘1 to ⌘5 to switch tabs.

## Back up your photos

The first time the library opens with nowhere to back up to, it asks **Back Up This iPhone?**: Frameleaf copies every photo and video to your server in full quality, new ones follow as you take them, and nothing is removed from the phone. Choose **Back Up to …** with your server's name, and iOS then asks which photos Frameleaf may see, or choose **Not Now**.

Open **Backup** from the account sheet. One sentence beside two thin rings says how this iPhone's backup stands:

- the **outer ring** (green) is the share of this phone's photos on your server;
- the **inner ring** (teal) is the share in [Cloud Backup](https://frameleaf.app/docs/cloud/cloud-backup/). Without a Cloud plan there's only one ring.

The number in the middle is the share on your server, and it reaches 100% once everything you chose is backed up. Below, top to bottom:

- **Now**: what's uploading and what's next, as photos, with one progress bar.
- **Needs You**: anything backup can't get past without you, each with its fix, such as **Use Mobile Data Once** for items waiting for Wi-Fi, **Back Up Anyway** in Low Power or Low Data Mode, **Allow All Photos** or **Choose Photos…** when Frameleaf can only see some photos, **Try Again** and **Retry All**.
- **Not Backed Up**: a grid of what isn't safe on the server yet, grouped as **Waiting**, **Couldn't Back Up** and **Not Included**, each with its reason. Tap a photo to **Retry**, **Skip** (with **Undo**) or **Include** it; its file name is under **Details**.
- **Library Health**: the server's last check of this iPhone's backup, any lost photos sent back, **Check Now** and **Library Care**.
- Your [backup choices](#backup-choices), which apply as soon as you change them.

The bar at the bottom holds the one thing to do: **Turn On Backup**, **Back Up Now** or **Resume Backup**, or **Pause** while it runs, with **Until Tomorrow** or **Until I Resume**. When everything is safe, there's no button.

Under **More**: **Keep Screen On** for a big first backup, which shows one large ring and keeps the screen awake but dimmed (keep the app open and plug the phone in), **Import from Files…** and **Free Up Space…**.

To see this iPhone's backup receipt from a computer, see [Your phones on the web](https://frameleaf.app/docs/using/mobile-apps/#your-phones-on-the-web).

While the app is open, uploads try a direct connection first and fall back to the resumable upload route. It all happens on its own and leaves your backup choices and iOS's background-upload limits as they are.

Backup sends nothing until it has confirmed it's talking to the same Frameleaf server, and that includes background uploads. If the server's address answers but isn't a Frameleaf server, for example because it now points at a different photo server, the app treats the server as unreachable. Backup says it's paused until your backup server answers as Frameleaf again. Nothing on the iPhone is lost, and backup resumes on its own.

If you go back to an older version of the app, such as an older TestFlight build, after a newer version saved the backup queue, Backup asks you to update Frameleaf to go on backing up. Nothing in the queue is lost. The offline library is rebuilt from the server, and your list of servers is kept.

### Every photo is checked

Each original is fingerprinted with SHA-256 on the phone, compared with what the server already has, and sent with a resumable upload. A photo only counts as backed up when the server's fingerprint matches. Identical files are uploaded once, and an interrupted upload picks up where it stopped.

Edits you made in Apple Photos are uploaded and **stacked** with their original.

### Lost photos come back

If your server has lost the original of one of your photos, the app looks for it each time you open it, and sends it back with your normal backup if this iPhone still has it. Nothing to tap. Only your own photos are looked for, and backup's network choices apply. See [Phones send lost photos back](https://frameleaf.app/docs/using/damaged-and-missing-files/#phones-send-lost-photos-back).

### Backup choices

The choices are at the bottom of **Backup**. There's no Save button: each one applies when you change it, and if it can't be saved it goes back and says so.

| Section | Choice | Default |
| --- | --- | --- |
| What to Back Up | **Photos**, **Videos** and **Edited Versions** (kept with the original, and shown first) | All on |
| When | **Photos on Mobile Data** | On |
| When | **Videos on Mobile Data** | Off |
| When | **Videos Only While Charging** | Off |
| When | **Pause in Low Power Mode** | On |
| When | **Pause in Low Data Mode** | On |
| Dates | **Only From a Date**: nothing taken before it is backed up | Off |
| Albums | **Photos to Back Up**: **Everything** or **Only Chosen Albums**, and **Sync Albums** | Everything |

If you use **Optimize iPhone Storage** in iCloud, the full originals are downloaded from iCloud first, on Wi-Fi. Backup shows how many iCloud originals are waiting.

### Albums, and what deleting does

**Albums**, in your backup choices, also holds **Sync Albums**. With it on, each album on this iPhone gets an album of the same name on your server, with every photo in it, including photos that were already there. An album on the server with the same name is used, never copied. Each album in the list says where it stands, such as "Syncs with the next backup". With it off, albums on this iPhone stay on this iPhone, and your photos are still backed up.

Deleting never syncs:

- Deleting a photo or an album on this iPhone never deletes anything on your server.
- Taking a photo out of an album here takes it out on the server only if Frameleaf put it there.

### In the background

iOS decides when apps can work in the background, so Frameleaf uses three ways to keep your backup moving:

- An overnight backup run when iOS allows it.
- **Back Up Now** keeps running after you leave the app, with the system's own progress display.
- On iOS 26.1 or later, when you leave the app, the remaining plain photos and videos are handed to iOS's own background upload. Backup shows how many were handed to iOS. This needs full photo library access. Live Photos, edited items and videos you only back up while charging stay with the app, and anything iOS hasn't uploaded after 24 hours is taken back by the app.

## Free up space

**Free Up Space** removes photos and videos from your iPhone once your server holds an identical copy, checked by SHA-256. You see a summary first, then confirm **Remove from iPhone**.

- Turn on **Only Items Also in Cloud Backup** to remove only what's also in Cloud Backup.
- Items stored only in iCloud are left alone.
- Removed items go to **Recently Deleted** in Photos, where you can get them back for 30 days.

:::caution[If you use iCloud Photos]
iCloud syncs deletions. Removing a photo from your iPhone also removes it from iCloud and every Apple device signed in to it. If iCloud is your second copy, use **Optimize iPhone Storage** in iCloud settings instead.
:::

To bring a photo back onto the phone, choose **Save to iPhone**. It downloads the original, with options to include the location and to save it as a JPEG for compatibility.

## Edit photos and videos

Tap **Edit** in the viewer. Edits never change your original: your server keeps each saved edit as a new version of the same photo, and you can always go back. See [Editing](https://frameleaf.app/docs/using/editing/).

The editor has five tabs: **Adjust**, **Looks**, **Crop**, **Clean Up** and **Masks**.

- **Adjust** has 17 dials in four groups: Light (Exposure, Brilliance, Highlights, Shadows, Contrast, Whites, Blacks), Colour (Saturation, Vibrance, Warmth, Tint), Detail (Sharpen, Definition, Noise Reduction) and Effects (Dehaze, Vignette, Grain). Tap a dial to switch it off while keeping its value.
- **Looks** shows nine styles on your own photo (Original, Vivid, Natural, Warm, Cool, Mono, Silvertone, Noir, Fade), each with a strength slider.
- **Crop** has a thirds grid, a straighten ruler, rotate, flip and aspect ratios Original, Freeform, Square, 4:5, 3:2 and 16:9.
- **Clean Up** lets you paint over what should go: **Heal**, **Clone**, or **Hide** to pixelate a face or number plate. Your server applies the fix when you save.
- **Masks** apply adjustments to part of the photo, up to eight per photo: **Brush**, **Radial**, **Linear** and **Subject**, which finds the main subject on your phone.

Press and hold the photo to see the original. Under **More** you'll find side-by-side Compare, the histogram, Copy and Paste edits, Revert to original and **Versions**, which lists every saved version. Showing an older version makes it current again; nothing is deleted.

You also get perspective correction, a video key-frame choice, Subject and Sky masks, Remove, Restore and Upscale. In Adjust, **Auto** finds white balance on the device, and **Eyedropper** samples a neutral area you choose. On iPad, Apple Pencil works with the drawing and mask tools.

For videos, the quick editor offers **Trim**, with an exact or fast cut. Use the web app or [Studio on iPad](#studio-on-ipad) for timeline editing.

### Edit many photos in another app

Select photos and choose **Edit in Another App** to start an editing batch. Export the originals to the app you develop in, then choose **Review Returned Files** and pick the finished files. You check how each file was matched before anything is imported, and each one becomes a new version. **Editing Batches** in Settings keeps every batch, so you can come back to one later. See [Editing](https://frameleaf.app/docs/using/editing/#many-photos-at-once).

### Studio on iPad

Studio turns your iPad into a video workspace. **Studio** sits alongside the other app tabs: open a project or make one from your library, then work with a multitrack timeline, playback, layers and text, audio, masks and drawing, and export. Local drafts let you keep working offline with media already on the device. Opening server media and uploading a result need a connection.

Your iPad handles playback and exports itself, and when a connected worker can handle the job, your server can render for you too. If an export isn't supported, such as some HDR output, Studio tells you why instead of quietly changing the result. See [Studio](https://frameleaf.app/docs/studio/overview/#on-ipad-and-android-tablets).

Studio is an iPad workspace. On iPhone you get the quick editor, and finished Studio videos show up in your library.

### Apple TV and wide windows

Collection pages have **Play on Apple TV**, and SharePlay lets you watch together. See [Apple TV](https://frameleaf.app/docs/apps/apple-tv/) for what you need.

The [iPhone Duo and wide-window guide](https://frameleaf.app/docs/apps/iphone-duo/) covers fold-aware layouts, a sidebar, multiple windows, drag and drop and Frame mode.

## Outside the app

### Widgets

- **Backup**: the rings, in small, medium and Lock Screen sizes. The medium widget has a Back Up Now or Pause button.
- **Memories**: small, medium and large.
- **Album or Person**: choose an album, a person or a pet.
- **Server**, for administrators: storage, whether it's online and how many jobs are waiting.

Widgets work in the tinted and clear Home Screen styles.

### Live Activities

- **Backup** progress on the Lock Screen and in the Dynamic Island, with a thumbnail, how many items are left and a Pause button.
- **Frameleaf Cloud setup**, showing the four setup steps after you add a plan.
- **Server jobs**, such as a finished export, a restore in progress or a long check.

### Controls, Siri and Spotlight

- **Controls** for Control Center and the Lock Screen: a **Back Up Now** button and a **Pause Backup** toggle. They work without opening the app.
- **Siri and Shortcuts**: say "Back up with Frameleaf", "Search Frameleaf", "Show my Frameleaf backup", "Open an album in Frameleaf" or "Play a memory in Frameleaf". The **Search Photos** shortcut shows up to 24 matching photos right in the result.
- **Spotlight** finds your albums, people, pets, memories and servers.

### Save to Frameleaf from other apps

Choose **Frameleaf** in the share sheet of another app to add up to 50 images and 20 videos at a time, optionally to an album. The files upload the next time Frameleaf runs.

Images and videos go to your photos unless you choose Boards; the share sheet asks first. Web pages are saved to Boards as links, with a collection, tags and a note if you like. Anything still waiting to upload is listed under **Waiting to Save** in Boards, where you can try again or remove it.

## App lock and Locked items

Turn on **Require Face ID** in **Settings**, then **App Lock**. Frameleaf asks for Face ID (or Touch ID, Optic ID or your passcode) when it opens and when you come back to it. **Ask Again** sets how soon: right away, or after 1, 5 or 15 minutes away. While it's locked, the app switcher shows no photos, and backup keeps running.

[Locked](https://frameleaf.app/docs/using/private-content/) items are protected by your account's six-digit PIN. You can set, change or remove the PIN in **Settings**, then **Sign-In & Security**, then **Password & PIN**, and move photos to Locked from the viewer or a selection.

To see them, open **Locked** in **Collections**, under **More**. It asks for Face ID (or your passcode), then your PIN, and only opens while you're connected to your server. Locked items stay on the server and are never kept on this iPhone, and closing Locked removes the images it showed.

## Offline

The app keeps a copy of each server's library catalogue on the phone, so dates, places and search keep working without a connection. **Settings**, then **Storage** shows how much space the offline library and the thumbnails use, and can clear the thumbnails and previews. The offline library is removed when you remove the server from the phone.

## Notifications

Your server can tell you when backup needs you, when something's shared with you, or when a video is ready. Notifications are encrypted by your server so that only your phone can read them. Turn each kind on or off per server in **Settings**, then **Notifications**:

- Backup needs attention
- Backup hasn't run for a while
- Cloud Backup setup
- Shared albums
- Memories
- Finished videos and exports
- Changes to your access

Notifications need your server to be linked to Frameleaf Cloud. A server that can't send them yet says so. See [Notifications](https://frameleaf.app/docs/using/notifications/).

## Settings

Open **Settings** from the account sheet. It's about you and this iPhone; each server has its own page.

- **You:** your profile picture and name, and **Sign-In & Security**, with **Password & PIN** (and **Sign Out Other Devices**), **Signed-in Devices** and **Linked Accounts**.
- **Library:** **Display**, **Memories** and **Downloads**, then the tools your server runs on your library: **Editing Batches**, **Spoken Words** and **Workflows**. Create, schedule, run and pause [workflows](https://frameleaf.app/docs/admin/workflows/), go back to an [editing batch](https://frameleaf.app/docs/using/editing/#many-photos-at-once), and turn on [spoken words](https://frameleaf.app/docs/using/spoken-words/). A tool your server can't run isn't shown. Advanced workflow steps from plugins are edited on the web, with **Open Web Workflow Editor**.
- **Notifications:** what your server tells you about, on this iPhone and by email.
- **This iPhone:** Backup, App Lock, Storage, Connection and Privacy.
- **Frameleaf Cloud Account:** your Frameleaf account, which is separate from your account on the server.
- **Advanced:** **API Keys** (the secret is shown once).
- **About:** the licence and Terms of Use, and **Rate Frameleaf on the App Store**, which opens the App Store's review page.

After a good moment, such as a backup that finished with everything on your server, saving edits or creating a share link, the app may show Apple's standard rating request. It waits until you've used the app for a few days, never shows after an error, and asks at most once per app version. iOS limits it to three times a year. Nothing about it goes to analytics.

### The server page

On a server you run, the account sheet has a row for it, with a dot for its health, that opens the server's page. Every server's page is also in **Manage Servers**; on a server you don't run, it shows the connection, whether this iPhone backs up there and how much of the server you use.

The page opens with a health card: one sentence, such as "Home Server is healthy" or "Home Server needs you", then a row for each thing that needs you, each going straight to its fix. They cover failed jobs, a nearly full disk, an update, maintenance mode, a failed database backup and an overdue restore test. Then come **Storage**, and under **Manage**, **People** (add, set roles and storage limits, reset passwords), **Activity** (live, with **Pause All**), **Backups & Restore**, **Updates** and **Remote Access & Frameleaf Cloud**.

Server settings come in two layers:

- **Topic pages**: **Sign-In**, **Email**, **Schedules**, **Video Quality**, **Trash**, **Storage Warning** and **Workflows**. They save as you change them, with Undo.
- **All Settings** has every setting, with search, and you review your changes before they're saved.

**Advanced** holds **External Libraries**, **Maintenance Mode** and the rarely used tools. Secrets such as passwords can be replaced but never shown again.

## Privacy

Your photos stay private. Frameleaf never sends photo content, search text, server addresses, filenames or Frameleaf account identifiers to Google Analytics, and advertising features and advertising and vendor identifiers are turned off.

Google Analytics is used only in the mobile apps and on the public Frameleaf website, never on your home server. In the app, usage analytics is off until you turn it on. To turn it on, open **Settings**, then **Privacy**, and switch on **Google Analytics**. It then covers app interactions, a random app-instance identifier, general location from your connection's IP address, and store purchase events. Switching it off again stops future collection and resets the app's local analytics data.

Crash reports and diagnostic usage data have their own switches, and they stay off until you turn them on. These diagnostics go to Sentry, the crash reporting service Frameleaf uses, which stores them in the United States. Each choice works on its own, so changing one never changes the others. See the [Privacy Notice](https://frameleaf.app/legal/privacy-notice/) for recipients, choices and deletion requests.

## Frameleaf Cloud in the app

The server owner can see Frameleaf Cloud plans from the account sheet: choose **Frameleaf Cloud**, then **Cloud Backup**. The purchase screen shows the storage allowance, price, renewal, sharing and cancellation terms, and purchases through the App Store use its billing controls.

A plan needs a licence on the server first. If the server has none, the plans screen says so and tells the owner where to add one: the server's settings, under **Frameleaf Cloud**, then **Licence**. With a licence, the price shown already includes its discount.

If Frameleaf pauses new plan sales, the plans screen says **New plans are paused** and has no Subscribe button. **Restore** and any plan you already have keep working. If plans can't load, **Restore** is still there under **Try Again**.

Cloud Backup has its own destination and recovery setup. Once it's running, Backup shows its status. If you see a storage-limit notice, follow it before adding more files. See [Cloud backup](https://frameleaf.app/docs/cloud/cloud-backup/#when-your-backup-grows).

## Delete your Frameleaf account

To delete your Frameleaf account, open the account sheet and choose **Frameleaf Cloud**, then **Frameleaf Account**, then **Delete Account**. It works even when no server is open: **Your Servers** has an **Account** button. See [Delete your account](https://frameleaf.app/docs/cloud/delete-account/).

## Moving from another photo app

Switching is easy:

1. Install Frameleaf and sign in to your Frameleaf server.
2. Grant the permissions it asks for.
3. Choose your backup albums and network preferences. Another app's login and settings don't carry over, so set these fresh.

Keep your previous backup until you've checked that the new one is complete.
