PhotoCraft LogoPhotoCraft

PhotoCraft-Anleitungen

Praktische Dokumentation aus dem upstream-Projekt storytold/photocraft—Installer, PSD-Workflows, agentenfähige CLI und Build aus dem Quellcode. PhotoCraft ist frühes Alpha: Rechnen Sie mit rauen Kanten und prüfen Sie die Release Notes zur heruntergeladenen Version.

Was PhotoCraft ist

PhotoCraft ist eine Open-Source-Neuimplementierung von Adobe Photoshop in reinem Rust (Clean Room). Es bietet Ebenen, Masken, Korrekturebenen, Ebenenstile, Text, Vektoren, Pinsel und echte PSD/PSB-Dateien in einer nativen App—offline, dual lizenziert unter MIT oder Apache-2.0, zum Nutzen und Studieren.
Menüs, Tastenkürzel, Panels und Werkzeuge sind bewusst vertraut. Ein GPU-Compositor auf wgpu (Metal, Vulkan, DX12, WebGPU), Copy-on-Write-Kacheln und multithreaded Filter halten die Bearbeitung lokal und schnell—für die Desktop-App ist keine Electron-Hülle nötig.
  • Status: frühes Alpha. Vieles von Photoshops Funktionsumfang existiert in irgendeiner Form, aber es ist noch kein täglicher Photoshop-Ersatz für jeden Profi-Workflow.
  • Größte Lücken heute: KI/generative Funktionen, fehlende Werkzeuge, Tiefe bei Typografie und Profi-Workflows sowie Plug-in-Kompatibilität.
  • Ehrliche Erwartung: Jeder Photoshop-Menüpunkt kann an einen Befehl angebunden sein, Anbindung heißt aber nicht volle Verhaltensparität. Für das aktuelle Bild Roadmap und Paritätsnotizen upstream bevorzugen.
  • Markenhinweis: Adobe und Photoshop sind Marken von Adobe Inc. PhotoCraft ist unabhängig und nicht mit Adobe verbunden.

Download und Installation

Offizielle Installer und Pakete für macOS, Windows, Linux, FreeBSD und den Web-Build hängen an jedem GitHub-Release. Starten Sie auf der Download-Seite dieser Website oder öffnen Sie die upstream-Releases-Seite für alle Artefakte und Prüfsummen.

Bevorzugen Sie die Download-Seite auf photocraftdl.com für kuratierte Links, oder durchsuchen Sie GitHub Releases für jeden Plattform-Build. Jedes Release liefert SHA256SUMS.txt zur Verifikation des Downloads.

Plattform-Pakete (Dateinamenmuster)

PlattformWas Sie nehmen sollten
WindowsMSI-Installer und portable ZIPs für x64, arm64 und x86 (z. B. photocraft-<ver>-windows-x64.msi). Installer und Executables sind code-signiert.
macOSUniversal-DMG für Apple Silicon + Intel (photocraft-<ver>-macos-universal.dmg), signiert und notarisiert. Optional CLI: photocraft-cli-<ver>-macos-universal.zip.
LinuxAppImage, Flatpak, .deb, .rpm und Tarball für x86_64 und aarch64. AppImage kann sich per AppImageUpdate (.zsync) selbst aktualisieren.
FreeBSDx86_64-Tarball mit Layout wie /usr/local (Runtime-Abhängigkeiten mit pkg installieren, dann entpacken).
Webphotocraft-web-<ver>.zip — statische Site für moderne Browser; auf jedem Static Server hosten oder den In-Browser-Editor anderswo auf dieser Site testen, wenn verfügbar.

Linux Flatpak – Schnellstart

  • Das Flatpak-Bundle braucht die freedesktop-Runtime von Flathub; flatpak bietet die Installation an.
  • flatpak install --user photocraft-<version>-linux-x86_64.flatpak (oder den aarch64-Build)
  • flatpak run ai.storyteller.photocraft

Linux AppImage-Tipp

  • Keine Installation nötig. Beim ersten Start kann unter ~/.local/share ein Launcher-Icon und Menüeintrag registriert werden, damit das Dock unter Wayland PhotoCrafts Icon zeigt.
  • PHOTOCRAFT_NO_DESKTOP_INTEGRATION=1 setzen, um Desktop-Integration zu überspringen.

macOS CLI-Notarisierung

