Supported formats
Frameleaf accepts the photo and video formats below, from phones, cameras and other apps. Your originals are always stored exactly as uploaded. For display, Frameleaf makes thumbnails and previews, and transcodes videos into a copy that plays smoothly in browsers and on phones.
Photos
Section titled “Photos”| Format | Extensions | Notes |
|---|---|---|
| AVIF | .avif |
Can be animated |
| BMP | .bmp |
|
| GIF | .gif |
Can be animated |
| HEIC and HEIF | .heic .heif .hif |
The iPhone’s default format. Can be animated |
| JPEG | .jpg .jpeg .jpe .insp |
.insp is used by Insta360 cameras |
| JPEG 2000 | .jp2 |
|
| JPEG XL | .jxl |
Can be animated |
| MPO | .mpo |
Multi-picture files, such as from 3D cameras |
| PNG | .png |
Including animated PNG |
| PSD | .psd |
Adobe Photoshop |
| SVG | .svg |
|
| TIFF | .tif .tiff |
|
| WebP | .webp |
Can be animated |
RAW files
Section titled “RAW files”| Maker | Extensions |
|---|---|
| Adobe (DNG) | .dng |
| ARRI | .ari |
| Canon | .cr2 .cr3 .crw |
| Epson | .erf |
| Fujifilm | .raf |
| Hasselblad | .3fr .fff |
| Kodak | .dcr .k25 .kdc |
| Leica | .rwl |
| Minolta | .mrw |
| Nikon | .nef .nrw |
| Olympus | .orf .ori |
| Panasonic | .raw .rw2 |
| Pentax | .pef |
| Phantom | .cin |
| Phase One | .cap .iiq |
| Samsung | .srw |
| Sigma | .x3f |
| Sony | .arw .sr2 .srf |
Enhanced RAW rendering
Section titled “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 with LibRaw when it needs to, so these files still get proper thumbnails and previews. It’s on by default, in Administration, then Settings, then Image.
A RAW file that can’t be rendered is reported as unsupported, separately from files that are actually damaged. See Library Care.
When you review duplicates, Frameleaf suggests keeping a RAW original over a JPEG copy, and HEIC or HEIF over JPEG, even when the JPEG is bigger.
Videos
Section titled “Videos”| Format | Extensions | Notes |
|---|---|---|
| 3GPP | .3gp .3gpp |
|
| AVI | .avi |
|
| FLV | .flv |
|
| M4V | .m4v |
|
| Matroska | .mkv |
|
| MPEG transport stream | .mts .m2ts .m2t .ts |
Used by many camcorders |
| MP4 | .mp4 .insv |
.insv is used by Insta360 cameras |
| MPEG | .mpg .mpeg .mpe .vob |
.vob is the DVD video format |
| MXF | .mxf |
|
| QuickTime | .mov |
The iPhone’s video format |
| WebM | .webm |
|
| WMV | .wmv |
Live Photos and Motion Photos
Section titled “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 with Utilities, then Relink live photos. See Library Care.
Sidecar files
Section titled “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.
Something isn’t accepted?
Section titled “Something isn’t accepted?”A file with an extension that isn’t listed is rejected on upload and skipped in external libraries. Convert it to a supported format first, or ask in GitHub Discussions if you think it should be supported.