lrimmich 0.1.0

Sync Lightroom Classic catalogs to Immich

lrimmich

Syncs your Lightroom Classic catalog to Immich. Collections become albums, picks become favorites, ratings carry over, and color labels and keywords are written as tags.

The same photo files Lightroom reads must be mounted into Immich as an external library. lrimmich doesn't upload anything. It matches files that are already on both sides and writes metadata through the Immich API.

Install

uv tool install lrimmich

or pipx install lrimmich.

Getting started

lrimmich config init

This writes a starter config to your platform's user config directory:

• Linux: ~/.config/lrimmich/config.toml (XDG)
• macOS: ~/Library/Application Support/lrimmich/config.toml
• Windows: %APPDATA%\lrimmich\config.toml

Edit it with your catalog path, Immich URL, API key, and library path (the folder Immich mounts your photos from). See sample_config.toml for all options.

lrimmich doctor

Checks that the catalog opens, the Immich API responds, and at least some files resolve. If it passes, run a dry-run first:

lrimmich sync --dry-run

Commands

lrimmich sync              # sync everything
lrimmich sync --dry-run    # see what would happen
lrimmich status            # exit 1 if there's drift
lrimmich watch             # poll for catalog changes, sync when detected
lrimmich adopt             # claim existing Immich albums by name match
lrimmich log               # show recent sync activity
lrimmich reset             # delete state DB, next sync rebuilds from scratch
lrimmich install-service   # generate launchd/systemd unit for periodic sync
lrimmich uninstall-service # remove service files
lrimmich config show       # print resolved config (secrets redacted)
lrimmich config edit       # open config in your default editor
lrimmich --version         # print version

Watch

Watches the catalog file (including WAL) for filesystem events and syncs after a debounce window:

lrimmich watch --debounce 5000

To run it as a background service:

lrimmich install-service --interval 300

How it works

Reads the .lrcat SQLite database, maps LR file paths to Immich asset IDs by scanning the external library folder tree, then diffs against what was synced last time (stored alongside the config in your platform's user state directory). Repeat runs only touch what changed.

Alternatives

	How it works	Uploads photos?
lrimmich	CLI tool. Reads the .lrcat database directly, matches files already mounted in Immich, writes metadata only.	No
immich-go	CLI tool. Bulk uploads from local folders, Google Photos takeouts, iCloud exports. Handles duplicates and stacking.	Yes
lrc-immich-plugin	LR Classic plugin. Export and publish service that uploads rendered photos via the Immich API. Can also import from Immich.	Yes
mi.Immich.Publisher	LR Classic plugin. Publishes collections as albums, deduplicates across collections. Beta, not actively maintained.	Yes

Contributing

Bug reports and PRs welcome. For bugs, include the output of lrimmich doctor and the command you ran. Open an issue at github.com/haavardnk/lrimmich/issues.

License

MIT