# iPhone and Android apps

Source: https://frameleaf.app/docs/using/mobile-apps/

Frameleaf has native apps for iPhone and iPad and for Android. Both back up your phone to your server, check every upload against the server's copy, and let you browse your whole library at home, away or offline.

Follow the [iPhone and iPad guide](https://frameleaf.app/docs/apps/iphone/) or [Android guide](https://frameleaf.app/docs/apps/android/) to install. You can also open your server's web app in your phone's browser to browse, search and upload.

| | iPhone and iPad | Android |
| --- | --- | --- |
| Needs | iOS or iPadOS 26 or later | Android 11 or later |
| Guide | [iPhone and iPad](https://frameleaf.app/docs/apps/iphone/) | [Android](https://frameleaf.app/docs/apps/android/) |

## Watch and edit on other screens

- [Apple TV](https://frameleaf.app/docs/apps/apple-tv/) browses your server library and plays photos, videos and memories. It signs in and reaches your library through Frameleaf Cloud remote access.
- [Android TV](https://frameleaf.app/docs/apps/android-tv/), on [Google Play](https://play.google.com/store/apps/details?id=app.frameleaf.android), does the same on Android TV and Google TV.
- [Frameleaf Desktop](https://frameleaf.app/docs/apps/desktop/) for Mac, Windows and Linux opens your library in its own window, lets your computer help with AI work and copies photo folders to your server.
- [Studio on iPad and Android tablets](https://frameleaf.app/docs/studio/overview/#on-ipad-and-android-tablets) gives you a full native timeline workspace, alongside quick editing on a phone.
- The [iPhone Duo and wide-window update](https://frameleaf.app/docs/apps/iphone-duo/) brings fold-aware layouts, multiple windows, drag and drop and Frame mode.
- [Casting](https://frameleaf.app/docs/using/casting/) covers Google Cast from Android and the web, and playing from your phone on the Frameleaf TV apps.

## What both apps do

- **Connect** with your Frameleaf account, by finding a server on your Wi-Fi, or by typing a server address. You can even set up a brand-new server from your phone, on the same Wi-Fi, and join a server that's already linked with Sign in with Frameleaf.
- **Back up** your camera roll. A photo only counts as backed up when the server's SHA-256 fingerprint matches the phone's.
- **Free up space** by removing photos from the phone once the server holds an identical copy.
- **Edit** photos with Adjust, Looks, Crop, Clean Up and Masks, without ever changing the original, or send a batch of originals to another app and bring the results back as versions.
- **Search spoken words** in your videos and play from the moment they were said.
- **Ask in your own words** with [Frameleaf Assistant](https://frameleaf.app/docs/using/search/#frameleaf-assistant-beta), when your server offers it, with Classic search one tap away.
- **Automate** with [workflows](https://frameleaf.app/docs/admin/workflows/) that add matching photos to albums or tag them, after changes or on a schedule.
- **Share** with partners, shared links and shared spaces.
- **Lock** the app with your face, fingerprint or passcode, and keep [Locked](https://frameleaf.app/docs/using/private-content/) items behind your PIN.
- **Widgets**, backup progress on the Lock Screen, and quick backup controls.

## How backup works

Backup is the same idea on both phones. The details of each screen are in the [iPhone](https://frameleaf.app/docs/apps/iphone/#back-up-your-photos) and [Android](https://frameleaf.app/docs/apps/android/#back-up-your-phone) guides.

1. **Choose what to back up.** Everything, only camera photos and videos, or albums and folders you pick. You can skip any album or folder, and choose photos, videos or both.
2. **Each original is fingerprinted** with SHA-256 on the phone and compared with what your server already has, whether it arrived from this phone, another device, the web app or an import. Anything already there is skipped, so nothing is uploaded twice and you save data.
3. **Uploads are resumable.** An interrupted upload, a crash, a reboot or a change of network picks up where it stopped.
4. **The server checks the result.** A photo only counts as backed up when the server's fingerprint matches the phone's. Anything that didn't make it is listed with the reason and Retry, under **Not Backed Up** on iPhone and **Not on server** on Android.

Edited versions, such as edits from Apple Photos or files like `IMG_1-edited.jpg` from a gallery app, are uploaded and **stacked** with their original.

### Mobile data, battery and charging

You decide when backup may run. Both apps can keep videos waiting for Wi-Fi while photos use mobile data, never use mobile data at all, or only run while the phone is charging. On iPhone, backup also pauses in Low Power Mode and Low Data Mode by default. On Android, backup always waits while the battery is low.

### In the background

- **iPhone.** iOS decides when apps may work in the background, so the app makes the most of every chance it gets. It runs an overnight backup when iOS allows it, keeps **Back Up Now** going after you leave the app and, on iOS 26.1 or later, hands remaining photos and videos to iOS's own background upload. The more often you open the app, the more chances it gets.
- **Android.** The app catches up every hour, and starts a backup about 30 seconds after you take a photo. Some phones are strict about battery optimisation and stop background work. If backup tells you battery optimisation is in the way, allow the app to run in the background.

### Photos stored in iCloud

If you use **Optimize iPhone Storage** in iCloud, the app downloads the full originals from iCloud on Wi-Fi and backs them up, and Backup shows how many iCloud originals are waiting. This uses some extra data and space on the phone while it works.

### Your phones on the web

You can check each phone's backup from your server's web app. In **Tools**, open **Mobile apps**. Under **Your phones**, each phone shows a receipt line, such as "12,348 on this phone · 12,340 safely on the server · 8 waiting". **Manage** opens that phone's receipt on **Tools › Phones**, which also lists all your phones.

- The receipt shows how many items are **On the phone**, **Safely on the server** and **Waiting**, and when the server last checked. The server checks each phone every night, file by file.
- **Why items are waiting** lists the reasons, such as "Waiting for Wi-Fi", "Waiting for charging", "Low Power Mode is on" or "Still in iCloud". Select one to see what it means.
- If items the phone has aren't on the server, the receipt says so: open the app on the phone to back them up. When a phone hasn't been checked for 7 days or more, the receipt says how long it's been.
- A phone that hasn't reported its count yet shows "Phone count not sent yet".
- While [Locked](https://frameleaf.app/docs/using/private-content/) is locked, the page says "Unlock to see the server's check" and offers **Unlock** with your PIN, so hidden items stay hidden.

Each person sees only their own phones and photos. Administrators also get **Everyone's phones**: the counts and last check for every phone on the server, never the reasons or photos.

### Free up space

Once your server holds an identical copy of a photo, checked by SHA-256, **Free Up Space** can remove it from the phone. You see a summary first, and removed items go to the phone's own trash or Recently Deleted, so you can still get them back.

:::caution[iCloud Photos and chat apps]
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** instead. On Android, chat apps such as WhatsApp show media from files on the phone, so freeing up space can make those images disappear from your chats.
:::

## Away from home

At home the apps talk to your server directly. To reach it from anywhere, without opening ports on your router, link your server to Frameleaf Cloud and turn on [remote access](https://frameleaf.app/docs/cloud/remote-access/). The apps need a Frameleaf Cloud plan away from home; without one they connect on your home network only. Push notifications also need the server to be linked.

## Moving from another photo app

1. Install Frameleaf, sign in to your Frameleaf server and grant the permissions it asks for.
2. Choose your backup albums and network preferences. Frameleaf starts fresh, so set these up in the new app.
3. Keep your previous backup until you've checked that the new one is complete.
