Metadata-Version: 2.4
Name: lrimmich
Version: 0.1.1
Summary: Sync Lightroom Classic catalogs to Immich
Project-URL: Homepage, https://github.com/haavardnk/lrimmich
Project-URL: Repository, https://github.com/haavardnk/lrimmich
Project-URL: Issues, https://github.com/haavardnk/lrimmich/issues
Author: Håvard Nordhus Kråkenes
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.11
Requires-Dist: httpx>=0.28.1
Requires-Dist: platformdirs>=4.9.6
Requires-Dist: pydantic>=2.13.4
Requires-Dist: rich>=15.0.0
Requires-Dist: stamina>=26.1.0
Requires-Dist: typer>=0.25.1
Requires-Dist: watchfiles>=1.1.1
Description-Content-Type: text/markdown

# lrimmich

[![PyPI](https://img.shields.io/pypi/v/lrimmich)](https://pypi.org/project/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](src/lrimmich/utils/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 collections       # list catalog collections with IDs
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](https://github.com/simulot/immich-go) | CLI tool. Bulk uploads from local folders, Google Photos takeouts, iCloud exports. Handles duplicates and stacking. | Yes |
| [lrc-immich-plugin](https://github.com/bmachek/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](https://github.com/midzelis/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](https://github.com/haavardnk/lrimmich/issues).

## License

MIT
