Post-Encode-Skripte¶

Post-Encode-Skripte ermöglichen es, nach erfolgreichem Encoding automatisch beliebige Shell-Befehle oder Programme auszuführen – z. B. zum Verschieben von Dateien, Benachrichtigen externer Dienste oder Auslösen weiterer Verarbeitungsschritte.

Funktionsweise¶

Nach einem erfolgreich abgeschlossenen Encoding-Schritt führt Ripster die konfigurierten Skripte sequenziell in der festgelegten Reihenfolge aus:

ENCODING abgeschlossen
        ↓
Skript 1 ausführen  ← Fehler? → Abbruch
        ↓
Skript 2 ausführen  ← Fehler? → Abbruch
        ↓
        ...
        ↓
FINISHED

Skript-Verwaltung¶

Skripte werden über die Einstellungen-Seite angelegt und verwaltet. Sie stehen danach in jedem Encode-Review zur Auswahl.

Skript anlegen¶

Navigiere zu Einstellungen → Skripte und klicke "Neues Skript":

Verfügbare Umgebungsvariablen¶

Jedes Skript wird mit folgenden Umgebungsvariablen aufgerufen:

Beispiel-Skript: Datei nach Jellyfin verschieben¶

#!/bin/bash
# /home/michael/scripts/move-to-jellyfin.sh

TARGET_DIR="/mnt/media/movies"
mkdir -p "$TARGET_DIR"
mv "$RIPSTER_OUTPUT_PATH" "$TARGET_DIR/"
echo "Verschoben: $RIPSTER_TITLE nach $TARGET_DIR"

Beispiel-Skript: Webhook auslösen¶

#!/bin/bash
# /home/michael/scripts/notify-webhook.sh

curl -s -X POST https://mein-webhook.example.com/ripster \
  -H "Content-Type: application/json" \
  -d "{\"title\": \"$RIPSTER_TITLE\", \"year\": \"$RIPSTER_YEAR\", \"path\": \"$RIPSTER_OUTPUT_PATH\"}"

Skript im Encode-Review auswählen¶

Im READY_TO_ENCODE-Zustand zeigt das MediaInfoReviewPanel einen Skript-Abschnitt:

┌──────────────────────────────────────────────────────────┐
│ Post-Encode-Skripte                                      │
├──────────────────────────────────────────────────────────┤
│ Ausgewählte Skripte (Reihenfolge per Drag & Drop):       │
│  ≡  1. Zu Plex verschieben                    [Entfernen]│
│  ≡  2. Webhook auslösen                       [Entfernen]│
├──────────────────────────────────────────────────────────┤
│ Skript hinzufügen: [Zu Jellyfin verschieben ▾] [+ Hinzuf.]│
└──────────────────────────────────────────────────────────┘

• Reihenfolge per Drag & Drop ändern
• Hinzufügen aus der Dropdown-Liste aller konfigurierten Skripte
• Entfernen einzelner Skripte aus der aktuellen Auswahl
• Skripte können pro Job unterschiedlich gewählt werden

Skript testen¶

Über die Einstellungen kann jedes Skript mit einem Test-Job ausgeführt werden:

POST /api/settings/scripts/:scriptId/test

Der Test-Aufruf befüllt die Umgebungsvariablen mit Platzhalter-Werten.

Ausführungs-Ergebnis¶

Das Ergebnis der Skript-Ausführung wird im Job-Datensatz gespeichert und in der History angezeigt:

{
  "postEncodeScripts": {
    "configured": 2,
    "succeeded": 2,
    "failed": 0,
    "skipped": 0,
    "aborted": false,
    "results": [
      {
        "scriptId": "script-1",
        "name": "Zu Plex verschieben",
        "exitCode": 0,
        "stdout": "Verschoben: Inception nach /mnt/media/movies",
        "stderr": "",
        "durationMs": 342
      },
      {
        "scriptId": "script-2",
        "name": "Webhook auslösen",
        "exitCode": 0,
        "stdout": "",
        "stderr": "",
        "durationMs": 128
      }
    ]
  }
}

API-Referenz¶

Eine vollständige API-Dokumentation der Skript-Endpunkte findest du unter:

Settings API – Skripte