immich-export 0.0.2__tar.gz

immich_export-0.0.2/.env.example

@@ -0,0 +1,4 @@
+# Copy to .env (never commit the real one) or export in your shell.
+# Create the key in Immich → Account Settings → API Keys (read-only is enough).
+IMMICH_SERVER=https://immich.local:2283
+IMMICH_API_KEY=your-api-key-here

immich_export-0.0.2/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @gykonik

immich_export-0.0.2/.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: ci
+on: [push, pull_request, workflow_dispatch]
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv sync --all-extras --dev
+
+      - name: lint
+        run: |
+          uv run ruff check .
+          uv run ruff format --check .
+
+      - name: typecheck
+        run: uv run mypy
+
+      - name: test
+        run: uv run pytest -q
+
+      - name: build
+        run: uv build

immich_export-0.0.2/.github/workflows/release.yml

@@ -0,0 +1,48 @@
+name: release
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write # tag + GitHub Release
+  id-token: write # PyPI Trusted Publishing (OIDC, no token)
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    concurrency: release
+    steps:
+      # `git push` authenticates with the credentials checkout persists into the
+      # remote's extraheader — NOT with the token handed to the semantic-release
+      # action below (that one only signs GitHub API calls). The version commit
+      # lands on protected `main`, so the pushing identity needs a ruleset bypass:
+      # SEMANTIC_RELEASE_TOKEN is a PAT acting as an org owner, who has one.
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: true
+          token: ${{ secrets.SEMANTIC_RELEASE_TOKEN || secrets.GITHUB_TOKEN }}
+
+      - name: Semantic release (version, tag, changelog, GitHub Release)
+        id: semrel
+        uses: python-semantic-release/python-semantic-release@v9
+        with:
+          github_token: ${{ secrets.SEMANTIC_RELEASE_TOKEN || secrets.GITHUB_TOKEN }}
+
+      # No build step here on purpose. python-semantic-release already builds the
+      # sdist + wheel into dist/ via its `build_command` in pyproject.toml. It is
+      # a Docker action running as root, so those files are root-owned; a second
+      # `uv build` as the unprivileged runner user cannot overwrite them and dies
+      # with PermissionError, taking publish and the brew bump down with it.
+      - name: Publish to PyPI (OIDC)
+        if: steps.semrel.outputs.released == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Bump Homebrew formula
+        if: steps.semrel.outputs.released == 'true'
+        run: |
+          gh workflow run bump.yml -R fileworks/homebrew-tap \
+            -f formula=immich-export \
+            -f version=${{ steps.semrel.outputs.version }}
+        env:
+          GH_TOKEN: ${{ secrets.TAP_DISPATCH_TOKEN }}

immich_export-0.0.2/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.py[cod]
+.venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+dist/
+*.egg-info/
+.env
+.DS_Store

immich_export-0.0.2/CHANGELOG.md

