Skip to content

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.

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

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.

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

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.

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.

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, Frameleaf suggests keeping a RAW original over a JPEG copy, and HEIC or HEIF over JPEG, even when the JPEG is bigger.

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.

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.

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.

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.

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.

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.

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.

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.

Frameleaf also recognises how a photo or video was shot, such as slo-mo, panorama, burst or portrait. See Photo and video types.

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.

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 belong in Boards. Upload them there, or bring them in with an import. Connected folders 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 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 keeps any kind of file you add to it. Alongside images, videos, design files and 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.

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

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 if you think it should be supported.