Files
lightcraft/docs/user/guides/import-lightroom-catalog.md
Fabio LussiandClaude Opus 5.5 e665aff1b3 docs: re-verify against 0.7.1
- All pages checked against the v0.7.1 tag and its release assets;
  verified: bumped to 0.7.1.
- Install: 32-bit Windows (x86) installer and portable build; pre-0.6
  upgrades keep their install folder.
- Import: Recently Deleted photos are restored by default; progress shows
  in the activity stack.
- Edit: HDR button next to B&W.
- Export: JPEG XL Effort and Progressive, lossy JPEG XL colour space
  note, Add to Apple Photos on macOS.
- Lightroom import: activity stack progress and stopping with its X.
- Raw troubleshooting: Adobe RGB fix now released, monochrome picture
  style tone, EOS R5 Mark II C-RAW decodes, Leica DNG and dark scenes
  still open; drop "import again" (duplicates are skipped).
- docs/user/CLAUDE.md is a regular file instead of a symlink.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 14:34:54 +02:00

2.5 KiB

title, description, order, verified
title description order verified
Move over from Lightroom Import a Lightroom Classic catalog into LightCraft, and learn what comes across and what does not. 50 0.7.1

Choose File > Import Lightroom Catalog… and pick your .lrcat file. LightCraft reads it directly. You do not need Lightroom installed.

Steps

  1. Open the library you want the photos in. To start a new one, use File > New Library….
  2. Choose File > Import Lightroom Catalog….
  3. Pick your Lightroom Classic catalog, the file that ends in .lrcat. You can also give File > Open Library… a Lightroom catalog folder. LightCraft then offers this import instead of making a library there.
  4. Wait for the import to finish. It runs in the background, with a progress row in the activity stack at the top left. A message reports how many photos were added.

If you change your mind, one Edit > Undo reverses the changes to the catalog.

What comes across

  • Ratings, picks and rejects, and colour labels
  • Keywords, including hierarchical ones, and XMP metadata
  • Collections and collection sets, which become albums
  • Virtual copies
  • Develop settings that LightCraft can map

Original files stay where they are, and LightCraft refers to them in place. Photos whose originals are missing stay in the library so you can relink them later. LightCraft never changes your Lightroom catalog or your originals.

What does not match

  • Develop settings are an approximation. Camera profiles, Adobe's AI models and some masking and retouch fields are not reproduced, and settings LightCraft cannot map are reported.
  • Smart collections become regular albums that hold the photos they contain at the time of import.
  • Lightroom's process version is not carried over. Imported photos use LightCraft's newest rendering.

Good to know

  • Before it changes anything, LightCraft tries to save your source settings, history and collections in a recovery archive in the library's Interop folder. This is best effort. If it fails, the photos are still imported with a warning.
  • Importing the same catalog again does not duplicate virtual copies or collections. By default, edits you already made in LightCraft are kept.
  • A big catalog can take a long time. In one report on an earlier version, 38,000 photos took about 25 minutes from a USB SSD.
  • To stop the import, click ✕ on its row in the activity stack. This works while LightCraft reads the catalog. Once it starts adding the photos, it finishes.
  • The browser version cannot import a catalog.