Editing
Edit photos and videos without fear: your original is always safe Watch on YouTube
Edit freely, knowing your original is always safe. Frameleaf saves every edit as a new version and never changes your original file, so you can go back at any time. Downloads give you the edited version by default, with the original one option away.
Open the editor
Section titled “Open the editor”- Open a photo or video and choose Edit in the viewer.
- Or select some photos and choose Quick edit in the selection bar.
- A RAW photo opens in the RAW editor instead, where you develop the file itself with light, colour, masks and presets. Quick edits / external versions in its header switches to the editor described here.
Leave the editor and come back, and your unsaved edits are waiting for you. If the item changed in the meantime, the editor tells you and starts fresh.
Photo tools
Section titled “Photo tools”The web editor has four tools down its side:
| Tool | What it does |
|---|---|
| Adjust | Sliders in four groups. Light: Exposure, Contrast, Highlights, Shadows, Whites, Blacks. Color: Temperature, Tint, Vibrance, Saturation. Effects: Clarity, Dehaze, Vignette, Grain. Detail: Sharpen, Noise reduction |
| Crop | Crop and straighten, rotate left or right, and choose an aspect: Free, Original, Square or a social format |
| Enhance | Restore and upscale an old or damaged photo |
| Presets | Looks such as Natural, Vivid, Warm, Cool, B&W, Mono, Noir, Silvertone and Fade, each with a strength, plus presets you save yourself |
Masks opens from Adjust. Add a radial or linear mask to apply light and colour changes to part of the photo, or outside it when inverted, with feather and amount. Versions lists every saved version of the photo; see Versions.
A few helpers make editing quicker:
- Hold to show the original, or press
\orY, to compare. Split view shows before and after side by side with a divider you can drag. - Double-click a slider to reset it, or reset a whole group.
- Copy adjustments and Paste adjustments to carry your edit to other photos.
- A histogram shows the current preview, and warns when highlights or shadows are clipping.
- Social formats set the crop for a Feed, Portrait 4:5, Landscape, Vertical, Shorts 9:16 or Wide 16:9 post. Fine-tune the framing in Crop.
When you’re done, choose Save version. Your edit is saved as a new version and rendered from the original; the original is kept.
The iPhone and iPad and Android apps have their own editors, with Adjust, Looks, Crop, Clean Up and Masks. Edits made on any device are saved the same way, so they’re shared between them.
Native app tools
Section titled “Native app tools”The iPhone and iPad and Android apps add perspective correction, Subject and Sky masks, and Remove and restoration tools. On iPhone and iPad, white-balance Auto and the Eyedropper use the photo on the device. Draw with Apple Pencil on iPad or a pen on Android tablets.
A tool that needs a server renderer or restoration worker tells you before it starts.
Presets
Section titled “Presets”A preset keeps your light, colour, effects, detail, look and masks. Applying one never changes the crop.
- Save as preset from your current settings, and give it a name.
- Replace a preset with your current settings, or delete it. Versions you already saved with it keep their settings.
- Presets you make on one device are available on the others. A setting one device has no control for, such as Brilliance from the phone apps, still goes into the photo when you apply the preset there.
Versions
Section titled “Versions”Every saved edit is kept as a version, with its edit recipe and its finished file.
Versions, at the top of the editor, lists Original and each saved version, with the one your library shows marked Current. Choose one to load its settings. All versions opens the full list, where each version offers:
- Edit from this version loads its settings so you can carry on from there.
- Show this version makes it the one your library shows. Choose it on Original to go back to the original. Nothing is deleted.
- Compare with original shows the two side by side.
- Download as JPEG saves the finished file.
Each version shows whether it’s Ready, Finishing with its progress, Waiting or Couldn’t finish.
Rendering happens on your server after you save. You can follow it in Activity, where a Photo version goes from Rendering to Done. If a render fails, it’s retried automatically.
Edits saved by a newer app are kept safely as they are. You see a note that showing the edit needs a newer version of Frameleaf, and the preview updates once your server is updated.
Edit in another app
Section titled “Edit in another app”You can develop a photo, such as a RAW file, in an app like darktable or Lightroom and bring the result back as a new version:
- In the editor, open Edit in another app and choose Export original.
- Develop it in your other app.
- Choose Bring back as a version and pick the finished file: JPEG, TIFF, PNG, WebP or HEIF. You can note which app you used.
Frameleaf checks that the original hasn’t changed since you exported it and shows the two side by side so you can confirm. Your original stays as it is, and the new version becomes current once its preview is ready.
Many photos at once
Section titled “Many photos at once”To develop a whole shoot elsewhere, select the photos, open More in the selection bar and choose Edit in another app. This works for still images.
- Create the batch with the button that says how many photos it holds, then choose Prepare originals. Preparation is saved photo by photo, so you can close the page and come back to it.
- Choose Download originals ZIP. It holds the prepared originals, plus their sidecar files where you’re allowed them. Photos that are unavailable or couldn’t be prepared are left out, and each photo’s status shows why.
- Edit the files in your other app. Keep the file names if you can.
- Choose Review returned files, then Choose returned files or Choose returned folder. Frameleaf matches each file to its photo. Pick the photo for any file that was renamed or needs mapping, or choose Skip this file.
- Choose Confirm matches and import. Nothing is imported until you confirm.
Each returned file becomes a new version of its photo once its preview is ready. If the photo was edited in Frameleaf after you confirmed, or the original has changed, the returned file is kept as an inactive version in Versions instead, so nothing you did in between is lost. Returned files count towards your storage.
The iPhone and Android apps run batches too, using the system share sheet and file picker.
Batches keep their progress on the server. Choose Manage external editor batches to go back to one, upload the returned files again after reopening the page, Retry failed files, or Cancel unfinished work. Versions that were already imported stay.
Edits from Lightroom and darktable
Section titled “Edits from Lightroom and darktable”A photo with Lightroom or darktable develop settings in its XMP sidecar can gain an approximate version labelled From Lightroom or From darktable. Frameleaf renders it beside your existing versions; it does not make it Current or change the original. Open Versions to review it, and choose Show this version only when you want your library to use it.
This is different from bringing back a finished file: Frameleaf interprets the XMP settings with its own renderer. It is not a pixel-identical Lightroom or darktable render.
| Source | Settings interpreted |
|---|---|
| Lightroom | Exposure, contrast, highlights, shadows, whites, blacks, temperature and tint, vibrance, saturation, clarity, dehaze, crop and angle, supported tone curves, colour-channel HSL adjustments and vignette |
| darktable | Supported versions of exposure, temperature, colour balance, crop/clipping and perspective operations |
Temperature and colour controls are approximate. Camera profiles, Lightroom local adjustments and masks, unsupported darktable operations and unfamiliar setting layouts are preserved with the version rather than applied. They survive later edits in Frameleaf. When both applications’ settings are present, darktable controls take precedence and both source records are kept.
Re-reading the same settings reuses the imported version. Changed edit settings can create another version. To stop new imports, open Settings → App settings and turn off Make a version from edits in XMP files. It is on by default; switching it off leaves existing versions in place.
Video tools
Section titled “Video tools”Open a video and choose Edit. The video editor opens on Trim.
| Tool | What it does |
|---|---|
| Trim | Set the start and end. Press I or O to mark the playhead. Precise cuts on the exact frame and re-encodes the clip from the original. Fast · keyframes cuts at the video’s keyframes in seconds without re-encoding; if your other edits re-encode the clip anyway, the cut is frame-accurate |
| Enhance | Auto-enhance lifts contrast, colour and midtones a little across the whole clip. Stabilize smooths handheld shake, cropping the edges slightly to hide the correction |
| Speed | Change the playback rate, or slow down or speed up parts of the clip with speed ranges. Audio pitch is kept up to 2× |
| Text | Titles and captions over the video between a start and end time, with position, size, colour and shadow |
| Audio | Mute the clip or change its gain. Gain above 100% is limited to avoid clipping |
Crop, rotate, straighten, mirror, colour and light adjustments and presets work on videos too. Export frame saves the frame at the playhead as a new photo. Versions lists the original and your saved video edits. On a wide screen, Revert sets your edit back to the original.
The original sound channels are kept: stereo stays stereo and surround stays surround.
Choose Open in Studio to carry on in the full video editor, keeping your edit and undo history. See Studio.
Videos that can’t be edited
Section titled “Videos that can’t be edited”A few video formats can’t be edited. Frameleaf tells you before editing starts, and the original stays as it is:
- Dolby Vision profile 5, profile 7, and profiles 3, 4, 9 and 10
- Dolby Vision profile 8 videos that don’t say what their base picture is
- videos with more than 12 bits per colour, or a picture format the server can’t read
Dolby Vision profile 8.1 and 8.4 videos can be edited: the edit keeps the HDR10 or HLG picture and drops the Dolby metadata.
How edits are stored
Section titled “How edits are stored”- The original is never written to. Every render reads from it.
- The edited master is always made fresh from the original and your edit recipe, so editing again never builds up quality loss. It’s the best-quality version of your edit, and it’s what downloads and exports give you. Download original gets the untouched file.
- Previews, thumbnails and streaming versions are smaller copies made from the master. They can be made again at any time.
- A small record next to each edited master names the original it came from, the original’s checksum, the exact edit and the version of the renderer. That’s how the server spots a master that’s out of date and makes it again.
Edited versions share the privacy of their original straight away: if the original is Locked or has hidden people or tags, so does the edit.
What an edited video keeps
Section titled “What an edited video keeps”Your edited video keeps the full quality of the original. The server’s video playback settings apply only to streaming copies, not to the edited master:
- Resolution. It keeps the original’s resolution and uses a higher quality setting than playback copies.
- Timing. Frame timing is passed through, so a variable-frame-rate recording keeps its cadence.
- Audio. Channel layout is kept. An audio track the edit doesn’t touch is copied through unchanged.
- Colour. A 10-bit video stays 10-bit, and colour information is written explicitly.
- HDR. Editing an HDR video makes a standard-range version and keeps the HDR original as the reference.
A quarter or half turn skips re-encoding wherever the file allows it, so every frame and sound sample is kept exactly. If a video can’t be kept faithfully, Frameleaf stops before writing anything, and the original and any earlier edit stay untouched.
Video edits use your server’s hardware acceleration when it’s safe to, and fall back to the processor for edits that need it.
Restore and upscale
Section titled “Restore and upscale”Bring old and damaged photos and videos back to life. Restoration makes a separate, improved version and keeps the original as it is. You see a 5-second preview first. It runs on a GPU computer at home, or on Cloud GPU if you choose it. Pick a restoration worker that supports the task and model you want.
RAW photos and client shoots
Section titled “RAW photos and client shoots”RAW files have their own editor, with a tone curve, lens correction, masks and settings you can sync across a whole shoot. See RAW editor. If you photograph for clients, Clients keeps each shoot, its selections and its edits together, and opens a shoot’s RAW photos in the RAW editor in one go.
Studio
Section titled “Studio”Turn your library into a film. Studio, in the web app and on iPad and Android tablets, is a multitrack video editor: build a film from your library, grade it, add titles, music and captions, and export on your device or a server worker. See Studio.
© 2026 Frameleaf Inc. All rights reserved.
Frameleaf and the Frameleaf logo are Trademarks of Frameleaf Inc.
