Skip to content

fuji-setup.task.md

Latest commit

 

History

History
159 lines (110 loc) · 4.77 KB

fuji-setup.task.md

File metadata and controls

159 lines (110 loc) · 4.77 KB

Task: Install Fujifilm Simulation Profiles for Lightroom Classic

Agent: Codex / Claude / any AI agent
Goal: Deploy 11 Fuji film simulation profiles in LRC, macOS + Windows
One-shot: python3 scripts/install.py (if pre-built profiles exist)
From cube files: Follow all phases below
Source: Built on abpy/FujifilmCameraProfiles (CC BY-NC-SA 4.0)

Phase 0: Detect Environment

import platform
print(platform.system())  # "Darwin" = macOS, "Windows" = Windows

Settings directory:

OS Path
macOS ~/Library/Application Support/Adobe/CameraRaw/Settings/
Windows %AppData%\Adobe\CameraRaw\Settings\

Check: is Photoshop installed? (Needed for Phase 2)

Phase 1: Acquire Cube LUTs

Option A: Clone abpy (recommended)

git clone https://github.com/abpy/FujifilmCameraProfiles.git /tmp/FujifilmCameraProfiles

Cube files are at FujifilmCameraProfiles/Cube/DisplayP3/ (11 .cube files).

Option B: Use local cube files

If already downloaded, note their directory path.

Phase 2: Create Profiles in Camera Raw

CRITICAL: This requires Adobe Photoshop. The agent guides the user through manual Camera Raw interaction because:

  • AppleScript fails on cracked macOS Photoshop
  • Adobe's .xmp LUT encoding is proprietary (cannot generate programmatically)
  • Windows UI automation requires accessibility permissions

For each of the 11 cube files:

  1. Open Photoshop → New document (any size)
  2. Filter → Camera Raw Filter (macOS: ⇧⌘A, Windows: Ctrl+Shift+A)
  3. In Camera Raw, open Presets panel (right side)
  4. Hold Option/Alt and click + at bottom of Presets panel → "New Profile" dialog
  5. Set:
    Field Value
    Name Fuji Provia (see table below)
    Group Fujifilm Simulation
    Color Lookup Table ☑ checked
    Table Browse to .cube file
    Space Display P3
    Amount Min=100, Max=100
  6. Click OK
  7. Repeat for each cube

Cube → Profile Name Mapping

.cube file Profile Name
provia_DisplayP3.cube Fuji Provia
velvia_DisplayP3.cube Fuji Velvia
astia_DisplayP3.cube Fuji Astia
classic chrome_DisplayP3.cube Fuji Classic Chrome
eterna_DisplayP3.cube Fuji Eterna
pro neg hi_DisplayP3.cube Fuji Pro Neg Hi
pro neg std_DisplayP3.cube Fuji Pro Neg Std
reala ace_DisplayP3.cube Fuji Reala Ace
classic neg_DisplayP3.cube Fuji Classic Neg
nostalgic neg_DisplayP3.cube Fuji Nostalgic Neg
bleach bypass_DisplayP3.cube Fuji Bleach Bypass

Post-creation check

ls <settings_dir>/Fuji*.xmp | wc -l  # should be 11

Phase 3: Fix the Grayscale Bug

Root Cause

Camera Raw's dialog sets crs:ConvertToGrayscale="True" in every generated .xmp. There is no UI toggle. This causes grayscale conversion before LUT application → gray photos.

Fix

python3 scripts/fix_profiles.py <settings_dir>

Or manually: replace crs:ConvertToGrayscale="True" → "False" in each Fuji*.xmp (excluding *LUT.xmp files).

Important: Do NOT add CameraProfile="Adobe Standard Linear"

This profile name does not exist on macOS Camera Raw 18.4. Adding it causes the entire .xmp to be silently ignored by Lightroom.

Phase 4: Generate Presets Panel Stubs

Look profiles appear in Profile Browser, but Presets panel needs separate stub files.

python3 scripts/generate_stubs.py <settings_dir>

This creates Fuji * LUT.xmp files that reference the Look profiles by UUID.

Known Issue: AI Model Prompt (macOS, LRC 14 + CR 18.4)

On cracked macOS Lightroom, clicking Presets panel stubs may trigger "Download AI models." This is a Lightroom version bug, not a profile format issue. Profile Browser works fine.

Phase 5: Verify

  1. Fully quit Lightroom (Cmd+Q / Alt+F4 — NOT just close window)
  2. Reopen Lightroom
  3. Open any photo → Profile Browser (grid icon) → Fujifilm Simulation
  4. Verify 11 profiles listed and colors are correct (not gray)
  5. Presets panel → Fujifilm Simulation → verify * LUT entries present

Diagnostics

python3 scripts/install.py --verify

Troubleshooting

Symptom Fix
Profiles not in browser Delete Index_*.dat, restart LRC
Colors still gray Re-run Phase 3
Presets missing Re-run Phase 4
All profiles gone Check you didn't add CameraProfile="Adobe Standard Linear"

Credits

abpy/FujifilmCameraProfiles — the original cube LUT project. All color science, data extraction, and conversion is their work. This project handles the Adobe deployment layer.