Das CLI-Zip ist mit derselben Developer ID wie die App signiert und von Apple notarisiert. Eine nackte Binary kann kein angeheftetes Ticket wie das DMG tragen; der erste Start kann die Notarisierung online prüfen. Verifizieren mit:

  • ditto -x -k photocraft-cli-<version>-macos-universal.zip .
  • spctl --assess --type install -vv photocraft-cli-<version>-macos-universal/photocraft-cli
  • Erwartung etwa: accepted, source=Notarized Developer ID.

FreeBSD 14 (x86_64)

  • pkg install libxkbcommon wayland libX11 libXcursor libXrandr libXi libxcb mesa-libs vulkan-loader gtk3 fontconfig freetype2 alsa-lib
  • tar -xzf photocraft-<version>-freebsd-x86_64.tar.gz --strip-components 1 -C /usr/local
  • photocraft

Erster Start und tägliche Bearbeitung

Dokument öffnen, die vertraute Werkzeugoberfläche kennenlernen und ein paar Linux/Wayland-Besonderheiten kennen, bevor Sie PSD-Roundtrips oder Automatisierung vertiefen.

PhotoCraft starten und ein Bild oder PSD über Datei › Öffnen laden, oder beim Start aus dem Terminal einen Pfad übergeben (z. B. photocraft image.psd nach einem Source-Build). Die Bearbeitung bleibt auf Ihrem Rechner—für Kernwerkzeuge ist kein Cloud-Konto nötig.

Was Sie erwarten können

  • 53 Werkzeuge—Rechteck-/Ellipsen-Auswahl, Lasso, Objekt-/Schnellauswahl, Pinsel, Reparatur, Text, Stift/Formen, Abwedler/Nachbelichter und mehr.
  • Ebenen richtig umgesetzt — Gruppen, Schnittmasken, Pixel- und Vektormasken, Füll- und Korrekturebenen, Smart Objects mit Smart Filtern, Mischmodi, Deckkraft/Füllung und Verlauf.
  • Korrekturebenen halten Bearbeitungen live (Tonwertkorrektur, Kurven, Dynamik, Farbton/Sättigung u. a.), ohne Originalpixel zu zerstören.
  • Ebenenstile wie Schlagschatten, Leuchten, Kontur/Glanz, Kontur und Überlagerungen—auch auf Textebenen.
  • Text, Vektoren und Filter mit Live-Filtervorschau in Auswahlen; Freies Transformieren mit vollem Verlauf.
  • Farbtiefen — RGB, Graustufen, CMYK und Lab mit 8/16/32 Bit pro Kanal, ICC-Farbmanagement in reinem Rust.

Wayland Drag-and-Drop (Linux)

In einer Wayland-Sitzung lassen sich per Drag-and-Drop abgelegte Dateien im Fenster ggf. noch nicht öffnen—eine Limitation im Windowing-Stack unter egui. Workarounds:

  • Datei › Öffnen nutzen oder ein Bild im Dateimanager kopieren und mit Strg+V einfügen.
  • Drag-and-Drop wiederherstellen: unter XWayland starten: WAYLAND_DISPLAY= photocraft, oder dasselbe Muster für AppImage / Flatpak mit X11-Sockets wie upstream dokumentiert.

Export und Themes

  • „Exportieren als“ für Format, Qualität, Transparenz und Skalierung mit Vorschau und Größenschätzung; Schnellexport kann PNG mit einem Klick schreiben.
  • Zwischen Dark Pro, luftigem Studio und Classic in den App-Einstellungen wechseln.

PSD, Formate und Roundtrips

PhotoCrafts PSD-Unterstützung ist ein eigenständiges Crate nach Adobes öffentlicher Spezifikation, gegen reale Korpora getestet—kein dünner Wrapper um proprietären Code.

Geschichtete Photoshop-Dokumente öffnen, bearbeiten und speichern. Upstream berichtet: Beim erneuten Speichern bleibt das Rendering bei 307 von 309 psd-tools-Testdateien gleich (starke Ergebnisse auch auf gemischten Korpora). Eine neu gespeicherte Datei ist nicht byte-identisch zur Quelle: Bildressourcen, Ebenenrecords und die Komposition werden neu geschrieben. Nicht unterstützte Raw-Blöcke und Deskriptoren werden wenn möglich mitgeführt statt verworfen.

