Zum Hauptinhalt springen
Version: Aktuell

Erste Schritte

Der Ablauf​

Der Weg vom Download bis zur laufenden Live-Synchronisierung:

  1. Lade die komprimierte Version (.gz) für dein Betriebssystem herunter und entpacke sie (du erhältst artprog / artprog.exe).
  2. artprog setup — Lege sie in deinen PATH (und füge bei Bedarf das Kürzel „art" hinzu).
  3. artprog auth login — Melde dich an: es öffnet deinen Browser, du bestätigst das Gerät und bist verbunden.
  4. artprog init — Verknüpfe diesen Ordner mit einem Web-Projekt.
  5. artprog scan — Optional: Erfasse und synchronisiere die Assets deines Projekts sofort, einmalig. Du kannst das überspringen — watch erledigt es fortlaufend.
  6. artprog watch — Starte die Live-Synchronisierung und lass sie laufen: einrichten und vergessen. Änderungen fließen in beide Richtungen (Godot ↔ Web-Editor), neue Dateien, die du hineinlegst, werden hochgeladen, im Web erstellte Assets erscheinen auf der Festplatte, Godots Re-Imports (uids) werden abgeglichen und die Projekt-Einstellungen gespiegelt — von selbst. Arbeite, wo du willst; alles Echte synchronisiert sich. Strg-C beendet sie. scan / push / pull brauchst du kaum noch von Hand.
  7. artprog push / artprog pull — Lieber einmalig statt mit dem Watcher? Lade deine lokalen Pixel hoch, hole die aktuellen Pixel aus dem Web, oder adoptiere im Web erstellte Assets auf die Festplatte — jeweils bei Bedarf.
hinweis

Beim Verknüpfen entsteht ein Ordner .artprog/ mit config.json — der Projekt-Link plus der Sync-Status je Asset. Er kann gefahrlos eingecheckt werden; wer das Repository klont, ist bereits verknüpft.

hinweis

watch und scan respektieren die .gitignore deines Projekts (im Wurzelverzeichnis): git-ignorierte Dateien — sowie Godots .godot/-Cache, .import-Begleitdateien und Nicht-Asset-Dateien — werden nie synchronisiert. So bleiben Notiz-, Entwurfs- und geheime Dateien lokal.

Hinweise zum ersten Start​

Jede Version ist eine einzelne, nicht signierte ausführbare Datei — dein System warnt dich daher beim ersten Start möglicherweise.

Windows​

  • Entpacke artprog-windows.gz mit 7-Zip (oder einem ähnlichen Tool) — es wird zu artprog.exe entpackt, direkt ausführbar.
  • Windows SmartScreen meldet eventuell einen unbekannten Herausgeber (die Datei ist nicht signiert). Klicke auf „Weitere Informationen" und dann „Trotzdem ausführen".
  • Es ist eine einzelne .exe — es gibt keinen Installer.
  • artprog setup — Fügt artprog deinem PATH hinzu, damit du es in jedem Terminal aufrufen kannst.

macOS (Apple Silicon)​

  • Entpacke sie: gunzip -N artprog-macos.gz — du erhältst artprog.
  • Gatekeeper blockiert die Datei eventuell, weil sie nicht signiert ist. Klicke mit der rechten Maustaste auf die Datei und wähle „Öffnen", oder erlaube sie unter Systemeinstellungen → Datenschutz & Sicherheit.
  • chmod +x artprog — Mache die Datei vor dem ersten Start ausführbar.
  • artprog setup — Fügt artprog deinem PATH hinzu.
  • Derzeit wird nur Apple Silicon (arm64) gebaut; Intel-Macs werden noch nicht unterstützt.

Linux​

  • Entpacke sie: gunzip -N artprog-linux.gz — du erhältst artprog.
  • chmod +x artprog — Mache die Datei ausführbar und starte sie.
  • artprog setup — Fügt artprog deinem PATH hinzu.
  • Die Anmeldung speichert dein Token im System-Schlüsselbund, daher muss ein Secret-Service-Anbieter (gnome-keyring oder KWallet) verfügbar sein. Ist keiner vorhanden, meldet die CLI dies mit einer klaren Fehlermeldung.
Optional: das Kürzel „art"

Nach dem Setup kannst du ein kurzes Kürzel hinzufügen: artprog setup --alias. Lass es weg, wenn du den ART-Rohbild-Editor verwendest.

Die vollständige Befehlsübersicht steht unter Befehle.