Start · Installation 10 Min.
Wenn PhotoCraft sich nicht öffnet
Die meisten fehlgeschlagenen Starts sind die falsche Datei, nicht ein kaputter Editor. Prüfe den Dateinamen gegen den Rechner, bevor du zum zweiten Mal neu installierst.
Prüfe, ob du die App gestartet hast
Das Zip „Source code“ und photocraft-web-<ver>.zip öffnen von allein kein Desktop-Fenster. Das Web-Zip ist eine Website zum Hosten, beschrieben in PhotoCraft im Browser. Die Desktop-Namen sind das MSI, das portable Zip, das DMG, das AppImage, das Flatpak, das deb, das rpm und die Plattform-Tarballs in Welche PhotoCraft-Datei du herunterlädst.
Ein Windows-PC mit ARM braucht den arm64-Build. Ein PC mit Intel oder AMD braucht x64. Die Dateiliste von v0.23.1 auf der Produktseite hatte keinen 32-Bit-Windows-Installer. Ein Mac nutzt das universelle DMG, für Apple Silicon und für Intel.
Grafik und Wayland
Die README beschreibt einen GPU-Compositor auf Metal, Vulkan, DirectX 12 und WebGPU. Ein aktueller Treiber für diesen Weg zählt mehr als noch eine Kopie desselben Installers. Auf dem Mac nutzt die Leinwand Metal. Unter Windows will sie DirectX 12 oder Vulkan. Unter Linux will sie Vulkan.
In einer Wayland-Sitzung sagt die README, dass Dateien, die auf das Fenster fallen, noch nicht geöffnet werden. Nutze File, dann Open, oder kopiere das Bild und füge es ein. Ziehen und Ablegen funktioniert unter XWayland, und die README zeigt, dafür WAYLAND_DISPLAY zu leeren. Eine fraktionale Skalierung unter XWayland kann weich aussehen. Natives Wayland bleibt scharf und behält die Einschränkung beim Ablegen.
Wenn ein echter Build immer noch scheitert
PhotoCraft ist frühe Alpha. Ein Absturz mit dem richtigen Installer ist ein Fehler, kein Rätsel, das du mit einem Download von einem fremden Spiegel löst. Die README bittet beim Melden um Betriebssystem, Dokumentgröße, Ebenenanzahl und einen Screenshot.
Melde es auf dem Repository oder im Discord. Öffnet sich das Fenster und schließt sich dann wieder, zeigt die Statusleiste „CPU Rendering“, oder wird eine Datei wegen des Speichers abgelehnt, stehen die Schritte auf Wenn sich das Fenster schließt oder die Leinwand langsam ist. Lies Was frühe Alpha bedeutet, bevor du entscheidest, die Alpha sei bereit für Arbeit, die du nicht wiederholen kannst.
Bestätige die Installation selbst, bevor du sie einen Absturz nennst
Ein Fenster, das nie erscheint, ist oft das falsche Artefakt. Das Quelltext-Zip startet den Editor nicht. Das Web-Zip muss gehostet werden, und das ist PhotoCraft im Browser. Der Desktop-Weg ist der in Welche PhotoCraft-Datei du herunterlädst. Unter Windows braucht eine Installation pro Benutzer keinen Administrator, und Everyone on this computer braucht einen. Nur eine installierte Kopie ist erlaubt, also lässt dich ein halb fertiger Wechsel zwischen den beiden mit der Kopie zurück, die du nicht entfernt hast. Der portable Build ist die exe im Zip, mit PhotoCraftData daneben. Auf einem Mac ist die App die, die du aus dem universellen Image nach Applications gezogen hast. Unter Linux muss ein AppImage die Datei sein, die du startest. Ein deb, das du heruntergeladen und nie installiert hast, ist weiterhin eine Datei. Das Flatpak, das du startest, ist flatpak run ai.storyteller.photocraft, nach flatpak install --user. Unter FreeBSD gehört der Tarball unter /usr/local, mit den Bibliotheken, die der Installationsleitfaden listet.
Der Installationsleitfaden druckt noch 32-Bit-Dateinamen für Windows. Die Assets der Produktseite zu v0.23.1 enthielten sie nicht. Ein alter Blog, der ein x86-MSI anbietet, ist keine neuere Quelle als das Release, das du offen hast. Das Community-Overlay von Gentoo ist optionale Paketierung und wird nicht vom PhotoCraft-Team gepflegt. Die Seite, von der diese Installationsformen stammen, ist Installieren und aktualisieren.
Flags für einen Start, der Hilfe braucht
Die meisten Leute brauchen nie ein Startflag. Du kannst einen oder mehrere Dateinamen auf der Kommandozeile übergeben, und PhotoCraft öffnet sie. Unter Windows und Linux wird eine Datei, die du öffnest, während PhotoCraft schon läuft, ein neuer Tab in dieser Kopie. Füge --new-instance hinzu, wenn du stattdessen eine eigene Kopie willst. Manche Leute sehen weiterhin neue Fenster statt Tabs. Dieser Bericht ist offen, und er steht mit den anderen offenen Problemen auf Wenn sich das Fenster schließt oder die Leinwand langsam ist.
--safe-gpu startet diesen einen Start auf dem CPU-Renderer. --in-window-menus hält die Menüs auf einem Mac im Fenster statt in der Systemmenüleiste. --present-mode nimmt fifo, autovsync oder novsync, und --frame-latency nimmt 1, 2 oder 3. Diese beiden ändern, wie Frames die Anzeige erreichen. PHOTOCRAFT_CONFIG_DIR richtet die Einstellungen von PhotoCraft auf einen Ordner, den du wählst, und das ist nützlich, wenn ein Einstellungsverzeichnis im portablen Stil nicht am Standardort liegen soll. photocraft --help druckt den Satz. Der Grafik-Rückfall, der ohne Flags geschieht, Vulkan, dann DirectX 12, dann die CPU unter Windows, ist die längere Geschichte auf Wenn sich das Fenster schließt oder die Leinwand langsam ist.
Deinstallieren löscht deine Bilder nicht. Windows entfernt die App unter Settings, dann Apps. Das portable Zip entfernst du, indem du seinen Ordner löschst. macOS verschiebt PhotoCraft aus Applications in den Papierkorb. Linux nutzt den Paketmanager, flatpak uninstall ai.storyteller.photocraft, oder löscht das AppImage oder den ausgepackten Tarball. Die Einstellungen bleiben, bis du den Einstellungsordner löschst. Schließt sich ein echter Build nach der richtigen Installation weiterhin, melde es mit dem Betriebssystem, der Dokumentgröße, der Ebenenanzahl und einem Screenshot. Ob die Alpha das richtige Werkzeug ist, sobald sie sich öffnet, ist Was frühe Alpha bedeutet.