Photoshop

Dies ist die Integrationsanleitung für das offizielle Photoshop UXP Plugin. API-Referenz: OAuth, Medien, Portfolios.

Voraussetzungen

• Adobe Photoshop 23+ (UXP)
• Creative Cloud Desktop (zur Installation der .ccx-Datei)
• ArtInStack-Konto mit mindestens einem im Dashboard erstellten Portfolio
• .ccx von Software

Installation

1. Laden Sie ArtInStack-Photoshop-latest.ccx unter Software herunter
2. Doppelklicken Sie auf die .ccx-Datei (oder öffnen Sie sie mit Creative Cloud Desktop), um sie in Photoshop zu installieren
3. Starten Sie Photoshop neu, wenn das Bedienfeld nicht angezeigt wird
4. Öffnen Sie Plugins → ArtInStack

Private Beta / Entwicklung: Laden Sie manifest.json mit UXP Developer Tools anstelle der .ccx-Datei.

Verbinden (Device Code)

Photoshop UXP kann keinen Loopback-HTTP-Listener binden. Daher verwendet das Plugin den OAuth 2.0 Device Authorization Grant (nicht Authorization Code + PKCE).

1. Klicken Sie im ArtInStack-Bedienfeld auf Connect
2. Das Plugin fordert einen Device Code an und öffnet /oauth/device in Ihrem Browser
3. Melden Sie sich bei Aufforderung an, geben Sie den im Bedienfeld angezeigten Benutzercode ein (falls verlangt) und genehmigen Sie die Berechtigungsbereiche
4. Das Plugin fragt /api/oauth/token bis zur Genehmigung regelmäßig ab und speichert dann Zugriffs- und Aktualisierungstoken
5. Nach der Einwilligung wird ArtInStack Photoshop unter Connected apps in Einstellungen → Entwickler aufgeführt

Portfolio auswählen

1. Nach Connect lädt das Bedienfeld GET /api/v1/portfolios
2. Wählen Sie das Portfolio für diese Veröffentlichung
3. Erstellen Sie Portfolios im ArtInStack-Dashboard. Das Plugin erstellt sie nicht

Veröffentlichen

1. Öffnen Sie das zu veröffentlichende Dokument (das Masterdokument)
2. Passen Sie bei Bedarf Export settings im Bedienfeld an (die Standardwerte entsprechen der Web-Größenanpassung von Lightroom / Capture One)
3. Klicken Sie auf Publish active document. Das Plugin bereitet ein JPEG vor und lädt es über POST /api/v1/media mit Idempotency-Key und portfolio_id hoch
4. Bei Erfolg erscheint das Foto im Dashboard-Portfolio; das Protokoll im Bedienfeld zeigt die media_id

Die unterstützten API-Typen (JPEG, PNG, GIF, WebP, TIFF) sind unter Medien aufgeführt. Das Bedienfeld veröffentlicht derzeit nur JPEG.

Exporteinstellungen (v0.1.1+)

Einstellung	Standard	Hinweise
Resize	On — 2048 px	Längere Seite (Alternativen: kürzere Seite, Breite, Höhe, benutzerdefinierte Pixelzahl)
Convert to sRGB	On	Farbe für Web/Portfolio
Embed profile	On	Mit sRGB-Konvertierung
Duplicate image	On	Auf einer Kopie arbeiten; das Masterdokument wird nie verändert
Convert to 8-bit	On	JPEG-Ablauf
Sharpening	Light	Light oder Screen Smart Sharpen auf einer zusammengefassten Ebene; None zum Überspringen
JPEG quality	High (~10)	UXP-Skala 1–12

Was beim Veröffentlichen geschieht (Duplicate on)

1. Photoshop dupliziert das aktive Dokument und führt die Exportschritte ausschließlich auf der Kopie aus (8-Bit, sRGB, Größenänderung, Sichtbares zusammenführen, optionaler Schärfungsstempel)
2. Das Plugin schreibt {document-basename}-copy.jpg und lädt die Datei hoch
3. Die verarbeitete Kopie bleibt geöffnet, damit Sie Ebenen prüfen, die Deckkraft der Schärfung im Ebenenbedienfeld (ArtInStack sharpen) anpassen oder lokal Save As verwenden können
4. Die Kopie wird mit 100 % Zoom oder mit Fit on Screen geöffnet, wenn die Arbeitsfläche größer als die Ansicht ist
5. Publish again, während diese Kopie weiterhin im Vordergrund ist → nur erneut hochladen (kein zweites Duplikat). Aktivieren Sie das Masterdokument, um eine neue Kopie vorzubereiten oder Exporteinstellungen zu ändern

Der Titel des Uploads verwendet den Dokumentnamen; der Multipart-Dateiname verwendet {basename}-copy.jpg (z. B. Tiger-Edit-copy.jpg). Masterdokumente, deren Name bereits copy enthält, erhalten beim Export ein zusätzliches Suffix -copy – das ist beabsichtigt.

Fehlerbehebung

Symptom	Prüfen
Connect bleibt stehen / abgelehnt	Einwilligung unter /oauth/device abschließen; Device Grant für den Photoshop-OAuth-Client aktiviert
Leere Portfolio-Liste	portfolios:read gewährt; Portfolio befindet sich im selben Arbeitsbereich wie die Einwilligung; Connect abgeschlossen
Upload 403	media:write oder portfolios:write fehlt
Dateityp abgelehnt	Aktives Dokument geöffnet lassen; Plugin-Export muss erfolgreich sein
Datei zu groß	Resize aktivieren oder JPEG-Qualität verringern; die maximale Bildgröße der Plattform gilt
Fehler wegen geänderter Exporteinstellungen	Masterdokument aktivieren und erneut veröffentlichen (die vorbereitete Kopie wurde mit anderen Einstellungen erstellt)
Doppelte Uploads bei Wiederholung	Stabiler Idempotency-Key pro vorbereitetem Dokument. Erneutes Publish aus derselben geöffneten Kopie ist sicher

Verbindung trennen

Verwenden Sie Disconnect im Bedienfeld oder Revoke access unter Connected apps im Dashboard.