Formate jenseits von PSD

  • PSD / PSB — inkl. großer Dokumente, 16/32-Bit, CMYK und Lab.
  • Geschichtetes TIFF — Photoshop-Ebendaten in TIFF, beide Byte-Reihenfolgen.
  • OpenRaster — Lesen/Schreiben mit Ebenen, Gruppen und Mischmodi (Krita, MyPaint, GIMP).
  • Paint.NET PDN3 — Lesen mit bearbeitbaren Ebenen; SVG als Formen öffnen oder als Vektor-Smart Object platzieren.
  • Flache Formate — PNG, JPEG, TIFF, WebP, GIF, BMP, TGA, ICO, QOI, PNM, OpenEXR, Radiance HDR plus natives .pcraft.
  • Optional / eingeschränkt: HEIC nur Lesen in offiziellen Builds; AVIF-Schreiben mit optionalem Feature; Affinity-Dokumente nur lesend mit Warnungen bei nicht unterstützten Teilen.

Tipps für zuverlässige PSD-Arbeit

  • Kopien wichtiger Quell-PSDs vor intensiven Roundtrips behalten, während Sie Alpha-Verhalten prüfen.
  • Wenn nach dem Speichern etwas falsch wirkt: OS, Dokumentgröße, Ebenenzahl und Screenshot notieren, wenn Sie upstream ein Issue melden.
  • Codec-Details pro Format: upstream-Matrix der Codec-Fähigkeiten in den Repo-Docs.

CLI, Batch und Agenten

Jeder Menüpunkt, jedes Werkzeug und jeder Dialog läuft über ein Registry mit 500+ Befehlen. UI, CLI, JSON-Control-Channel und MCP-Server rufen dieselbe Engine auf—alles, was Sie klicken können, kann ein Skript oder Agent steuern.

Headless-Bearbeitungsbeispiel (Befehlsnamen und Parameter folgen der upstream-CLI-Hilfe Ihrer installierten Version):
  • photocraft-cli run wave.psd --cmd filter.sharpen.smartSharpen --params '{"amount":80}' --cmd layer.newAdjustmentLayer.curves --params '{"points":[[0,0],[64,48],[192,212],[255,255]]}' --out wave-final.png
  • photocraft-cli batch --actions grade.json --in ./raw --out ./graded
  • photocraft-cli batch --help — jedes Subkommando erklärt sich selbst.
  • photocraft-cli mcp — Agent steuert PhotoCraft über MCP (headless oder an laufende App angebunden).

Desktop-Control-Channel

Die Desktop-App kann einen authentifizierten, nur-loopback Control Channel (photocraft --control) bereitstellen—UI-Zustand inspizieren, Werkzeuge per Pointer-Events steuern, Offscreen-Screenshots. Das Protokoll dokumentiert upstream in docs/control-protocol.md.

Aus dem Quellcode bauen

Upstream-Repository klonen, Desktop-App im Release-Modus starten und optional craft-fonts für gebündelte CJK-UI-/Schriftarten setzen.

Sie brauchen eine aktuelle Rust-Toolchain. Neue Mitwirkende und KI-Agenten sollten mit upstream AGENTS.md beginnen, dann den docs/-Baum und das Dokumentationsbuch.

Minimaler Desktop-Start

  • git clone https://github.com/storytold/photocraft
  • cd photocraft
  • cargo run --release -p photocraft -- image.psd
  • cargo test --workspace — Testsuite nach Codeänderungen ausführen.

Optionale Japanisch-/CJK-Schriftarten (craft-fonts)

Japanische Schriften für UI und Textwerkzeug kommen aus craft-fonts, optionalem Build-Input (Desktop-Release-Builds enthalten es immer). Ohne nutzt PhotoCraft System-CJK-Schriftarten:

  • git clone https://github.com/storytold/craft-fonts ../craft-fonts
  • CRAFT_FONTS_DIR="$PWD/../craft-fonts" cargo run --release -p photocraft

Test-Korpora

  • PhotoCraft wird gegen echte Dateien getestet (Oracle-PSDs, psd-tools, ag-psd, PngSuite), gepinnt und per Checksumme verifiziert.
  • Abruf mit cargo xtask corpus --all, Lauf mit cargo xtask test-corpus (Details in upstream docs/development.md).

Mit upstream synchron bleiben

Flags, Paketnamen und Paritätsstatus ändern sich mit jedem Release. README, Release Notes und Docs zum ausgecheckten Commit oder Tag bevorzugen—not ältere Community-Snapshots. Upstream-Repository: github.com/storytold/photocraft.

Hilfe erhalten

Wenn etwas kaputtgeht, Issue mit OS, Dokumentgröße, Ebenenzahl und Screenshot melden. Sie können auch im ArtCraft-Discord fragen, verlinkt von der upstream-Projektseite.
PhotoCraft-Anleitungen | Installation, PSD, CLI & Build