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, then connect it to your server.
What you need
Section titled “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. You can also use your own 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
Section titled “Get started”Welcome has one button: Continue with Frameleaf, to sign in or create a free account. Enter the email for your Frameleaf 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.
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, 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
Section titled “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.
Set up a brand-new server from your phone
Section titled “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.
- Choose Set up on the server’s card, or its row under On this Wi-Fi.
- Name your server.
- 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
Section titled “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
Section titled “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
Section titled “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
Section titled “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’sCF-Access-Client-Id: …andCF-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 asAuthorization,HostandCookie, 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
Section titled “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
Section titled “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.
Tap the Spoken words chip to find what was said in your videos, once you’ve turned on 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
Section titled “Frameleaf Assistant”When your server offers Frameleaf Assistant, 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
Section titled “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
Section titled “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.
Boards
Section titled “Boards”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
Section titled “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
Section titled “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
Section titled “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
Section titled “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. 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.
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.
Every photo is checked
Section titled “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
Section titled “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.
Backup choices
Section titled “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 | |
| 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
Section titled “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
Section titled “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
Section titled “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
Section titled “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.
Bring in photos from elsewhere
Section titled “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 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.
Edit photos and videos
Section titled “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.
Photos
Section titled “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
Section titled “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
Section titled “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.
Restore and upscale
Section titled “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. You see an estimate and a preview first, and the original is never replaced.
Keep your library offline
Section titled “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
Section titled “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
Section titled “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.
- 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
Section titled “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 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
Section titled “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.
Settings
Section titled “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 (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.
- 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
Section titled “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
Section titled “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 for recipients, choices and deletion requests.
Frameleaf Cloud in the app
Section titled “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.
On a TV
Section titled “On a TV”Play on the Frameleaf TV app
Section titled “Play on the Frameleaf TV app”With the Android TV app 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.
Google Cast
Section titled “Google Cast”Send any photo or video to your TV with Google Cast:
- Open a photo or video.
- Choose the cast button, then your device.
- 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.
Studio on tablets
Section titled “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.
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
Section titled “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.
Moving from another photo app
Section titled “Moving from another photo app”Switching is easy:
- Install Frameleaf and sign in to your Frameleaf server.
- Grant the permissions it asks for.
- 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.
© 2026 Frameleaf Inc. All rights reserved.
Frameleaf and the Frameleaf logo are Trademarks of Frameleaf Inc.