https://github.com/grubyak/negative-lab-pro-sync
nlpx
https://github.com/grubyak/negative-lab-pro-sync
negative-lab-pro-sync synchronize
Last synced: 4 months ago
JSON representation
nlpx
- Host: GitHub
- URL: https://github.com/grubyak/negative-lab-pro-sync
- Owner: grubyak
- Created: 2025-07-20T11:05:14.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-08-01T11:28:56.000Z (11 months ago)
- Last Synced: 2025-12-21T12:28:22.408Z (6 months ago)
- Topics: negative-lab-pro-sync, synchronize
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/@grby/nlpx
- Size: 311 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# @grby/nlpx
### problem
`negative lab pro`, designed to process negative scans, stores its adjustments directly into the lightroom catalog. These settings can be lost when files are moved or a catalog becomes corrupted.
### solution
`nlpx` is a two‑way sync tool for `negative lab pro` and the `lightroom classic` catalog.
It synchronizes sidecar files (`.nlpx.json`), allowing you to:
- restore negative adjustments back into the catalog at any time
- move or reorganize files without losing nlp data
- avoid keeping positive copies in lightroom, since they can be re‑created with the same settings on demand
## limitations
- to allow moving files freely, synchronization is based on **filenames**
- each photo must therefore have a unique name (this is best practice anyway)
- suggested filename format: `YYYYMMDD-HHMM-RR-NNN.CR3`
- negatives must use the `.CR3` extension
- **important** — before syncing data back into the catalog, make sure desired files have (at least default) `negative lab pro` adjustments
- select desired photos and run `negative lab pro`
- if any entries are present — good, they are ready for sync
- otherwise — accept the dialog to create default entries, which will be overridden during sync
### installation
```zsh
$ pnpm add -g @grby/nlpx
```
### usage
**Make a backup of your lightroom catalog before syncing data back into it.**
```zsh
$ nlpx
```
```zsh
$ nlpx --update-sidecar --catalog= [--go] [--verbose] [--all]
$ nlpx --update-catalog --catalog= [--go] [--verbose]
```
### sync: catalog → sidecars
```zsh
# close lightroom to ensure all adjustments are written to the catalog
```
```zsh
$ cd ~/photos/album-123/
$ nlpx --update-sidecar --catalog=/Users/xyz/a/b/c/my-catalog.lrcat --verbose --all
# validate whether everything looks good
```
```zsh
$ nlpx --update-sidecar --catalog=/Users/xyz/a/b/c/my-catalog.lrcat --verbose --all --go
$ ls -1
aaabbbccc.CR3
aaabbbccc.nlpx.json
```
### sync: sidecars → catalog
```zsh
# make a copy of your catalog and keep negative lab pro plugin closed!
```
```zsh
$ cd ~/photos/album-123/
$ nlpx --update-catalog --catalog=/Users/xyz/a/b/c/my-catalog.lrcat --verbose
# validate whether everything looks good
```
```zsh
$ nlpx --update-catalog --catalog=/Users/xyz/a/b/c/my-catalog.lrcat --verbose --go
```
### warning
This software comes with no warranty — use at your own risk.
Always make a backup of your `lightroom catalog` before syncing data back.
Tested only with `negative lab pro` 3.0.2 and `lightroom classic` 14.3.1
### coffee
If you find this useful, consider [buying me a coffee](https://coff.ee/grubyak).
