# Android

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

Frameleaf for Android backs up your phone to your own server, checks every photo arrived safely, and puts your whole library in your pocket, at home, away or offline. It's a native app with a full photo and video editor built in.

Install [Frameleaf from Google Play](https://play.google.com/store/apps/details?id=app.frameleaf.android), then connect it to your server.

## What you need

- A phone or tablet on **Android 11** or later.
- 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. On tablets and foldables the bottom bar becomes a side rail and the editor shows its controls beside the photo.

## Get started

Welcome has one button: **Continue with Frameleaf**, to sign in or create a free account. Enter the email for your [Frameleaf account](https://frameleaf.app/docs/cloud/account/) and 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 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, such as your password or the 6-digit code from your authenticator app. **Use a passkey instead**, **Email me a code instead** and **Use my password instead** switch between the ways your account has, **Send a new code** emails another code, and **Recover your account** opens account recovery. 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 your fingerprint, face or screen lock from then on, or **Not now**. You can add or remove passkeys later under **Passkeys** in Settings.

One Frameleaf sign-in opens every server on your account, ones you own and ones shared with you, with no second password and no Connect step. If one server is in reach, your library opens. Otherwise **Your servers** lists them: choose a server to open, or pull down to check again. **Not you? Sign out** signs you out.

Under the button, **On this Wi-Fi** lists the Frameleaf servers on your network, and **Enter a server address** comes last. The first time, choose **Look for servers on this Wi-Fi**; the app explains why before Android asks. It only looks for Frameleaf servers and doesn't read your Wi-Fi name.

Choosing a server or entering an address opens that server's 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 **Sign in with your organisation**, which opens the browser. Android can fill a saved password. No login for a server? Ask the person who runs it to add you; you can't make one in the app.

If your account on the server 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. Sign in with Frameleaf doesn't use the server's two-step sign-in: your Frameleaf account has its own steps.

### The discovery card

When a server on your Wi-Fi isn't in the app yet, a card slides up with its name and **Frameleaf server**, **New Frameleaf server** or **Not linked to Frameleaf**. Choose **Sign in** (or **Set up** for a new server), **Not now** or **Don't offer again**. Nothing is typed into the card: it opens the server's sign-in. A server you removed or declined is never opened by itself.

The first time the library opens with nowhere to back up to, the app asks **Back up this phone?** See [Back up your phone](#back-up-your-phone).

### 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 server's card, or its row under **On this Wi-Fi**.
2. **Name your server**.
3. **Link to your Frameleaf account** with **Sign in with Frameleaf**, and confirm with your passkey. You become its owner and administrator, with no server password to remember.

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, **Create the administrator** asks for your name, email and a password of at least 8 characters. 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**.

Until the password is set, **Set a local administrator password** stays in the account sheet under **Servers**. The password is only sent once the app has confirmed it's talking to your server; if it can't, try again at home or over the server's `https` address. 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 your Frameleaf account works there 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

Tap your picture to open the account sheet. **Servers** lists every server on this phone and every other server on your Frameleaf account, with your role (Owner, Admin or User) and how the app is reaching it, such as "Connected at home", "Connected directly", "Connected through the relay" or "Offline · can't reach it from here". The app tries every route at once and prefers your home network. Tap a server to switch to it.

**Manage servers** lets you add a server, reorder them, choose **Back up this phone here**, or sign out of one. Signing out of a server removes this phone's copy of its library, its caches and its upload queue. Nothing is deleted from the server.

You can be signed in to more than one Frameleaf account: **Add another Frameleaf account** is at the bottom of the account sheet, and each account's servers are kept in the list.

Over the relay, previews always load, but full originals and videos wait for a faster route unless you allow them in **Settings**, then **Privacy and lock**, under **Over the Frameleaf relay**. Both are off by default, and your server can still refuse them.

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

Open **Connection options** on **Enter a server address**, before you sign in, because a proxy can block even the first request. Later it's on the server's page, and you can change it there even while you're offline. The settings apply only to that server address on this phone.

- **Client certificate.** First install the certificate file your administrator gave you in Android's own settings: search Settings for **Install a certificate** and choose **VPN and app user certificate** (the wording varies by phone). Then choose **Choose client certificate** in Frameleaf and pick it from Android's list. A certificate your workplace installed on the phone appears there too. The private key stays in Android and Frameleaf never sees it. **Remove selection** stops Frameleaf using it.
- **Proxy headers.** Enter one header per line as `Name: value`, such as Cloudflare Access's `CF-Access-Client-Id: …` and `CF-Access-Client-Secret: …`. The app sends them with every request to that server address, background backup included, and never to any other address, the Frameleaf relay or Frameleaf Cloud. Headers the app sets itself, such as `Authorization`, `Host` and `Cookie`, can't be changed here.

Headers and the certificate choice are stored encrypted on the phone and removed when you remove the server. If the proxy turns the connection down, the app says so and points you here, rather than saying it can't reach the server. If a certificate has expired, been revoked or been removed from the phone, the app says the secure connection failed with it, so you can choose a current one or ask your administrator.

Good to know: **Sign in with your organisation** opens the browser, which doesn't send your proxy headers. Behind a proxy that checks headers, sign in with a password or with **Sign in with Frameleaf**.

## Browse your library

- **Library** shows everything in one grid, newest first. Pinch to change the size, switch between **Years**, **Months** and **All**, drag the fast scroller to jump through months, and pull down to refresh.
- **Times** are shown in the photo's own local time.
- **Press and drag** to select several photos, then Share (up to 30 at a time), Add To, Delete, or under **More**, Favourite, Archive, Lock or create a public link.

In the viewer, tap to hide the bars, double-tap or pinch to zoom deeply, swipe down to close and swipe up for **Info**. Press and hold a Motion Photo to play it. Delete moves the item to **Recently Deleted**, with Undo.

The viewer's **More** menu adds Find similar photos, Smart details, Text in this photo, Versions, Add tags, Rating, and **Why is this here?**, which shows which smart album rule added a photo.

**Info** shows the caption, date and time (with a time zone picker), camera and exposure, people, albums, the file name and checksum, and whether the photo is on **this phone**, your **server** and **Cloud Backup**.

### Search

Search finds photos by place, person, thing or the text in a photo. Narrow results with chips for place, year, photos or videos, person and similar photos, and **Narrow down** shows how many results each filter would leave.

Results appear in two parts: instant matches from the copy on your phone, then smart search results from your server. Text found in photos is highlighted. Searches also find **moments in your videos**, matched in the picture, caption or transcript. You can keep saved searches. See [Search](https://frameleaf.app/docs/using/search/).

Tap the **Spoken words** chip to find what was said in your videos, once you've turned on [spoken words](https://frameleaf.app/docs/using/spoken-words/). Each video shows its matching moments with their times; tap one to play the original from there. Place, year and people chips still apply. Saving the search and making a workflow from it aren't offered in this mode.

### Frameleaf Assistant

When your server offers [Frameleaf Assistant](https://frameleaf.app/docs/using/search/#frameleaf-assistant-beta), two chips in Search choose how you search: **Frameleaf Assistant** (marked **Beta**) or **Classic search**. With the Assistant, ask in your own words in the "Ask about your photos" field. You get a short answer with the matching photos, and each photo says why it matched. If it can't answer, **Classic search** is one tap away. Your choice is remembered for each account and server, Locked items aren't searched, and saved searches always use Classic search.

### Collections

The **Collections** tab is for browsing:

- **Pinned** albums, people and pets you open often
- **Memories**
- **Albums**: a shelf of covers, with **New album**. Press and hold an album to **Open** it, **Pin** it, **Share link**, **Delete album…**, or choose **Move…** to put it inside another album or collection. **Sort** orders albums by name, by most items or as on the server.
- **People & Pets**
- **Map**: your photos and videos where they were taken. The map uses the locations recorded in your photos, so it never needs your phone's current location.
- **Media types**: Favourites, Videos, Live Photos, Screenshots, Panoramas, RAW and Documents
- **Shared**: Partners, Shared spaces and Shared links from other people
- **More**: Smart albums, Folders, Tags, 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 the sharing you manage: partners, shared spaces with their invitations, and the public links you've made. Each row says if something needs you. See [Library Care on your phone](#library-care-on-your-phone).

### Boards

[Boards](https://frameleaf.app/boards), the workspace for references, mood boards and design files, is the fourth destination in the navigation bar: **Library**, **Collections**, **Boards** and **Search**. Its home shows **Waiting to save**, **All items**, **Links** and **Smart collections**, then your collections as cover cards with their icons and colours. Boards has its own search.

- **Collections** nest as deep as you need. A collection's page shows the collections inside it, then its pictures and links in one grid. Edit a collection's name, colour and icon, or move it with a drill-down picker.
- **Press and hold** to choose items, then **Add to**, **Move**, **Tags**, **Delete from Boards**, **Remove from collection** or **Share**, with Undo. The picker lists recent collections first.
- **Links** open in the browser, and you can edit their title, note, tags and rating.
- **Find by colour** with the **Colour** chip in Search: pick a named colour or type a hex value, and choose how close the match should be.
- **Info** for a Boards item shows its source, its pixel size and its colours. Tap a colour to search for it, copy its hex value, or add the item to a collection.

### Memories

Memories are grouped into On this day, Stories, Birthdays, People & pets and More. Tap one to play it full screen. You can keep it, rename it, hide it (its photos stay in your library), delete it, or ask to see less of a person, a type or a date.

**Make a highlight video…** renders a short video on your server: choose 15, 30 or 60 seconds, 720p, 1080p or 2160p, and whether to keep the videos' sound. Save it to your library or to the phone.

### Sharing

- **Partners** give someone on the same server their own copy of your whole library, Locked items included behind their own PIN. You don't get theirs unless they share too.
- **Shared links** can have an expiry date, a password, downloads and details. You can also show a link as a **QR code**.
- **Shared spaces** have members with roles, an activity feed with comments and likes, and **Show in my Library**. Accept, decline or leave invitations from **Invitations**.

### Smart albums

A smart album fills itself from a rule: people, media type, dates, or what's in the photos. Before you save, a preview shows how many items it would add. You can choose **Ask me before adding** to review each addition, **Also archive what it adds**, run the rule now or stop it.

## Back up your phone

The first time the library opens with nowhere to back up to, it asks **Back up this phone?**: Frameleaf copies the photos and videos on this phone to your server at full quality, new photos go up as you take them, videos wait for Wi-Fi unless you choose otherwise, and nothing is removed from the phone. Choose **Back up to …** with your server's name, or **Not now**. Turning backup on asks for access to your photos, then for notifications, and starts the first run.

Open **Backup** from the account sheet. A badge on your picture shows how backup stands on every tab, green when all is safe, and a strip above the navigation bar appears while backup runs or needs you.

On the Backup screen, one sentence beside two rings says how this phone's backup stands: the **outer ring** (green) is the share of this phone's photos on your server, and the **inner ring** (teal) is the share in [Cloud Backup](https://frameleaf.app/docs/cloud/cloud-backup/). The number in the middle is the share on your server. Below, top to bottom:

- **Now**: what's going up, with thumbnails and 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**, **Allow all photos** or **Choose photos** when Frameleaf can only see the photos you picked, **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 it, skip it (with **Undo**) or **Include** it; **Details** shows its file.
- **Library health**: the server's last check of this phone's backup, any lost photos sent back, **Check now** and **Library Care**.
- Your [backup choices](#backup-choices).

The button at the bottom is 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**: **Add from files**, **Free up space** and **Focus**, which keeps the screen on but dimmed during a big backup; plug the phone in to keep going.

Photos and videos people send you in WhatsApp, Telegram, Signal and similar apps are left out unless you turn on **Include messaging apps**, under **Not included**.

The app also tells you with a notification when your first backup has finished, when backup needs you, and when this phone hasn't backed up for 7 days.

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

### Every photo is checked

Each original is read with its location data, fingerprinted with SHA-256, 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 copies upload once. After a crash, a reboot or a network change, backup resumes without uploading anything twice.

Edits saved by gallery apps, such as `IMG_1-edited.jpg`, are **stacked** with their original.

### Lost photos come back

If your server has lost the original of one of your photos, the app sends it back with your normal backup if this phone still has it. Nothing to tap. It looks in two ways: each time you open the app, and once a day backup asks the server again about everything this phone has already backed up, and queues anything the server no longer has. **Back up now** and **Check now** ask straight away. 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

**Backup choices** are on the Backup screen.

| Choice | Options | Default |
| --- | --- | --- |
| **What to back up** | **Everything on this phone**, **Camera photos and videos only**, or **Folders I choose**. Any folder can be skipped under **Folders to skip** | |
| **Albums** | Whether folders on this phone become albums on your server. See [Albums, and what deleting does](#albums-and-what-deleting-does) | |
| **Kinds** | **Photos and videos**, **Photos only** or **Videos only** | Photos and videos |
| **From** | **Everything, however old**, or **From today on** | |
| **Only on Wi-Fi** | Never use mobile data | Off |
| **Videos wait for Wi-Fi** | Photos may use mobile data, videos wait | On |
| **Only while charging** | | Off |

Backup always waits while the battery is low. Photos you saved from the server to the phone are never backed up again.

### Albums, and what deleting does

**Albums**, in your backup choices, makes folders on this phone into albums on your server, with the photos already there. Under **Albums on the server**, choose **Off**, **All folders** (every folder except Camera and Screenshots) or **Selected folders**. Each folder says where it stands, such as "Joins at the next backup".

Deleting never syncs: deleting a photo on this phone never removes it from the server.

### In the background

- **Every hour** the app catches up on anything new, within your network and charging rules.
- **About 30 seconds** after you take a photo, a backup is triggered.
- **Back up now** keeps running after you leave the app.

While a backup runs, its progress shows in a notification with the number of items to go and your server's name, never a file name, and a Pause button. On Android 16 it's a Live Update at the top of the screen.

If something's in the way, **Needs you** says what, and Backup also warns about battery optimisation, local network access being off and photo locations being hidden.

### Check this phone's backup

**Check now**, under **Library health** on the Backup screen, asks your server whether everything this phone backed up is still there, and backs up again whatever isn't. The same check is in **Settings**, then **Account and backup devices**, as **Check this phone's backup**, where you confirm with your PIN or password. That page also lists the devices that back up to this server.

## Free up space

**Free up space**, under **More** on the Backup screen, removes items from your phone only when your server holds an identical copy, checked by SHA-256, and its last check didn't fail. It shows you the photos first.

- **Keep favourites** and **Keep the last 30 days** are on by default.
- **Also in Cloud Backup** removes only what your server has also copied to Cloud Backup.
- Each file is checked again just before it's removed, and removed items go to the phone's trash, not straight to permanent deletion.

:::caution[WhatsApp and similar apps]
Chat apps show media from files on the phone. Backup leaves messaging apps' folders out unless you turn on **Include messaging apps**. If you do, and then free up space, those images disappear from your chats and are only visible in Frameleaf.
:::

## Bring in photos from elsewhere

- **Save to Frameleaf** appears in other apps' share sheets. Share one or many photos and videos, pick or create an album, and save. Items the server already has are recognised and not sent again. Images and videos go to Photos unless you choose Boards, and a shared web page is saved to [Boards](#boards) as a link, with a collection, tags and a note.
- **Add from files**, under **More** on the Backup screen, brings in photos from a memory card, a USB drive or a files app. The files are copied first, so you can unplug the card once the upload has started.
- **Import from Google Photos** takes your Google Takeout files: add them, scan, review any conflicts, then import. Photos already in your library are matched rather than copied again, and albums, favourites, archive, Locked, places, dates, descriptions and Live Photos come across. You can pause, resume or remove an import. See [Google Photos](https://frameleaf.app/docs/migrate/google-photos/).

## Edit photos and videos

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

### Photos

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

- **Adjust** has 17 dials: Light (Exposure, Brilliance, Highlights, Shadows, Contrast, Whites, Blacks), Colour (Saturation, Vibrance, Warmth, Tint), Detail (Sharpen, Clarity, Noise Reduction, Dehaze) and Effects (Vignette, Grain). You can type an exact value on a ruler.
- **Looks** shows nine styles on your own photo, each with a strength slider. **Save as preset** keeps your own.
- **Crop** has a straighten ruler, rotate, flip and aspect ratios Original, Freeform, Square, 4:5, 3:2 and 16:9.
- **Clean Up**: paint over what should go with **Heal**, **Clone** (drag the ring to choose the source) or **Hide** to pixelate.
- **Masks**: up to eight per photo, **Brush**, **Radial** and **Linear**, plus Subject and Sky masks. You also get perspective correction, Remove and Restore.

Under **More**: Compare, the histogram, Copy and Paste edits, and Revert to original. On Android 13 and later, every dial previews live; on Android 11 and 12, some do.

### Videos

The video editor has **Trim**, **Adjust**, **Looks**, **Turn** and **Sound**:

- **Trim:** **Exact** re-encodes on the frame you choose; **Fast** cuts at the previous keyframe without re-encoding.
- **Adjust** and **Looks:** the photo dials and looks, plus a black-and-white look for video.
- **Turn:** rotate 90° or flip.
- **Sound:** volume from 0 to 200%, or mute.
- **Speed:** 0.25×, 0.5×, 1×, 1.5×, 2× or 4× for the whole clip.

HDR videos are edited to a standard-range version, and the HDR original is kept.

### Develop in another app

For RAW files, **Develop in another app** sends the original to an app of your choice through the system file picker. **Bring back a developed file…** adds the result as a new version.

Select several still photos to do the same for a whole shoot. Share the originals, then choose the returned files or a whole folder. You check how each file was matched, skip any you don't want, and confirm before anything is imported. Each file becomes a new version, and if one fails, the others still come back; you can retry just the failed ones. **Editing batches** in Settings keeps every batch. See [Editing](https://frameleaf.app/docs/using/editing/#many-photos-at-once).

### Restore and upscale

**Restore and upscale** improves old or damaged photos and videos. Choose **Faithful** or **Creative**, whether to keep film grain, whether to upscale, and **Smooth motion** to add in-between frames to video. Then choose where it runs: a GPU computer at home, which stays on your network, or [Cloud GPU](https://frameleaf.app/docs/cloud/cloud-gpu/). You see an estimate and a preview first, and the original is never replaced.

## Keep your library offline

The app always keeps a searchable copy of each server's catalogue, so dates, places and search work without a connection. **Keep offline** decides how many pictures it also keeps, per server:

| Option | What's kept |
| --- | --- |
| **Catalog only** | The catalogue, with a 256 MB working cache |
| **Travel** (default) | Small pictures of everything, plus full-screen pictures of the last 3 months |
| **Everything** | Small and full-screen pictures of everything |

Set a space limit of 1, 5, 10, 25 or 50 GB (5 GB by default). Pictures download on Wi-Fi when the battery is fine, newest first. Locked items are never kept offline. Without a connection, the library shows "Offline · showing this phone's copy".

## Outside the app

- **Widgets:** **Backup** rings (from 2×2; wider shows "12,348 of 12,480" and the Cloud Backup share), **Memories**, an **Album or person** slideshow (people and pets) and **Server** for administrators (storage and jobs waiting, 3×2). They refresh every 6 hours.
- **Live Updates:** backup progress and Cloud Backup setup appear as Live Updates on Android 16.
- **Quick Settings tile:** **Back up now**, showing how many are left while it runs.
- **App shortcuts:** long-press the icon for Back up now, Search and Favourites.
- **Themed icon:** the icon follows your themed icon setting.

## Library Care on your phone

From **Library tools** in the account sheet, **Collections** and a photo's **More** menu:

- **Duplicates:** one group at a time, bursts included, with a suggested keeper. Choose Keep, Don't keep, Stack or Not duplicates. Favourites, albums, ratings, descriptions and people carry over to what you keep, and recent decisions can be undone.
- **Recently Deleted:** restore, delete for good, or empty. **In Cloud Backup** lists items deleted from the server that a Cloud Backup still holds, so you can bring them back.
- **Library Care:** check for damaged files and replace them with a verified copy while keeping the damaged one; find and relink missing originals; rejoin Live Photos; and list RAW files your server can't read. See [Library Care](https://frameleaf.app/docs/using/library-care/).
- **Preservation:** make a package of your originals with checksums and their details, optionally with Locked items. Verify it, download it or restore from it. Restoring never replaces originals you already have.
- **Documents:** receipts and letters your server recognised, with the text read from each line. Confirm, correct or hide lines.
- **Smart details:** a photo's AI description (write it again, or use your own), AI tags, text in the photo, and a sensitive-content flag you can correct.

## App lock and Locked items

Turn on app lock in **Settings**, then **Privacy and lock**. Frameleaf uses your fingerprint, face or screen lock, and you choose when it asks again: right away, or after 1, 5 or 15 minutes. On Android 13 and later, the preview is hidden in Recents. The phone needs a screen lock first.

[Locked](https://frameleaf.app/docs/using/private-content/) items always ask for your account's six-digit PIN, even with app lock off, and screenshots are blocked on Locked screens and in the editor. Set, change or remove the PIN in **Settings**, then **Profile and security**.

## Notifications

Notifications are encrypted by your server so that only your phone can read them, and Frameleaf's push service can't. Turn each kind on or off per server: backup needs you, backup hasn't run in a while, Cloud Backup setup, shared with you, memories, videos and edits ready, and access changes. Notifications need the server linked to Frameleaf Cloud. See [Notifications](https://frameleaf.app/docs/using/notifications/).

## Settings

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

- **You:** your name and email, and **Sign-in and security**, with **Password and PIN**, **All signed-in devices** and **Linked accounts**. **Passkeys** lists the passkeys that sign you in to Frameleaf, with **Add a passkey**.
- **Library:** **Preferences** (memories, people, emails, downloads), then **Workflows**, **Editing batches** and **Spoken words**: create, schedule, run and pause [workflows](https://frameleaf.app/docs/admin/workflows/) (also from a search, a saved search or an album with **Add matching photos here**), go back to an editing batch, and turn on [spoken words](https://frameleaf.app/docs/using/spoken-words/).
- **Notifications:** what reaches this phone and what is emailed.
- **Backup**, **Storage** (space used on this phone, **Keep offline** and the picture cache) and **Privacy and lock**.
- **Frameleaf Cloud account:** your Frameleaf account, which is separate from your accounts on your servers.
- **API keys** and **About**.

### The server page

On a server you run, the server's 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.

Under **Manage** are people (add, set roles and storage limits, **Reset password**), activity (with **Pause all**), **Backups and restore**, **Updates** and **Remote access and Frameleaf Cloud**. Server settings come in two layers:

- Topic pages for **Sign-in**, **Email**, **Schedules**, **Video quality**, **Trash** and **Storage warning**, in plain words.
- **All settings** has every setting the server has, with search, and you review your changes before they're saved. If the server refuses a change, its reason is shown with it.

**Advanced** holds **External libraries** and maintenance mode. Passwords and secrets can be replaced but never read. A few actions, such as restoring a database backup, stay on the web.

## 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 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 lock**, 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.

**Send crash reports and usage data** is a separate switch, and it stays off until you turn it on. These diagnostics go to Sentry, the crash reporting service Frameleaf uses, which stores them in the United States. Each switch works on its own, so changing one never changes the other. 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 **Frameleaf Cloud** in the account sheet. The purchase screen shows the storage allowance, price, renewal, sharing and cancellation terms, and purchases through Google Play use its billing controls.

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

## On a TV

### Play on the Frameleaf TV app

With the [Android TV app](https://frameleaf.app/docs/apps/android-tv/) open on your TV, choose **Play on TV** on an album, person, pet, Favourites or memory page, then the TV's name. The phone and the TV need to be on the same Wi-Fi and signed in to the same Frameleaf account. See [Play from your phone](https://frameleaf.app/docs/apps/android-tv/#play-from-your-phone).

### Google Cast

Send any photo or video to your TV with Google Cast:

1. Open a photo or video.
2. Choose the cast button, then your device.
3. Choose the cast button again to stop.

The cast button appears when a compatible device is on your network, or while you're already casting. Casting uses Google Play services.

Your TV loads the media itself, so casting needs the item to be in one of your shared links, a connection other than the relay, and casting left on by your administrator. See [Casting](https://frameleaf.app/docs/using/casting/).

## Studio on tablets

Studio turns your tablet into a video workspace. Open **Studio** to create or open a project, then work with a timeline, playback, layers and text, audio, masks and drawing, and export. The tablet plays and exports its supported media itself.

Local drafts and downloaded media let you keep working offline. Opening server media and uploading results need a connection.

When a suitable worker is connected, your server can render for you too. If a format or HDR output isn't supported, Studio tells you why. See [Studio](https://frameleaf.app/docs/studio/overview/#on-ipad-and-android-tablets).

Studio is a tablet workspace. On a phone, the app says **Studio is available on tablets**, and the videos you export on a tablet appear in your library on the phone.

## Delete your Frameleaf account

To delete your Frameleaf account, open **Settings**, then **Frameleaf Cloud account**, then **Delete Account**. The row is there whenever you're signed in to Frameleaf, even with a server connected. 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.
