chronocatalog-desktop 0.1.0__tar.gz

chronocatalog_desktop-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,61 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  QT_QPA_PLATFORM: offscreen
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: "3.13"
+      - name: Install package
+        run: python -m pip install -e ".[dev]"
+      - name: Ruff lint
+        run: ruff check .
+      - name: Ruff format
+        run: ruff format --check .
+      - name: Mypy
+        run: mypy
+
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.11", "3.13"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install Qt runtime libraries (Linux)
+        if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install -y libegl1 libgl1 libxkbcommon0
+      - name: Install ExifTool (Linux)
+        if: runner.os == 'Linux'
+        run: sudo apt-get install -y libimage-exiftool-perl
+      - name: Install ExifTool (macOS)
+        if: runner.os == 'macOS'
+        run: brew install exiftool
+      - name: Show ExifTool version
+        run: exiftool -ver
+      - name: Install package
+        run: python -m pip install -e ".[dev]"
+      - name: Run tests
+        run: pytest --cov=chronocatalog_desktop --cov-report=term-missing --cov-fail-under=85

chronocatalog_desktop-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,139 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+env:
+  QT_QPA_PLATFORM: offscreen
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: "3.13"
+      - name: Install Qt runtime libraries
+        run: sudo apt-get update && sudo apt-get install -y libegl1 libgl1 libxkbcommon0
+      - name: Install ExifTool
+        run: sudo apt-get install -y libimage-exiftool-perl
+      - name: Run checks
+        run: |
+          python -m pip install -e ".[dev]"
+          ruff check .
+          ruff format --check .
+          mypy
+          pytest -q
+      - name: Tag must match the package version
+        run: |
+          version=$(python -c "import chronocatalog_desktop; print(chronocatalog_desktop.__version__)")
+          test "v$version" = "$GITHUB_REF_NAME" || {
+            echo "tag $GITHUB_REF_NAME does not match version $version" >&2
+            exit 1
+          }
+      - name: Build distributions
+        run: |
+          python -m pip install build twine
+          python -m build
+          twine check dist/*
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      # PyPI Trusted Publishing: configure this repository as a trusted
+      # publisher on pypi.org (project: chronocatalog-desktop, workflow:
+      # release.yml, environment: pypi). No stored tokens.
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # release/v1
+
+  github-release:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: dist
+          path: dist/
+      - name: Extract this version's changelog section
+        run: |
+          awk -v version="${GITHUB_REF_NAME#v}" '
+            $0 ~ "^## \\[" version "\\]" { found = 1; next }
+            found && /^## \[/ { exit }
+            found { print }
+          ' CHANGELOG.md > release-notes.md
+          test -s release-notes.md || {
+            echo "no changelog section for $GITHUB_REF_NAME" >&2
+            exit 1
+          }
+      - name: Create GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release create "$GITHUB_REF_NAME" dist/* \
+            --repo "$GITHUB_REPOSITORY" \
+            --title "$GITHUB_REF_NAME" \
+            --notes-file release-notes.md
+
+  macos-app:
+    # Unsigned ad-hoc build: macOS blocks the first launch until the user
+    # approves it under System Settings > Privacy & Security > Open Anyway.
+    # Signing and notarization land when there is a Developer ID to sign with.
+    needs: github-release
+    runs-on: macos-15 # arm64
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6
+        with:
+          python-version: "3.13"
+      - name: Build the app bundle
+        run: |
+          python -m pip install -e . pyinstaller
+          python assets/make_icon.py
+          pyinstaller --noconfirm ChronoCatalog.spec
+      - name: App must start
+        env:
+          QT_QPA_PLATFORM: offscreen
+        run: |
+          dist/ChronoCatalog.app/Contents/MacOS/ChronoCatalog &
+          sleep 8
+          kill -0 $! || { echo "bundled app exited early" >&2; exit 1; }
+          kill $!
+      - name: Package the disk image
+        run: |
+          brew install create-dmg
+          create-dmg \
+            --volname ChronoCatalog \
+            --window-size 540 380 \
+            --icon-size 128 \
+            --icon ChronoCatalog.app 140 180 \
+            --app-drop-link 400 180 \
+            "dist/ChronoCatalog-$GITHUB_REF_NAME-arm64.dmg" \
+            dist/ChronoCatalog.app
+      - name: Attach to the release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release upload "$GITHUB_REF_NAME" \
+            "dist/ChronoCatalog-$GITHUB_REF_NAME-arm64.dmg" \
+            --repo "$GITHUB_REPOSITORY"

chronocatalog_desktop-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+*.pyc
+.venv/
+.coverage
+dist/
+demo/archive/
+demo/card/
+demo/demo.toml
+build/
+assets/icon.icns
+assets/icon.iconset/

chronocatalog_desktop-0.1.0/CHANGELOG.md

@@ -0,0 +1,67 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-07-10
+
+### Fixed
+
+- Files excluded by import ignore patterns are counted in the Organize
+  summary, and a folder where every file is excluded says so explicitly
+  in Organize and Import instead of rendering as empty.
+
+### Changed
+
+- Groups replace families throughout, matching chronocatalog 0.2
+  vocabulary; requires chronocatalog >= 0.2.
+- Depends on PySide6-Essentials instead of the full PySide6
+  metapackage — the app uses no Addons module, and the packaged
+  bundle is roughly half the size.
+
+### Added
+
+- App icon: an aperture iris with clock hands in the opening, drawn
+  from geometry at every size (small sizes are redrawn bolder, not
+  downscaled).
+- macOS app bundle: releases attach an Apple Silicon .dmg built with
+  PyInstaller; the bundle is ad-hoc signed until there is a Developer
+  ID, and the README documents the one-time Open Anyway step.
+- Dark theme: graphite palette with a safelight-amber accent.
+- Background worker: library calls run off the UI thread with
+  throttled progress events and a cooperative stop flag.
+- Application shell: archive-centric window with a sidebar of views
+  and an Overview of the archive and its trees.
+- Verify view: findings in library order colored by library severity,
+  plain-language explanations, structured date-mismatch details, live
+  progress and Stop.
+- History view: every run against the archive with its originating
+  command, timestamp and status; Undo for applied runs, Resume for
+  interrupted ones.
+- Rename view: the plan as old → new with the changed span
+  highlighted, groups kept whole, apply with confirm and Stop.
+- Terminal transparency: a quiet >_ toggle reveals each action's
+  exact CLI command with Copy, and confirmation dialogs carry the
+  command under Show Details.
+- Demo archive generator for a safe tour of every view.
+- Import view: card to archive with live progress, problem list and
+  the safe-to-format verdict — green only when the library itself
+  issues it.
+- Organize view: report-only triage of messy folders with a hand-off
+  to Import for confirmed batches.
+- DAM hand-off in the Rename view: masters the DAM must rename itself
+  are listed with their tokens and the in-DAM checklist; writing tokens
+  is its own confirmed action, verified by reading each token back.
+- Hardening for huge archives: capped rendering with exact counts
+  everywhere, accurate post-apply import summaries (failed groups are
+  never reported as copied), History capped and guarded against
+  double-clicks.
+- Settings view: edit the archive configuration with validation before
+  every save and hand-written comments preserved; the naming pattern is
+  shown read-only. First-run flow can create a new archive config.
+- Design pass: one clean surface per card (no label striping), sidebar
+  wordmark, empty states on every action view, tinted verdict banner,
+  severity stripes, status pills, calm undo, styled form controls, and
+  per-view status messages that can no longer go stale.

chronocatalog_desktop-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,42 @@
+# Contributing
+
+## Development setup
+
+```console
+$ python3 -m venv .venv
+$ .venv/bin/pip install -e ".[dev]"
+```
+
+To develop against a local `chronocatalog` checkout (changing library
+and app in lockstep), install it editable first:
+
+```console
+$ .venv/bin/pip install -e ../chronocatalog -e ".[dev]"
+```
+
+[ExifTool](https://exiftool.org/) must be on `PATH`; integration tests
+skip without it, but CI always runs them. Tests run Qt headless
+(`QT_QPA_PLATFORM=offscreen`); no display is needed.
+
+## Checks
+
+Everything CI runs, locally:
+
+```console
+$ ruff format --check .
+$ ruff check .
+$ mypy
+$ pytest --cov=chronocatalog_desktop
+```
+
+All four must pass; coverage is gated at 85%.
+
+## Expectations
+
+- Every change ships with tests and any needed documentation in the same
+  commit.
+- The app adds no behavior of its own: every screen renders the
+  library's plans and reports, and every mutation goes through the same
+  validated, journaled engine as the CLI. Treat a change that would
+  bypass that as a design discussion, not a patch.
+- Conventional Commits (`feat:`, `fix:`, `docs:`, `ci:`, `chore:`).

chronocatalog_desktop-0.1.0/ChronoCatalog.spec

@@ -0,0 +1,35 @@
+# PyInstaller build for the macOS app bundle.
+# Build with: pyinstaller --noconfirm ChronoCatalog.spec
+
+a = Analysis(
+    ["src/chronocatalog_desktop/__main__.py"],
+    datas=[("src/chronocatalog_desktop/resources", "chronocatalog_desktop/resources")],
+)
+pyz = PYZ(a.pure)
+
+exe = EXE(
+    pyz,
+    a.scripts,
+    exclude_binaries=True,
+    name="ChronoCatalog",
+    console=False,
+)
+
+coll = COLLECT(
+    exe,
+    a.binaries,
+    a.datas,
+    name="ChronoCatalog",
+)
+
+app = BUNDLE(
+    coll,
+    name="ChronoCatalog.app",
+    icon="assets/icon.icns",
+    bundle_identifier="org.chronocatalog.desktop",
+    info_plist={
+        "CFBundleDisplayName": "ChronoCatalog",
+        "NSHighResolutionCapable": True,
+        "LSMinimumSystemVersion": "12.0",
+    },
+)

chronocatalog_desktop-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jakub Stefanski
+
+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.

chronocatalog_desktop-0.1.0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: chronocatalog-desktop
+Version: 0.1.0
+Summary: Desktop app for ChronoCatalog photo and video archives
+Project-URL: Homepage, https://github.com/chronocatalog/chronocatalog-desktop
+Project-URL: Repository, https://github.com/chronocatalog/chronocatalog-desktop
+Project-URL: Changelog, https://github.com/chronocatalog/chronocatalog-desktop/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/chronocatalog/chronocatalog-desktop/issues
+Author-email: Jakub Stefanski <js@jakubstefanski.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: archive,exif,gui,photography,qt,rename,video
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: MacOS X
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: System :: Archiving
+Requires-Python: >=3.11
+Requires-Dist: chronocatalog>=0.2
+Requires-Dist: pyside6-essentials>=6.7
+Requires-Dist: tomlkit>=0.12
+Provides-Extra: dev
+Requires-Dist: mypy>=1.13; extra == 'dev'
+Requires-Dist: pyside6>=6.7; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# ChronoCatalog Desktop
+
+Desktop app for [ChronoCatalog](https://github.com/chronocatalog/chronocatalog)
+photo and video archives.
+
+The design premise: the CLI already plans everything before touching
+anything, so the app is a renderer of those plans and reports — every
+view is a dry run, and Apply goes through the same validated, journaled
+engine. Views are named after the commands they wrap (Verify, Rename,
+History), and the exact terminal equivalent of every action is one
+click away.
+
+## Status
+
+Early development.
+
+## Install
+
+**macOS (Apple Silicon):** download `ChronoCatalog-<version>-arm64.dmg`
+from [Releases](https://github.com/chronocatalog/chronocatalog-desktop/releases)
+and drag the app to Applications. The build is not yet signed with an
+Apple Developer ID, so the first launch is blocked: open **System
+Settings → Privacy & Security**, scroll to Security and click
+**Open Anyway**. This is needed once.
+
+**Any platform (Python 3.11+):**
+
+```console
+$ uv tool install chronocatalog-desktop
+```
+
+or `pipx install chronocatalog-desktop`. Either way you also need
+[ExifTool](https://exiftool.org/) on `PATH` (macOS:
+`brew install exiftool`).
+
+## Run
+
+```console
+$ chronocatalog-desktop [archive.toml]
+```
+
+Without an argument the app asks for an archive configuration and
+remembers it. Everything is a dry run until Apply, which confirms
+first; every applied change lands in History with Undo (and Resume,
+for interrupted runs).
+
+## Demo archive
+
+Builds a small throwaway archive under `demo/archive` (macOS: uses
+`sips`), imports it through the real engine, then plants a date edit,
+an unnamed file and an orphan sidecar so every view has something to
+show:
+
+```console
+$ python demo/make_demo.py
+$ chronocatalog-desktop demo/demo.toml
+```
+
+## Requirements
+
+- Python 3.11+
+- [ExifTool](https://exiftool.org/) on `PATH`
+
+## License
+
+[MIT](LICENSE)

chronocatalog_desktop-0.1.0/README.md

@@ -0,0 +1,66 @@
+# ChronoCatalog Desktop
+
+Desktop app for [ChronoCatalog](https://github.com/chronocatalog/chronocatalog)
+photo and video archives.
+
+The design premise: the CLI already plans everything before touching
+anything, so the app is a renderer of those plans and reports — every
+view is a dry run, and Apply goes through the same validated, journaled
+engine. Views are named after the commands they wrap (Verify, Rename,
+History), and the exact terminal equivalent of every action is one
+click away.
+
+## Status
+
+Early development.
+
+## Install
+
+**macOS (Apple Silicon):** download `ChronoCatalog-<version>-arm64.dmg`
+from [Releases](https://github.com/chronocatalog/chronocatalog-desktop/releases)
+and drag the app to Applications. The build is not yet signed with an
+Apple Developer ID, so the first launch is blocked: open **System
+Settings → Privacy & Security**, scroll to Security and click
+**Open Anyway**. This is needed once.
+
+**Any platform (Python 3.11+):**
+
+```console
+$ uv tool install chronocatalog-desktop
+```
+
+or `pipx install chronocatalog-desktop`. Either way you also need
+[ExifTool](https://exiftool.org/) on `PATH` (macOS:
+`brew install exiftool`).
+
+## Run
+
+```console
+$ chronocatalog-desktop [archive.toml]
+```
+
+Without an argument the app asks for an archive configuration and
+remembers it. Everything is a dry run until Apply, which confirms
+first; every applied change lands in History with Undo (and Resume,
+for interrupted runs).
+
+## Demo archive
+
+Builds a small throwaway archive under `demo/archive` (macOS: uses
+`sips`), imports it through the real engine, then plants a date edit,
+an unnamed file and an orphan sidecar so every view has something to
+show:
+
+```console
+$ python demo/make_demo.py
+$ chronocatalog-desktop demo/demo.toml
+```
+
+## Requirements
+
+- Python 3.11+
+- [ExifTool](https://exiftool.org/) on `PATH`
+
+## License
+
+[MIT](LICENSE)

chronocatalog_desktop-0.1.0/assets/make_icon.py

@@ -0,0 +1,144 @@
+"""Render the app icon: an aperture iris with clock hands in the opening.
+
+Regenerates every size from geometry — there is no source image. Small
+sizes are redrawn with heavier strokes and less detail rather than
+downscaled, so the mark stays legible in the Dock and the menu bar.
+
+Usage:
+    python assets/make_icon.py
+
+Writes the window icon into the package resources, and on macOS also
+builds assets/icon.icns via iconutil.
+"""
+
+from __future__ import annotations
+
+import math
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+os.environ.setdefault("QT_QPA_PLATFORM", "offscreen")
+
+from PySide6 import QtCore, QtGui, QtWidgets
+
+GRAPHITE = QtGui.QColor("#1e2128")
+GRAPHITE_EDGE = QtGui.QColor("#16181d")
+AMBER = QtGui.QColor("#e8a33d")
+HANDS = QtGui.QColor("#e9e7e2")
+
+#: side of the generated square, one render per icns slot
+ICONSET_SIZES = (16, 32, 64, 128, 256, 512, 1024)
+
+
+def _pen(color: QtGui.QColor, width: float) -> QtGui.QPen:
+    pen = QtGui.QPen(color, width)
+    pen.setCapStyle(QtCore.Qt.PenCapStyle.RoundCap)
+    return pen
+
+
+def draw(painter: QtGui.QPainter, size: int) -> None:
+    center = QtCore.QPointF(size / 2, size / 2)
+    small = size <= 64
+    tiny = size <= 16
+
+    tile = QtCore.QRectF(size * 0.06, size * 0.06, size * 0.88, size * 0.88)
+    gradient = QtGui.QLinearGradient(0, tile.top(), 0, tile.bottom())
+    gradient.setColorAt(0.0, GRAPHITE)
+    gradient.setColorAt(1.0, GRAPHITE_EDGE)
+    painter.setPen(QtCore.Qt.PenStyle.NoPen)
+    painter.setBrush(gradient)
+    painter.drawRoundedRect(tile, size * 0.20, size * 0.20)
+
+    ring_r = size * 0.315
+    painter.setPen(_pen(AMBER, size * (0.055 if small else 0.036)))
+    painter.setBrush(QtCore.Qt.BrushStyle.NoBrush)
+    painter.drawEllipse(center, ring_r, ring_r)
+
+    if not tiny:
+        # aperture iris: six pinwheel blades from the rim to the opening
+        outer_r = ring_r * 0.92
+        open_r = ring_r * 0.54
+        painter.setPen(_pen(AMBER, size * (0.045 if small else 0.028)))
+        twist = math.radians(62.0)
+        for i in range(6):
+            start = math.tau * i / 6
+            painter.drawLine(
+                QtCore.QPointF(
+                    center.x() + outer_r * math.cos(start),
+                    center.y() + outer_r * math.sin(start),
+                ),
+                QtCore.QPointF(
+                    center.x() + open_r * math.cos(start + twist),
+                    center.y() + open_r * math.sin(start + twist),
+                ),
+            )
+
+    # clock hands at 10:08; the aperture opening is the dial
+    hands = ((-60.0, 0.26, 0.046), (35.0, 0.40, 0.032))
+    if tiny:
+        hands = ((-60.0, 0.42, 0.085), (35.0, 0.62, 0.065))
+    elif small:
+        hands = ((-60.0, 0.26, 0.060), (35.0, 0.40, 0.048))
+    for angle_deg, length, width in hands:
+        angle = math.radians(angle_deg - 90.0)
+        painter.setPen(_pen(HANDS, size * width))
+        painter.drawLine(
+            center,
+            QtCore.QPointF(
+                center.x() + ring_r * length * math.cos(angle),
+                center.y() + ring_r * length * math.sin(angle),
+            ),
+        )
+
+    if not small:
+        painter.setPen(QtCore.Qt.PenStyle.NoPen)
+        painter.setBrush(AMBER)
+        painter.drawEllipse(center, size * 0.024, size * 0.024)
+
+
+def render(size: int) -> QtGui.QImage:
+    image = QtGui.QImage(size, size, QtGui.QImage.Format.Format_ARGB32)
+    image.fill(QtCore.Qt.GlobalColor.transparent)
+    painter = QtGui.QPainter(image)
+    painter.setRenderHint(QtGui.QPainter.RenderHint.Antialiasing)
+    draw(painter, size)
+    painter.end()
+    return image
+
+
+def main() -> None:
+    QtWidgets.QApplication.instance() or QtWidgets.QApplication([])
+    assets = Path(__file__).resolve().parent
+    package = assets.parent / "src" / "chronocatalog_desktop"
+
+    resources = package / "resources"
+    resources.mkdir(exist_ok=True)
+    render(256).save(str(resources / "icon.png"))
+
+    iconset = assets / "icon.iconset"
+    if iconset.exists():
+        shutil.rmtree(iconset)
+    iconset.mkdir()
+    for size in ICONSET_SIZES:
+        image = render(size)
+        if size < 1024:
+            image.save(str(iconset / f"icon_{size}x{size}.png"))
+        if size > 16:
+            image.save(str(iconset / f"icon_{size // 2}x{size // 2}@2x.png"))
+
+    if sys.platform == "darwin" and shutil.which("iconutil"):
+        subprocess.run(
+            ["iconutil", "-c", "icns", str(iconset), "-o", str(assets / "icon.icns")],
+            check=True,
+        )
+        shutil.rmtree(iconset)
+        print(f"wrote {resources / 'icon.png'} and {assets / 'icon.icns'}")
+    else:
+        print(f"wrote {resources / 'icon.png'} and {iconset}/ (no iconutil; icns skipped)")
+
+
+if __name__ == "__main__":
+    main()