# Editing

Source: https://frameleaf.app/docs/using/editing/

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

- 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](https://frameleaf.app/docs/using/raw-develop/) 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

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](#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](#versions).

A few helpers make editing quicker:

- **Hold to show the original**, or press `\` or `Y`, 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](https://frameleaf.app/docs/apps/iphone/#edit-photos-and-videos) and [Android](https://frameleaf.app/docs/apps/android/#edit-photos-and-videos) 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

The [iPhone and iPad](https://frameleaf.app/docs/apps/iphone/#edit-photos-and-videos) and [Android](https://frameleaf.app/docs/apps/android/#edit-photos-and-videos) 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

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

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

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:

1. In the editor, open **Edit in another app** and choose **Export original**.
2. Develop it in your other app.
3. 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

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.

1. 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.
2. 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.
3. Edit the files in your other app. Keep the file names if you can.
4. 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**.
5. 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](https://frameleaf.app/docs/apps/iphone/#edit-many-photos-in-another-app) and [Android](https://frameleaf.app/docs/apps/android/#develop-in-another-app) 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

A photo with Lightroom or darktable develop settings in its [XMP sidecar](https://frameleaf.app/docs/using/xmp-sidecars/) 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](#edit-in-another-app): 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

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](https://frameleaf.app/docs/studio/overview/).

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

- **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](https://frameleaf.app/docs/using/private-content/) or has hidden people or tags, so does the edit.

:::caution[Back up the thumbs folder]
Edited versions, masks and Clean Up fills are stored in your server's `thumbs` folder, and masks and fills made on a phone can't be made again. Include it in your [backups](https://frameleaf.app/docs/admin/backup-and-restore/#which-files-to-back-up).
:::

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

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](https://frameleaf.app/docs/cloud/cloud-gpu/) if you choose it. Pick a restoration worker that supports the task and model you want.

## 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](https://frameleaf.app/docs/using/raw-develop/). If you photograph for clients, [Clients](https://frameleaf.app/docs/using/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

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](https://frameleaf.app/docs/studio/overview/).