@@ -0,0 +1,66 @@
+# CHANGELOG
+
+
+## v0.0.2 (2026-07-13)
+
+### Bug Fixes
+
+- **release**: Drop the duplicate build that broke publishing
+  ([#3](https://github.com/fileworks/immich-export/pull/3),
+  [`2f8683b`](https://github.com/fileworks/immich-export/commit/2f8683b21f8b0b75ffa0e6805547e450af394896))
+
+The release job died at 'Build sdist + wheel' with
+
+PermissionError: [Errno 13] Permission denied: dist/<pkg>-0.0.1.tar.gz
+
+python-semantic-release already builds the sdist and wheel into dist/ via the build_command in
+  pyproject.toml. It is a Docker action running as root, so those artefacts are root-owned. The
+  workflow then ran a second, redundant 'uv build' as the unprivileged runner user, which cannot
+  overwrite them.
+
+Publish to PyPI and the Homebrew bump are both gated on that step, so a permission error on a build
+  that never needed to happen silently took out the entire release.
+
+Remove the duplicate build and the setup-uv step that only served it, and let the publish action
+  consume the dist/ that semantic-release produced.
+
+
+## v0.0.1 (2026-07-12)
+
+### Bug Fixes
+
+- **release**: Give checkout the release token so the version push is allowed
+  ([#2](https://github.com/fileworks/immich-export/pull/2),
+  [`6ae635e`](https://github.com/fileworks/immich-export/commit/6ae635e0f7d3a0a1e65a40e76d470d5bbd5122a3))
+
+The release job fails with GH013 — the chore(release) version commit cannot be pushed to protected
+  main.
+
+Handing SEMANTIC_RELEASE_TOKEN to the python-semantic-release action is not enough: that input only
+  authenticates GitHub API calls. The actual git push uses the credentials actions/checkout persists
+  into the remote's extraheader, which were still the default GITHUB_TOKEN — an identity with no
+  ruleset bypass.
+
+Set the token on checkout as well, mirroring media-sorter's semantic-release workflow, so the push
+  authenticates as an org owner and the always-bypass applies.
+
+### Continuous Integration
+
+- Allow CI to be triggered manually ([#1](https://github.com/fileworks/immich-export/pull/1),
+  [`0e64d69`](https://github.com/fileworks/immich-export/commit/0e64d694c92fcd85992101ce249aaab9dd45c63e))
+
+* ci: allow CI to be triggered manually
+
+workflow_dispatch makes it possible to re-run checks without pushing a commit — needed while
+  verifying the org's Actions allow-list, and useful any time a run fails for reasons outside the
+  code.
+
+* fix(release): push the version commit with a token that can bypass the ruleset
+
+semantic-release commits the version bump to main. The branch ruleset requires a PR, and the default
+  GITHUB_TOKEN has no bypass — GitHub rejects the Actions app as a bypass actor ("must be part of
+  the ruleset source or owner organization"), so the release job could never land its commit.
+
+SEMANTIC_RELEASE_TOKEN is a fine-grained PAT that acts as an org owner, who already holds an
+  always-bypass on the ruleset. Falls back to GITHUB_TOKEN so nothing breaks where the secret is
+  absent.

immich_export-0.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Niklas Büchel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

immich_export-0.0.2/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: immich-export
+Version: 0.0.2
+Summary: Export everything out of Immich — files plus albums, people, tags, descriptions — into a redundant, human-readable local folder tree.
+Project-URL: Repository, https://github.com/fileworks/immich-export
+Project-URL: Issues, https://github.com/fileworks/immich-export/issues
+Author: gykonik
+License-Expression: MIT
+License-File: LICENSE
+Keywords: backup,export,immich,photos,xmp
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Archiving :: Backup
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.28
+Requires-Dist: pydantic>=2.9
+Requires-Dist: typer>=0.15
+Description-Content-Type: text/markdown
+
+# immich-export
+
+Pull **everything** out of [Immich](https://immich.app) — the files **and** the
+metadata that only lives in its database (albums, people, tags, descriptions,
+favorites, geo) — into a redundant, human-readable local folder tree.
+
+This is the media escape hatch that makes "Immich = source of truth"
+reversible: if Immich vanished tomorrow, the export is a plain tree you can
+browse, grep, or import anywhere else.
+
+```
+immich-export/
+  library/2024/03/IMG_1234.jpg          # primary tree (self-contained mode)
+  library/2024/03/IMG_1234.jpg.xmp      # sidecar: tags, people, albums, description, geo, favorite
+  albums/Japan-2019/IMG_1234.jpg        # → symlink into library/
+  people/Anna/IMG_1234.jpg              # → symlink into library/
+  manifest.jsonl                        # one line per asset: id, checksum, path, all metadata
+  manifest.csv                          # the same, human-readable
+  export-report.txt                     # counts, warnings, errors, timing
+```
+
+## Install
+
+```sh
+pipx install immich-export
+# or
+brew install fileworks/tap/immich-export
+```
+
+*(Not yet published — first release pending; until then: `uv run immich-export` from a checkout.)*
+
+## Usage
+
+```sh
+export IMMICH_SERVER=https://immich.local:2283
+export IMMICH_API_KEY=...   # Immich → Account Settings → API Keys
+
+# full portable export (copies originals)
+immich-export --out ./immich-export
+
+# incremental re-run: only new/changed assets are downloaded
+immich-export --out ./immich-export
+
+# sidecar mode: you already have the Storage-Template tree mounted —
+# only write .xmp sidecars + album/people views next to it
+immich-export --mode sidecar --library-root /volume1/photos --out /volume1/photos
+
+# custom primary tree
+immich-export --layout "{year}/{album}" --out ./export
+```
+
+Key flags (see `immich-export --help` for all):
+
+| Flag | Default | Meaning |
+|---|---|---|
+| `--mode` | `self-contained` | `self-contained` copies originals; `sidecar` only writes XMP + views next to an existing tree |
+| `--layout` | `{year}/{month}` | primary tree; tokens `{year} {month} {day} {album} {type}`; `{album}` falls back to `Unsorted` |
+| `--album-view` / `--people-view` | on | build `albums/` and `people/` symlink views |
+| `--sidecars` | `xmp` | `xmp` or `none` |
+| `--since` | — | only assets taken on/after this date |
+| `--resume` | on | skip assets already exported with an unchanged checksum (from `manifest.jsonl`) |
+| `--include-hidden` | off | also export hidden + locked-folder assets |
+
+## Guarantees
+
+- **Read-only against Immich.** Never writes back.
+- **Best-effort.** One bad asset logs an error and the run continues; the report lists every failure.
+- **Idempotent / resumable.** The manifest records each asset's checksum; re-runs download only new or changed files, and refresh sidecars when only metadata (albums/tags/people) changed.
+- **Verifiable.** Every download is checked against Immich's SHA-1; `manifest.jsonl` lets you diff export-vs-server (or vs. a restore) any time.
+- **Streams.** Assets are paged and downloaded with bounded concurrency — a 100k-asset library never sits in memory.
+
+## Exit codes
+
+| Code | Meaning |
+|---|---|
+| 0 | success (including an empty library) |
+| 2 | bad configuration or authentication failure |
+| 3 | server unreachable |
+| 4 | output directory unwritable / out of space |
+| 1 | unexpected error (re-run with `--verbose` for the traceback) |
+
+## Sidecar format
+
+Standard XMP wherever a standard slot exists — `dc:subject` (tags),
+`Iptc4xmpExt:PersonInImage` (people), `dc:description`, `photoshop:DateCreated`,
+`exif:GPSLatitude/Longitude`, `xmp:Rating` (favorite → 5) — so digiKam,
+Lightroom and exiftool can read them. Album membership and Immich ids live in a
+custom `immich:` namespace in the same file.
+
+## Immich API compatibility
+
+Built against the **Immich v3 API** (spec version 3.0.1). Instead of a
+generated client, the exact API slice used is declared in
+`src/immich_export/api_contract.py` and checked in CI against a vendored,
+pruned copy of the official OpenAPI spec. To check a new Immich release:
+
+```sh
+uv run python scripts/refresh_api_spec.py --ref v3.1.0
+uv run pytest tests/test_contract.py
+```
+
+A removed endpoint or field fails the tests *before* it breaks at runtime.
+
+## Development
+
+```sh
+uv sync --all-extras --dev
+uv run ruff check . && uv run ruff format --check .   # lint
+uv run mypy                                           # strict types
+uv run pytest                                         # tests (mock Immich API)
+uv build                                              # sdist + wheel
+```
+
+Conventional Commits drive releases (`python-semantic-release`): merge to
+`main` → version bump + changelog + GitHub Release + PyPI publish (OIDC) +
+Homebrew formula bump.
+
+## License
+
+MIT

immich_export-0.0.2/README.md

@@ -0,0 +1,120 @@
+# immich-export
+
+Pull **everything** out of [Immich](https://immich.app) — the files **and** the
+metadata that only lives in its database (albums, people, tags, descriptions,
+favorites, geo) — into a redundant, human-readable local folder tree.
+
+This is the media escape hatch that makes "Immich = source of truth"
+reversible: if Immich vanished tomorrow, the export is a plain tree you can
+browse, grep, or import anywhere else.
+
+```
+immich-export/
+  library/2024/03/IMG_1234.jpg          # primary tree (self-contained mode)
+  library/2024/03/IMG_1234.jpg.xmp      # sidecar: tags, people, albums, description, geo, favorite
+  albums/Japan-2019/IMG_1234.jpg        # → symlink into library/
+  people/Anna/IMG_1234.jpg              # → symlink into library/
+  manifest.jsonl                        # one line per asset: id, checksum, path, all metadata
+  manifest.csv                          # the same, human-readable
+  export-report.txt                     # counts, warnings, errors, timing
+```
+
+## Install
+
+```sh
+pipx install immich-export
+# or
+brew install fileworks/tap/immich-export
+```
+
+*(Not yet published — first release pending; until then: `uv run immich-export` from a checkout.)*
+
+## Usage
+
+```sh
+export IMMICH_SERVER=https://immich.local:2283
+export IMMICH_API_KEY=...   # Immich → Account Settings → API Keys
+
+# full portable export (copies originals)
+immich-export --out ./immich-export
+
+# incremental re-run: only new/changed assets are downloaded
+immich-export --out ./immich-export
+
+# sidecar mode: you already have the Storage-Template tree mounted —
+# only write .xmp sidecars + album/people views next to it
+immich-export --mode sidecar --library-root /volume1/photos --out /volume1/photos
+
+# custom primary tree
+immich-export --layout "{year}/{album}" --out ./export
+```
+
+Key flags (see `immich-export --help` for all):
+
+| Flag | Default | Meaning |
+|---|---|---|
+| `--mode` | `self-contained` | `self-contained` copies originals; `sidecar` only writes XMP + views next to an existing tree |
+| `--layout` | `{year}/{month}` | primary tree; tokens `{year} {month} {day} {album} {type}`; `{album}` falls back to `Unsorted` |
+| `--album-view` / `--people-view` | on | build `albums/` and `people/` symlink views |
+| `--sidecars` | `xmp` | `xmp` or `none` |
+| `--since` | — | only assets taken on/after this date |
+| `--resume` | on | skip assets already exported with an unchanged checksum (from `manifest.jsonl`) |
+| `--include-hidden` | off | also export hidden + locked-folder assets |
+
+## Guarantees
+
+- **Read-only against Immich.** Never writes back.
+- **Best-effort.** One bad asset logs an error and the run continues; the report lists every failure.
+- **Idempotent / resumable.** The manifest records each asset's checksum; re-runs download only new or changed files, and refresh sidecars when only metadata (albums/tags/people) changed.
+- **Verifiable.** Every download is checked against Immich's SHA-1; `manifest.jsonl` lets you diff export-vs-server (or vs. a restore) any time.
+- **Streams.** Assets are paged and downloaded with bounded concurrency — a 100k-asset library never sits in memory.
+
+## Exit codes
+
+| Code | Meaning |
+|---|---|
+| 0 | success (including an empty library) |
+| 2 | bad configuration or authentication failure |
+| 3 | server unreachable |
+| 4 | output directory unwritable / out of space |
+| 1 | unexpected error (re-run with `--verbose` for the traceback) |
+
+## Sidecar format
+
+Standard XMP wherever a standard slot exists — `dc:subject` (tags),
+`Iptc4xmpExt:PersonInImage` (people), `dc:description`, `photoshop:DateCreated`,
+`exif:GPSLatitude/Longitude`, `xmp:Rating` (favorite → 5) — so digiKam,
+Lightroom and exiftool can read them. Album membership and Immich ids live in a
+custom `immich:` namespace in the same file.
+
+## Immich API compatibility
+
+Built against the **Immich v3 API** (spec version 3.0.1). Instead of a
+generated client, the exact API slice used is declared in
+`src/immich_export/api_contract.py` and checked in CI against a vendored,
+pruned copy of the official OpenAPI spec. To check a new Immich release:
+
+```sh
+uv run python scripts/refresh_api_spec.py --ref v3.1.0
+uv run pytest tests/test_contract.py
+```
+
+A removed endpoint or field fails the tests *before* it breaks at runtime.
+
+## Development
+
+```sh
+uv sync --all-extras --dev
+uv run ruff check . && uv run ruff format --check .   # lint
+uv run mypy                                           # strict types
+uv run pytest                                         # tests (mock Immich API)
+uv build                                              # sdist + wheel
+```
+
+Conventional Commits drive releases (`python-semantic-release`): merge to
+`main` → version bump + changelog + GitHub Release + PyPI publish (OIDC) +
+Homebrew formula bump.
+
+## License
+
+MIT

immich_export-0.0.2/pyproject.toml

@@ -0,0 +1,80 @@
+[project]
+name = "immich-export"
+version = "0.0.2"
+description = "Export everything out of Immich — files plus albums, people, tags, descriptions — into a redundant, human-readable local folder tree."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "gykonik" }]
+requires-python = ">=3.12"
+keywords = ["immich", "export", "backup", "photos", "xmp"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: End Users/Desktop",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: System :: Archiving :: Backup",
+]
+dependencies = [
+  "httpx>=0.28",
+  "pydantic>=2.9",
+  "typer>=0.15",
+]
+
+[project.urls]
+Repository = "https://github.com/fileworks/immich-export"
+Issues = "https://github.com/fileworks/immich-export/issues"
+
+[project.scripts]
+immich-export = "immich_export.cli:app"
+
+[dependency-groups]
+dev = [
+  "mypy>=1.13",
+  "pytest>=8.3",
+  "pytest-asyncio>=0.24",
+  "respx>=0.22",
+  "ruff>=0.8",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/immich_export"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "UP", "B", "A", "C4", "SIM", "RUF", "PTH", "RET", "ARG"]
+
+[tool.ruff.lint.per-file-ignores]
+# pytest fixtures are frequently used only for their side effect
+"tests/**" = ["ARG001"]
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+files = ["src", "tests", "scripts"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.semantic_release]
+version_toml = ["pyproject.toml:project.version"]
+version_variables = ["src/immich_export/__init__.py:__version__"]
+commit_message = "chore(release): {version} [skip ci]"
+build_command = "python -m pip install uv && uv build"
+allow_zero_version = true
+
+[tool.semantic_release.branches.main]
+match = "main"
+
+[tool.semantic_release.changelog.default_templates]
+changelog_file = "CHANGELOG.md"

immich_export-0.0.2/renovate.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": ["config:recommended", ":semanticCommits", ":dependencyDashboard"],
+  "timezone": "Europe/Berlin",
+  "schedule": ["before 6am on monday"],
+  "prConcurrentLimit": 5,
+  "lockFileMaintenance": {
+    "enabled": true,
+    "schedule": ["before 6am on the first day of the month"]
+  },
+  "vulnerabilityAlerts": {
+    "labels": ["security"],
+    "schedule": ["at any time"],
+    "automerge": true
+  },
+  "packageRules": [
+    {
+      "description": "Auto-merge patch/minor once CI (lint/typecheck/test/build) is green — low risk, keeps the tree current without manual review.",
+      "matchUpdateTypes": ["patch", "minor", "digest"],
+      "automerge": true,
+      "automergeType": "pr",
+      "platformAutomerge": true
+    },
+    {
+      "description": "Major bumps always get a PR, never auto-merged — API/behaviour changes need a look.",
+      "matchUpdateTypes": ["major"],
+      "automerge": false,
+      "labels": ["major-update"]
+    },
+    {
+      "description": "Group all GitHub Actions bumps into one PR.",
+      "matchManagers": ["github-actions"],
+      "groupName": "GitHub Actions",
+      "automerge": true
+    }
+  ]
+}

immich_export-0.0.2/scripts/refresh_api_spec.py

@@ -0,0 +1,66 @@
+"""Refresh the vendored, pruned Immich OpenAPI spec used by the contract tests.
+
+Usage:
+    uv run python scripts/refresh_api_spec.py            # fetch from GitHub main
+    uv run python scripts/refresh_api_spec.py --ref v3.0.1
+    uv run python scripts/refresh_api_spec.py --from-file /path/to/spec.json
+
+The pruned file keeps only what the contract tests need: every path with its
+methods, and every schema with its property names. Re-running this against a
+new Immich release and then running `pytest tests/test_contract.py` tells you
+whether this tool still matches the API.
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+from typing import Any
+
+import httpx
+
+SPEC_URL = (
+    "https://raw.githubusercontent.com/immich-app/immich/{ref}/open-api/immich-openapi-specs.json"
+)
+OUTPUT = Path(__file__).resolve().parent.parent / "tests" / "data" / "immich-openapi.pruned.json"
+HTTP_METHODS = {"get", "put", "post", "delete", "patch", "head", "options"}
+
+
+def prune(spec: dict[str, Any]) -> dict[str, Any]:
+    paths = {
+        path: sorted(method for method in operations if method in HTTP_METHODS)
+        for path, operations in spec["paths"].items()
+    }
+    schemas = {
+        name: sorted(schema.get("properties", {}))
+        for name, schema in spec["components"]["schemas"].items()
+    }
+    return {
+        "immich_version": spec["info"]["version"],
+        "paths": paths,
+        "schemas": schemas,
+    }
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--ref", default="main", help="Immich git ref to fetch the spec from.")
+    parser.add_argument("--from-file", type=Path, help="Use a local spec file instead of fetching.")
+    args = parser.parse_args()
+
+    if args.from_file:
+        spec = json.loads(args.from_file.read_text(encoding="utf-8"))
+    else:
+        response = httpx.get(SPEC_URL.format(ref=args.ref), follow_redirects=True, timeout=60)
+        response.raise_for_status()
+        spec = response.json()
+
+    pruned = prune(spec)
+    OUTPUT.parent.mkdir(parents=True, exist_ok=True)
+    OUTPUT.write_text(json.dumps(pruned, indent=1, sort_keys=True) + "\n", encoding="utf-8")
+    print(f"Wrote {OUTPUT} (Immich {pruned['immich_version']})")
+
+
+if __name__ == "__main__":
+    main()

immich_export-0.0.2/src/immich_export/__init__.py

@@ -0,0 +1,3 @@
+"""immich-export — pull files *and* metadata out of Immich into a plain local tree."""
+
+__version__ = "0.0.2"

immich_export-0.0.2/src/immich_export/__main__.py

@@ -0,0 +1,5 @@
+"""Allow `python -m immich_export`."""
+
+from .cli import app
+
+app()