feat: Immich 3.0 support — layout-agnostic plugin detection (#93)

Author: epheterson

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.5.24 — 2026-07-03
+
+### Immich 3.0 support
+- **Plugin-path detection** now recognizes both the 2.7 layout (`corePlugin/`) and the 3.0 layout (`plugins/immich-plugin-core/`). Immich 3.0 renamed the WASM core-plugin directory, which made the layer-download early-exit never fire on 3.0, so setup downloaded every image layer instead of stopping once the small plugin layer arrived. Setup is fast again on 3.0. The rest of the 3.0 worker (extraction, native Sharp, ffmpeg wrapper, plugin load, worker start) was verified end to end.
+- README notes the worker tracks your Immich version, verified with 2.7.x and 3.0.x.
+
+Note: moving your own Docker stack from 2.7 to 3.0 requires Immich's database migration (pgvecto-rs to VectorChord); that is on the Immich side, not the accelerator.
+
 ## 1.5.23 — 2026-07-03
 
 ### Diagnostics

README.md

@@ -28,7 +28,7 @@ Docker (lightweight)                 Native macOS (compute)
                                     +-------------------------------+
 ```
 
-The microservices worker is extracted directly from your running Immich Docker image. Always the exact same version, no source builds. The only modification is installing the macOS-native Sharp binary for image processing. Video transcoding is intercepted by a lightweight ffmpeg wrapper that remaps software encoders to VideoToolbox hardware encoders.
+The microservices worker is extracted directly from your running Immich Docker image, so it tracks whatever version you run (verified with Immich 2.7.x and 3.0.x). Always the exact same version, no source builds. The only modification is installing the macOS-native Sharp binary for image processing. Video transcoding is intercepted by a lightweight ffmpeg wrapper that remaps software encoders to VideoToolbox hardware encoders.
 
 ## What we modify (and how to undo it)
 

VERSION

@@ -1 +1 @@
-1.5.23
+1.5.24

immich_accelerator/__main__.py

@@ -1186,6 +1186,22 @@ def _needs_core_plugin(version: str) -> bool:
     return (major, minor) >= (2, 7)
 
 
+def _build_has_core_plugin(build_data: Path) -> bool:
+    """True once the WASM core plugin has been extracted into build-data.
+
+    The layout moved between Immich versions, so recognize both:
+      2.7.x: build-data/corePlugin/manifest.json
+      3.0.x: build-data/plugins/immich-plugin-core/dist/plugin.wasm
+    Keying only on the old 2.7 path made the layer-loop early-exit never
+    fire on 3.0, so setup downloaded every image layer instead of stopping
+    once the (small) plugin layer arrived.
+    """
+    if (build_data / "corePlugin" / "manifest.json").exists():
+        return True
+    plugins = build_data / "plugins"
+    return plugins.is_dir() and any(plugins.glob("*/dist/plugin.wasm"))
+
+
 def _has_everything(
     version: str,
     found_server: bool,
@@ -1293,7 +1309,7 @@ def _get(url, accept=None):
 
     for i, layer in sorted_layers:
         size_mb = layer["size"] / 1024 / 1024
-        has_core = (build_data / "corePlugin" / "manifest.json").exists()
+        has_core = _build_has_core_plugin(build_data)
         if _has_everything(bare_version, found_server, found_build, has_core):
             break
         digest = layer["digest"]

tests/test_accelerator.py

@@ -1496,3 +1496,29 @@ def fake_kill(pid, sig):
 
         termed = {pgid for pgid, sig in sent if sig == signal.SIGTERM}
         assert termed == {111, 222, 333}  # all signalled before any wait
+
+
+class TestBuildHasCorePlugin:
+    """Plugin detection across Immich layouts (2.7 corePlugin, 3.0 plugins/)."""
+
+    def test_detects_27_layout(self, tmp_path):
+        from immich_accelerator.__main__ import _build_has_core_plugin
+
+        (tmp_path / "corePlugin").mkdir()
+        (tmp_path / "corePlugin" / "manifest.json").write_text("{}")
+        assert _build_has_core_plugin(tmp_path) is True
+
+    def test_detects_30_layout(self, tmp_path):
+        from immich_accelerator.__main__ import _build_has_core_plugin
+
+        wasm = tmp_path / "plugins" / "immich-plugin-core" / "dist" / "plugin.wasm"
+        wasm.parent.mkdir(parents=True)
+        wasm.write_bytes(b"\x00asm")
+        assert _build_has_core_plugin(tmp_path) is True
+
+    def test_false_when_absent(self, tmp_path):
+        from immich_accelerator.__main__ import _build_has_core_plugin
+
+        assert _build_has_core_plugin(tmp_path) is False
+        (tmp_path / "plugins").mkdir()  # empty plugins dir is not enough
+        assert _build_has_core_plugin(tmp_path) is False