Skip to content

README.md

Latest commit

 

History

History
152 lines (103 loc) · 5.57 KB

README.md

File metadata and controls

152 lines (103 loc) · 5.57 KB

fuji-lrc-auto

One command. 11 Fujifilm simulations. Lightroom Classic. macOS + Windows.
AI-agent-executable toolkit — give a task file to Codex or Claude and it does the rest.

What This Is

A fully automated, cross-platform deployment toolkit for 11 Fujifilm film simulation profiles in Adobe Lightroom Classic. Built on the excellent cube LUTs from abpy/FujifilmCameraProfiles, this project handles every Adobe-shaped rough edge so you don't have to.

Included Simulations

# Profile Style
1 Fuji Provia Natural, balanced — the everyday standard
2 Fuji Velvia Vivid, saturated — landscapes pop
3 Fuji Astia Soft, portrait-oriented tones
4 Fuji Classic Chrome Muted, documentary feel
5 Fuji Classic Neg Vintage negative film look
6 Fuji Eterna Cinematic, flat contrast
7 Fuji Pro Neg Hi Slightly contrasty portrait neg
8 Fuji Pro Neg Std Smooth standard portrait neg
9 Fuji Reala Ace Accurate, reference-grade
10 Fuji Nostalgic Neg Warm nostalgic tones
11 Fuji Bleach Bypass Desaturated, high-contrast

All profiles are camera-independent — they work on RAW from any camera, plus JPEG.

Quick Install

python3 scripts/install.py

Then restart Lightroom Classic. You'll find the profiles in:

  • Profile Browser (right panel, grid icon) → Fujifilm Simulation
  • Presets panel (left panel) → Fujifilm Simulation

Windows

python scripts\install.py

Restart Lightroom Classic. Same result.

For AI Agents

This project is designed as an AI-agent-executable toolkit. Point any capable agent at fuji-setup.task.md:

Read fuji-setup.task.md and install Fujifilm simulation profiles for Lightroom Classic on this machine.

The task file is a self-contained "lens" — it tells the agent what OS it's on, where files go, what bugs to fix, and how to verify. See AGENTS.md for the technical reference card.

What Problems This Solves

1. The Grayscale Bug

Adobe Camera Raw's "Create Profile" dialog silently sets ConvertToGrayscale="True" in generated .xmp files. There is no UI toggle for this. Camera Raw then converts the image to grayscale before applying the 3D LUT — producing completely gray, washed-out photos regardless of what LUT data is embedded.

Fix: scripts/fix_profiles.py rewrites the flag to False in every Look profile.

2. Missing Presets Panel Entries

Look profiles appear in the Profile Browser but not in the Presets panel. Lightroom requires separate "stub" .xmp files that reference the Look profile by UUID.

Fix: scripts/generate_stubs.py creates the companion stub files automatically.

3. Cross-Platform Path Hell

macOS and Windows use different settings directories, different file path conventions, and different Camera Raw behavior. Manually managing this across machines is error-prone.

Fix: scripts/install.py auto-detects the OS, resolves paths, and handles everything.

Project Structure

├── README.md              ← You are here
├── LICENSE                ← MIT (scripts) + abpy attribution (profiles)
├── fuji-setup.task.md     ← AI agent main task file (the "lens")
├── AGENTS.md              ← AI agent quick-reference card
├── .gitignore
├── scripts/
│   ├── install.py         ← Cross-platform one-command installer
│   ├── fix_profiles.py    ← Fix ConvertToGrayscale bug
│   └── generate_stubs.py  ← Generate Presets panel entries
├── profiles/              ← 22 pre-built .xmp profiles (11 Look + 11 Stub)
└── tasks/                 ← Individual phase breakdowns (reference)

From Scratch (Starting with Cube Files)

If you need to create profiles from raw .cube LUT files instead of using the pre-built ones, the AI agent task file covers every step — from cloning the abpy repo, to guiding you through Camera Raw's dialog, to running the automated fix scripts.

See Phase 2 of fuji-setup.task.md.

Known Limitations

  • Color accuracy: These LUTs are designed for linear DisplayP3 input. Camera Raw applies them on top of Adobe Color (non-linear), causing a mild gamma mismatch. Colors are ~85-90% accurate — better than the grayscale result of the unfixed version, but not pixel-perfect. For perfection, use camera-specific DCP profiles.

  • AI model prompt (macOS, LRC 14.x / CR 18.4, cracked): Presets panel stubs may trigger an "AI model download" prompt. This is a Lightroom version-specific behavior, not a profile format bug. The Profile Browser works without AI models.

Acknowledgments

This project stands on the shoulders of abpy/FujifilmCameraProfiles — the meticulous color science work that extracted, analyzed, and converted Fuji's film simulation data into usable cube LUTs. Every profile in this repository is a derivative of their work. Thank you.

Also thanks to the Windows investigation that identified ConvertToGrayscale="True" as the root cause by cross-referencing working Windows profiles with broken macOS ones.

License

MIT — see LICENSE.

The .xmp profile files in profiles/ embed LUT data derived from abpy's work (CC BY-NC-SA 4.0). These are included as convenience pre-built assets. The scripts and documentation are MIT.