# Supported formats

Source: https://frameleaf.app/docs/help/supported-formats/

Bring photos and videos from your phone, your camera and other apps. Frameleaf accepts every format below, including RAW files from all the major camera makers, and design files and fonts in Boards. Your originals are always stored exactly as uploaded, and Frameleaf makes thumbnails, previews and a video copy that plays smoothly in browsers and on phones.

A file of a type listed here always imports. If Frameleaf can't draw it yet, the file is kept safe, backed up and downloadable, and shows a plain tile or the preview stored inside it. It is never called damaged for that reason. Every format on this page is tested against sample files in each build of Frameleaf.

## Photos

| Format | Extensions | Notes |
| --- | --- | --- |
| Animated PNG | `.apng` | |
| AVIF | `.avif` `.avifs` | Can be animated. `.avifs` is an AVIF sequence |
| BMP | `.bmp` | Including 16-bit, 32-bit with transparency, compressed (RLE) and old OS/2 files |
| Cineon and DPX | `.cin` `.dpx` | Film scans |
| DDS | `.dds` | Game textures |
| FITS | `.fits` | Astronomy images |
| GIF | `.gif` | Can be animated |
| HEIC and HEIF | `.heic` `.heif` `.hif` `.heics` | The iPhone's default format. Can be animated. `.heics` is a HEIC sequence |
| Icons and cursors | `.ico` `.cur` | |
| JPEG | `.jpg` `.jpeg` `.jpe` `.jfif` `.jfi` `.jif` `.pjpeg` `.pjp` `.jps` `.insp` | Baseline and progressive, CMYK files from print and scanning software, and the rarer arithmetic-coded, lossless and 12-bit kinds. `.jps` is a stereo pair. `.insp` is used by Insta360 cameras |
| JPEG 2000 | `.jp2` `.j2k` `.j2c` `.jpc` `.jpf` `.jpx` | |
| JPEG XL | `.jxl` | Can be animated |
| JPEG XR | `.jxr` `.wdp` `.hdp` | Also called HD Photo or Windows Media Photo |
| MPO | `.mpo` | Multi-picture files, such as from 3D cameras |
| Netpbm | `.pbm` `.pgm` `.ppm` `.pnm` `.pfm` `.pam` | |
| OpenEXR | `.exr` | |
| PCX | `.pcx` | |
| PICT | `.pict` `.pct` | Classic Mac pictures |
| PNG | `.png` | Including animated PNG and Fireworks PNG. See [Design files](#design-files) |
| QOI | `.qoi` | |
| Radiance HDR | `.hdr` | |
| SGI | `.sgi` | |
| SVG | `.svg` `.svgz` | |
| TGA | `.tga` | |
| TIFF | `.tif` `.tiff` `.btf` | Including 16-bit, floating point, CMYK, tiled, LZW, Deflate and JPEG-compressed files, and BigTIFF |
| WebP | `.webp` | Can be animated |

Photoshop and other design documents are under [Design files](#design-files).

### Old and unusual photos

Old cameras, scanners and early editing software often wrote files that don't follow the rules exactly: a missing end marker, odd details, or extra data around the picture. Frameleaf opens these the way other photo apps do. When its main reader can't open a picture, it tries a more forgiving read, then other readers, then the small preview stored inside the file, until one of them opens it. A file that hasn't changed since you added it isn't called damaged because of how it was written. Only a JPEG that is really missing part of its picture is repaired, and marked **Part saved**. See [What counts as damaged](https://frameleaf.app/docs/using/damaged-and-missing-files/#what-counts-as-damaged).

## RAW files

| Maker | Extensions |
| --- | --- |
| Adobe (DNG) | `.dng` |
| ARRI | `.ari` |
| Canon | `.cr2` `.cr3` `.crw` |
| Epson | `.erf` |
| Fujifilm | `.raf` |
| GoPro | `.gpr` |
| Hasselblad | `.3fr` `.fff` |
| Kodak | `.dcr` `.k25` `.kdc` |
| Leaf | `.mos` |
| Leica | `.rwl` |
| Mamiya | `.mef` |
| Minolta | `.mrw` |
| Nikon | `.nef` `.nrw` |
| Olympus | `.orf` `.ori` |
| Panasonic | `.raw` `.rw2` |
| Pentax | `.pef` |
| Phase One | `.cap` `.iiq` |
| Samsung | `.srw` |
| Sigma | `.x3f` |
| Sony | `.arw` `.sr2` `.srf` |

### A RAW file always imports

There's no size limit on the sensor. Files from high-resolution cameras work, such as the Canon EOS R5 (45 megapixels), Nikon Z 8 and Z 9, Sony A1 and Fujifilm GFX100S (100 megapixels), including their compressed formats, Nikon High Efficiency and Sigma's Foveon files.

Frameleaf tries three things, in order, until one gives a picture:

1. **It reads the sensor data** with its main RAW decoder.
2. **It tries a second decoder.** GoPro `.gpr` files are read this way.
3. **It shows the picture the camera stored inside the file.** RAW support then says **Showing the camera's preview**. This is what you see for a camera newer than Frameleaf's decoders. Frameleaf tries these files again by itself after an update brings newer decoders.

If none of the three gives a picture, the file is still kept and backed up, and shows a plain tile. A RAW file is never called damaged because a decoder couldn't read it. See [Library care](https://frameleaf.app/docs/using/library-care/).

### Develop a RAW file

A RAW photo opens in the RAW editor, where you set light, colour and detail, paint masks and save versions. The camera original is never changed. See [RAW editor](https://frameleaf.app/docs/using/raw-develop/).

### Enhanced RAW rendering

Some RAW files, older Canon `.cr2` files for example, have a missing or unusable embedded preview. With **Enhanced RAW rendering** on, Frameleaf uses the embedded preview first and falls back to a full render from the sensor data when it needs to, so these files still get proper thumbnails and previews. It's on by default, in **Settings**, then **Editing & playback**, then **Image previews**.

When you review [duplicates](https://frameleaf.app/docs/using/duplicates/), Frameleaf suggests keeping a RAW original over a JPEG copy, and HEIC or HEIF over JPEG, even when the JPEG is bigger.

## Videos

| Format | Extensions | Notes |
| --- | --- | --- |
| 3GPP | `.3gp` `.3gpp` `.3g2` | |
| APV | `.apv` | Samsung's Advanced Professional Video |
| ASF | `.asf` | |
| AVI | `.avi` | |
| Camcorder files | `.mod` `.tod` | Used by JVC and Panasonic camcorders |
| DivX | `.divx` | |
| DV | `.dv` `.dif` | |
| Flash video | `.flv` `.f4v` | |
| GXF | `.gxf` | Broadcast video |
| HD DVD | `.evo` | |
| IVF | `.ivf` | |
| M4V | `.m4v` | |
| Magic Lantern | `.mlv` | RAW video from Canon cameras running Magic Lantern |
| Matroska | `.mkv` `.mk3d` | |
| Motion JPEG | `.mjpeg` `.mjpg` `.mj2` | `.mj2` is Motion JPEG 2000 |
| MP4 | `.mp4` | |
| MPEG | `.mpg` `.mpeg` `.mpe` `.m1v` `.m2v` `.m2p` `.vob` `.vro` | `.vob` and `.vro` are DVD video formats |
| MPEG transport stream | `.mts` `.m2ts` `.m2t` `.ts` `.tp` `.trp` | Used by many camcorders and TV recorders |
| MXF | `.mxf` | |
| NUT | `.nut` | |
| Ogg video | `.ogv` `.ogm` | |
| Phantom | `.cine` | High-speed cameras |
| QuickTime | `.mov` `.qt` | The iPhone's video format |
| Raw video streams | `.h264` `.h265` `.hevc` `.vc1` `.y4m` | Video with no container around it |
| RealMedia | `.rm` `.rmvb` | |
| WebM | `.webm` | |
| Windows recorded TV | `.wtv` `.dvr-ms` | Windows Media Center recordings |
| WMV | `.wmv` | |

A file with sound and no picture in a video container, such as a voice memo saved as `.mp4`, is kept and shows a plain tile.

### Video inside the file

The extension is only the container. Frameleaf reads the video inside it and makes a copy that plays in browsers and on phones, so files from editing software and professional cameras play as well as phone video. Each build of Frameleaf is tested against sample files of these:

| Kind | Video formats |
| --- | --- |
| Phones, cameras and the web | H.264, HEVC (H.265), AV1, VP8, VP9 |
| Editing and professional cameras | Apple ProRes (including ProRes 4444 with transparency), Avid DNxHD and DNxHR, GoPro CineForm, Sony and Avid MXF, DVCPRO HD, JPEG 2000 (including digital cinema MXF), APV |
| Older files | MPEG-1, MPEG-2, MPEG-4 (DivX and Xvid), Motion JPEG, Windows Media Video, VC-1, Flash video, Theora |
| Archiving | FFV1 |

Other video formats inside a supported container usually work too.

### Very large videos

There's no size limit on a file, beyond the free space on your server. A big file is uploaded in parts, several at once. A 50 GB video is checked by reading through the whole file, however long that takes, and is never called damaged because the check was slow. See [What counts as damaged](https://frameleaf.app/docs/using/damaged-and-missing-files/#what-counts-as-damaged).

A video with a damaged frame rate or length in its details still keeps the rest of its details, such as its date and camera.

### Cinema RAW

Frameleaf accepts cinema camera RAW video and keeps it safe, but can't play most of it. No open decoder exists for these formats.

| Format | Extension |
| --- | --- |
| ARRIRAW HDE | `.arx` |
| Blackmagic RAW | `.braw` |
| Canon Cinema RAW Light | `.crm` |
| Nikon N-RAW | `.nev` |
| RED RAW | `.r3d` |

These files are stored, checked against their checksum, backed up, searchable by name, date and camera details, and downloadable. They show a plain tile with no playback copy, and are never called damaged because they can't be played. Early RED ONE `.r3d` files do play.

### Dolby Vision

Dual-layer Dolby Vision (profile 7, from UHD Blu-ray) plays from its HDR10 layer. Profile 5, which has no ordinary HDR layer, gets a playback copy only on a server whose graphics hardware can convert it; otherwise the original is kept and downloadable.

### 360° video

| Camera | Extension |
| --- | --- |
| DJI Osmo 360 | `.osv` |
| GoPro MAX | `.360` |
| Insta360 | `.insv` |

These play as 360° video you can look around in. See [Photo and video types](https://frameleaf.app/docs/using/photo-and-video-types/#360-video).

### Log video

Video shot in Apple Log, Canon Log, DJI D-Log or D-Log M, Fujifilm F-Log, Nikon N-Log, Panasonic V-Log or Sony S-Log3 is shown in normal colour. See [Log video](https://frameleaf.app/docs/using/photo-and-video-types/#log-video).

## Slo-mo, panoramas and other types

Frameleaf also recognises how a photo or video was shot, such as slo-mo, panorama, burst or portrait. See [Photo and video types](https://frameleaf.app/docs/using/photo-and-video-types/).

## Live Photos and Motion Photos

Apple Live Photos (a still photo and a short `.mov`) and Android Motion Photos are kept together as one item that plays its motion. If the two halves of a Live Photo were uploaded separately, rejoin them in **Settings**, then **Tools**, then **Live Photo pairing**. See [Library care](https://frameleaf.app/docs/using/library-care/#live-photos).

## Sidecar files

Frameleaf reads and writes `.xmp` sidecar files next to your originals. Changes you make to dates, locations, descriptions, ratings and tags are saved there, and existing sidecars from other apps are read when a file is imported.

## Design files

Design files belong in **Boards**. Upload them there, or bring them in with an import. [Connected folders](https://frameleaf.app/docs/admin/external-libraries/) don't pick them up, apart from `.psd`, so pointing Frameleaf at a folder never fills your library with PDFs.

| Format | Extensions | What you see |
| --- | --- | --- |
| Adobe Photoshop | `.psd` `.psb` | The document, flattened. 16-bit, 32-bit, CMYK and large-document (PSB) files work, and so do files saved without **Maximize Compatibility** |
| PDF | `.pdf` | The first page. Details says how many pages it has |
| Adobe Illustrator | `.ai` | The first page, for files saved as PDF-compatible (Illustrator's default) |
| EPS | `.eps` | The preview stored in the file |
| GIMP | `.xcf` | The document, flattened |
| Sketch, Adobe XD, Figma | `.sketch` `.xd` `.fig` | The preview stored in the file |
| Procreate, Krita, OpenRaster | `.procreate` `.kra` `.ora` | The preview stored in the file |
| CorelDRAW | `.cdr` | The preview stored in the file |

A design file with no picture inside it at all is kept and shows a plain tile.

**Fireworks PNG.** An editable PNG saved by Adobe or Macromedia Fireworks shows its flattened picture, and Details names it **Fireworks PNG**. The editing data Fireworks keeps inside the file is never changed or removed, so the file still opens in Fireworks. Frameleaf shows the picture only, not the file's separate pages, states or layers.

## Fonts

Fonts live in **Boards**, next to the designs that use them. They aren't accepted into your photo library.

| Format | Extensions | In Boards |
| --- | --- | --- |
| TrueType and OpenType | `.ttf` `.otf` | Specimen, and **Try it** |
| Web fonts | `.woff` `.woff2` | Specimen, and **Try it** |
| Font collections | `.ttc` `.otc` | Specimen picture |
| Mac font suitcase | `.dfont` | Specimen picture |
| PostScript Type 1 | `.pfb` `.pfa` | Specimen picture |

- **Every font gets a specimen**: a picture of the font drawn in its own letters, used for its tile. The sample text matches the scripts the font covers, so a Japanese font is shown in Japanese.
- **Try it** opens the font so you can type your own words and change the size and line spacing. A variable font has its ready-made styles and a slider for each axis, and a font's features can be switched on and off. Colour fonts show in colour.
- **Details** list the family, style, weight, number of glyphs, scripts and the licence text stored in the font.
- **Board text** can be set in any font in Boards, with a size, a colour and, for a variable font, a weight. If the font is later removed, the text shows in the standard font.
- **Shared links** send the font file itself only when the link allows downloads. Otherwise people see the specimen picture.

## Boards

[Boards](https://frameleaf.app/docs/using/boards/) keeps any kind of file you add to it. Alongside images, videos, [design files](#design-files) and [fonts](#fonts), it previews these:

| Kind | Extensions | In Boards |
| --- | --- | --- |
| Word | `.doc` `.docx` | The tile shows the first page. Open it to read the whole document as a PDF |
| Excel | `.xls` `.xlsx` | As Word |
| PowerPoint | `.ppt` `.pptx` `.potx` | As Word |
| Pages, Numbers and Keynote | `.pages` `.numbers` `.key` | As Word, for most documents |
| Audio | `.aac` `.flac` `.m4a` `.mp3` `.ogg` `.wav` | Plays in the item's details, when your browser can play the format |

A document of up to 64 MB gets a preview; a larger one, or one that can't be read, keeps a file icon. Any other file, such as a 3D model or an Affinity document, is kept with a plain tile. Every file in Boards is backed up and can be downloaded exactly as you added it. Document previews need a Linux server, which every standard install is.

## Kept out on purpose

| File | Why |
| --- | --- |
| `.thm`, `.lrf`, `.lrv` | The small preview files cameras save beside a video. Importing them would show every video twice |
| `.afdesign`, `.afphoto`, `.afpub` (Affinity), `.indd` (InDesign) | Not accepted in your photo library yet. Boards keeps them as files |
| `.avci`, `.avcs` | Not accepted yet |

## Something isn't accepted?

In your photo library, files with an extension that isn't listed are rejected on upload and skipped in connected folders. Fonts and most design files are accepted in Boards only, and Boards keeps any other file too. Convert the file to a supported format first, or suggest the format in [GitHub Discussions](https://github.com/Frameleaf/frameleaf-app/discussions) if you think it should be supported.
