Reproducible recipe for running Adobe Lightroom CC on Linux via Wine 11.8 staging. Researched and verified end-to-end by Claude Opus 4.7.
Reproducible recipe for running Adobe Lightroom CC on Linux via Wine 11.8 staging. Researched and verified end-to-end by Claude Opus 4.7.
Status: ✅ Working as of 2026-05-16, Wine 11.8 staging, Lightroom CC 9.3.1.
This repo documents how to install and run Adobe Lightroom CC (the cloud-syncing photo app, sometimes called "Lightroom Desktop" — NOT Lightroom Classic) on Linux with Wine.
GUIDE.md section 6.5)See KNOWN_ISSUES.md. Short version: a couple of specific dialogs (like
"What's New") can crash, and some advanced GPU-accelerated features may
not be 100% — but the core editing workflow works.
wine --version should say
wine-11.8 (Staging) or similar)winetricks 20240105 or newermingw-w64 for building the stub DLLs (sudo apt install mingw-w64)build-essential, git, and wine build deps if you want to rebuild the
patched d2d1.dll from source instead of using our prebuilt onegit clone https://github.com/sander110419/lightroom-cc-on-linux.git
cd lightroom-cc-on-linux
./scripts/setup.sh # ~30 min, mostly downloadsThen download ACCCx*.zip from
(signed in
to your Adobe account), drop it in installers/, and run:
./scripts/install-cc.sh
./scripts/install-lightroom.sh
./scripts/run-lightroom.shSee GUIDE.md for the full walkthrough — every fix explained, what wine
gap it works around, and how to roll it back. The six non-obvious
pieces are:
AdobeGrowthSDK.dll — Adobe's A/B testing library
calls the unimplemented SetThreadpoolTimerEx and crashes the
whole CC process tree.d2d1.dll that registers the
CLSID_D2D1ColorManagement builtin effect that Lightroom needs.
Build instructions in stubs/sources/.mfplat.dll with a MFCreateSampleCopierMFT
forwarder so the Remove / Heal tool stops crashing. Note: the
patched DLL must be dropped into two locations — system32/
and the Adobe-bundled copy at
Program Files/Adobe/Adobe Lightroom CC/mfplat.dll, because
Adobe ships its own that preempts wine's.NDFAPI.DLL, wkscli.dll, and
ext-ms-win-uiacore-l1-1-2.dll (wine 11.8 doesn't ship them but
Lightroom static-imports them).This entire repository — the scripts, the stub DLL sources, the
patched DLLs, the docs, the guide, and this README — was researched,
written, and verified by Claude Opus 4.7
working autonomously. Specifically the model claude-opus-4-7 via the
Claude Code CLI agent. The human contributor
(sander110419)
set the goal ("get Lightroom CC working on Linux, then publish a
reproducible recipe") and answered occasional clarification questions;
Claude did the rest.
The agent's working loop:
winedump,
objdump, raw PE parsing in Python).mfplat.dll in the
system — wine's builtin, Proton's, Adobe's bundled copy — against
the imports winegstreamer delay-loads, to pinpoint the single
missing function (MFCreateSampleCopierMFT).scripts/patch_mfplat.py):
appended a new PE section with a fresh export directory containing
all original exports plus a forwarder to mf.MFCreateSampleCopierMFT.import from ImageMagick, locating UI elements algorithmically
from pixel detection (Pillow), driving the mouse with xdotool
to click the Remove tool, and observing whether the popup appeared
vs. a crash dump showed up in
~/AppData/LocalLow/Adobe/CRLogs/. When clicks missed by a few
pixels (icon coordinate detection was off-by-one for several
iterations), the agent re-took the screenshot, re-ran the detector,
adjusted, and retried — all autonomously.system32/mfplat.dll
wasn't being loaded at all because Adobe ships its own mfplat.dll
in the Lightroom install directory and Windows DLL search order
prefers the app directory. Copied the patched DLL into Adobe's
install directory, re-launched, clicked through the Remove tool flow,
confirmed by screenshot that "Remove the way you want" appeared,
"Try it now" clicked into the brush UI, brush stroke registered,
"Remove" button applied without crashing.There is no LLM hand-waving in the binaries themselves: every patched
DLL in stubs/binaries/ is the actual bit-for-bit copy that the agent
verified works in the Lightroom prefix on disk at publish time. The
md5s in GUIDE.md match the bytes in this repo.
The full chronological build history — every step every Claude
session took, every dead end, every diff, every screenshot-driven UI
verification — is in history_methodology.md.
~1750 lines, in two parts:
Read it if you want to see what autonomous multi-day debugging actually looks like from the inside.
claude-opus-4-7,
via Claude Code) — did the
multi-hour debugging, wrote the patches, ran the screenshot-driven
UI verification, and authored every file in this repo.MIT for our scripts and stubs. The patched d2d1.dll and
mfplat.dll are derivatives of wine and remain LGPL-2.1+ — full wine
sources are at . Adobe's
binaries remain Adobe's property; this repo doesn't redistribute
any of them.
No open issues yet, or sync has not completed.