GitCorner

Code

ossartcraftlightcraft🌐
5a24289898fd
# File format parity

> **Last reviewed:** 2026-10-10 Β· **Target:** Adobe Lightroom Classic 15.5 / Lightroom 9.6 Β· **Changes:** [revision history](#revision-history)

Every format Lightroom reads or writes, with our support, fidelity and tests. Camera raw formats are
deep enough to have their own document: [raw-parity.md](raw-parity.md).

**How measured:** the target's document types come from the installed Lightroom 9.6
`Info.plist` (`CFBundleDocumentTypes`: catalog `mcat`, `xmp`, toolkit / module / library bundles, and
the raw-and-image list: jpg, tif, dng, heic and 27 raw extensions) plus Lightroom Classic's documented
import and export formats. Ours come from `crates/codecs/src/sniff.rs`, `crates/codecs/src/encode.rs`,
`crates/engine/src/export.rs`, `crates/engine/src/import.rs` and the tests named below.

## Images (non-raw)

| Format | Target reads | Target writes | LightCraft reads | LightCraft writes | Notes / tests |
|---|---|---|---|---|---|
| JPEG | βœ… | βœ… | βœ… (parallel decoder, ICC, EXIF orientation) | βœ… quality, size limit, ICC, metadata; Huffman tables optimized per image (issue #1373) | `crates/codecs/src/jpeg.rs`, `crates/codecs/src/encode.rs` (shared `craft-jpeg` encoder), export tests |
| TIFF | βœ… 8/16/32-bit | βœ… 8/16-bit, LZW/ZIP | βœ… 1–64-bit integer, 16–64-bit float, bilevel, CCITT fax, WhiteIsZero | βœ… 8/16-bit, 32-bit float linear, none / LZW / ZIP | `crates/tiff`, `crates/codecs/src/tiff_codec.rs` |
| PNG | βœ… | βœ… | βœ… | βœ… | |
| PSD / PSB | βœ… (maximized-compatibility composite) | βœ… (Classic: PSD export, edit-in round trip) | βœ… merged composite | ⬜ (external-editor round trip writes 16-bit TIFF) | `crates/codecs/src/psd.rs` |
| HEIC / HEIF | βœ… | ⬜ (Classic) / HDR only | βœ… in every release build (`craft-heif` from craft-libs, heic-rs) | ⬜ | `heif` feature on by packaging scripts; EXIF and XMP read from the container in every build (`crates/meta/src/heif.rs`, #693) |
| AVIF | βœ… | βœ… (HDR) | ⬜ recognised, not decoded (no permissive pure-Rust AV1 decoder) | βœ… 8/10-bit, PQ HDR | EXIF and XMP read from the container (`crates/meta/src/heif.rs`); exported EXIF reads back |
| JPEG XL | βœ… | βœ… | βœ… (`jxl-oxide`) incl. DNG 1.7 JXL tiles | βœ… lossy / lossless, 8/16-bit, PQ HDR (`jixel`, native only; ⬜ web) | `crates/engine/src/tests/export.rs` |
| WebP | not in its document types | ⬜ | βœ… | βœ… | beyond target |
| GIF, BMP | ⬜ | ⬜ | βœ… | ⬜ | beyond target |
| DNG (from raw) | βœ… | βœ… incl. lossy, embedded original | βœ… | βœ… uncompressed, LJ92, Deflate or lossy (JPEG tiles, optional long edge); ⬜ embedded original | `crates/raw/src/dngwrite.rs` |
| Render to DNG (15.5) | β€” | βœ… | β€” | 🟑 export format "Rendered DNG" (linear float DNG, edit baked in); not yet added to the catalog | `crates/raw/src/dngwrite.rs` (`write_rendered_dng`) |
| Original + sidecar | β€” | βœ… | β€” | βœ… | |
| HDR gain map JPEG (ISO 21496-1) | βœ… | βœ… | βœ… (gain map read) | βœ… | `crates/codecs/src/gainmap.rs` (JPEG layout), `craft-gainmap` (metadata, compute, apply) |
| PQ / HLG HDR | βœ… | βœ… AVIF, JXL, TIFF | β€” | 🟑 PQ AVIF, PQ JPEG XL, float TIFF; no HLG | |
| Contact sheet / print PDF | β€” | βœ… (Print module: PDF / JPEG / printer) | β€” | 🟑 paginated contact-sheet PDF (A4 / Letter, 150 dpi, sRGB) | `crates/engine/src/contact_sheet.rs` |
| Video (MP4, MOV, AVCHD…) | βœ… playback, trim, edit | βœ… export | 🟑 catalogued (kind, duration) | ⬜ | see video gap |

## Colour spaces and profiles

| Feature | Target | LightCraft |
|---|---|---|
| Export colour spaces | sRGB, Adobe RGB, Display P3, ProPhoto, Rec.2020, custom ICC | βœ… sRGB, Display P3, Adobe RGB-compatible, ProPhoto, Rec.2020 with gamut mapping (CPU and GPU), embedded ICC; ⬜ custom ICC output profiles; AVIF stays sRGB |
| Input ICC (JPEG / TIFF / PNG) | βœ… | βœ… matrix / TRC and LUT profiles (moxcms) |
| Soft proofing with printer profiles | βœ… | 🟑 |

## Metadata, sidecars, presets and catalogs

| Format | Target | LightCraft | Notes |
|---|---|---|---|
| XMP sidecars (`crs:` develop settings, ratings, keywords, regions) | read / write | βœ… read / write, manual (⌘S) and automatic | [xmp-interop.md](xmp-interop.md) |
| EXIF / IPTC / XMP embedded on export | βœ… | βœ… with metadata filters | `crates/meta` |
| Develop presets `.xmp` | βœ… | βœ… import (mapping of supported settings) | |
| Legacy presets `.lrtemplate` | βœ… (converted) | βœ… import | |
| Camera / creative profiles (`.dcp`, `.xmp` profiles) | βœ… | 🟑 the user's own `.dcp` camera profiles import (`profile.import`) and replace a raw file's colour model; none ship with the app; `.xmp` profiles ⬜; `.cube` LUT profiles βœ… | |
| Lens profiles `.lcp` | βœ… | ⬜ deliberately | |
| Other apps' presets | β€” | βœ… Luminar `.lmp` / `.mplumpack`, `.zip` bundles | beyond target |
| Lightroom Classic catalog `.lrcat` | native | 🟑 import (ratings, flags, labels, keywords, collections, virtual copies, supported develop settings; read-only pure-Rust SQLite incl. WAL) | [lightroom-catalog-import.md](lightroom-catalog-import.md) |
| Lightroom (cloud) library `.lrlibrary` | native | ⬜ | cloud library format, local cache only |
| Write back to `.lrcat` | native | ⬜ (one-way migration by design) | |
| Keyword lists (text) | import / export | βœ… | |
| GPX track logs | βœ… | βœ… | `crates/meta/src/lib.rs` (re-exports shared `craft_metadata::parse_gpx`), `crates/engine/src/cmd/manage.rs` |
| Export presets, metadata presets, filename templates | βœ… (`.lrtemplate`) | βœ… own JSON | not interchangeable |
| Lightroom plug-ins (`.lrplugin`, `.lrdevplugin`) | βœ… | ⬜ | see ecosystem in [target-app-parity.md](target-app-parity.md) |

## Scores

| Part | Weight | Ready for real work | Kind |
|---|---:|---:|---|
| Standard image import / export | 35% | ~85% | estimated (table above; missing: AVIF read, Render to DNG in the catalog) |
| Sidecars, metadata, presets | 25% | ~85% | estimated |
| Lightroom catalog migration | 25% | ~50% | estimated (one-way, approximate rendering of unsupported settings) |
| HDR, print, video output | 15% | ~35% | estimated |
| **Non-raw file formats** | 100% | **~70%** | estimated; raw is in [raw-parity.md](raw-parity.md) (~50%) |

Remaining: **26–47 h** (AVIF decode 8–15 h if a permissive decoder is written or found; PSD write 4–8 h; lossy DNG and Render to DNG 4–8 h; HLG 3–5 h; catalog import depth 8–12 h).

## Revision history

| Date | Change | Summary |
|---|---|---|
| 2026-10-12 | minor | LR-PROF-IMPORT: the user's own DNG camera profiles (`.dcp`) import as camera profiles; none ship |
| 2026-10-10 | major | Created from the code and the installed Lightroom's document types |
| 2026-10-10 | minor | JPEG XL export (#247): JXL write βœ… (native only), PQ JPEG XL HDR |
| 2026-10-12 | minor | Render to DNG: "Rendered DNG" export format (linear 16-bit float DNG of the rendered photo) |
| 2026-10-12 | minor | HEIC / HEIF and AVIF: EXIF and XMP read from the container, without the decoder (#693); statuses unchanged |
| 2026-10-12 | minor | Lossy DNG export (JPEG tiles, `dngCompression: "lossy"`); PSD write had already landed (#953), so it leaves the remaining hours |
| 2026-10-13 | patch | JPEG write (#1373): Huffman tables made for each image, 12–14 % smaller files at the same pixels; statuses unchanged |