Pipeline API¶

Alle Endpunkte zur Steuerung des Ripping-Workflows.

GET /api/pipeline/state¶

Gibt den aktuellen Pipeline-Zustand zurück.

Response:

{
  "state": "ENCODING",
  "jobId": 42,
  "job": {
    "id": 42,
    "title": "Inception",
    "status": "ENCODING",
    "imdb_id": "tt1375666",
    "omdb_year": "2010"
  },
  "progress": 73.5,
  "eta": "00:12:34",
  "updatedAt": "2024-01-15T14:30:00.000Z"
}

Pipeline-Zustände:

Wert	Beschreibung
`IDLE`	Wartet auf Disc
`DISC_DETECTED`	Disc erkannt, wartet auf Benutzer
`METADATA_SELECTION`	Disc-Scan läuft / Metadaten-Dialog
`WAITING_FOR_USER_DECISION`	Mehrere Playlist-Kandidaten – manuelle Auswahl
`READY_TO_START`	Bereit zum Starten
`RIPPING`	MakeMKV-Ripping läuft
`MEDIAINFO_CHECK`	HandBrake-Scan & Encode-Plan-Erstellung
`READY_TO_ENCODE`	Wartet auf Encode-Bestätigung
`ENCODING`	HandBrake encodiert
`POST_ENCODE_SCRIPTS`	Post-Encode-Skripte laufen
`FINISHED`	Abgeschlossen
`ERROR`	Fehler

Kontext-Felder (state-abhängig):

Beim Zustand WAITING_FOR_USER_DECISION enthält die Response zusätzlich:

{
  "state": "WAITING_FOR_USER_DECISION",
  "context": {
    "playlistAnalysis": {
      "evaluatedCandidates": [...],
      "recommendation": { "playlistId": "00800", "score": 18 },
      "manualDecisionRequired": true,
      "manualDecisionReason": "multiple_candidates_after_min_length"
    },
    "playlistCandidates": ["00800", "00801", "00900"]
  }
}

POST /api/pipeline/analyze¶

Startet eine manuelle Disc-Analyse.

Request: Kein Body

Response:

{ "ok": true, "message": "Analyse gestartet" }

Fehlerfälle: - 409 – Pipeline bereits aktiv

POST /api/pipeline/rescan-disc¶

Erzwingt eine erneute Disc-Erkennung.

Response: { "ok": true }

GET /api/pipeline/omdb/search¶

Sucht in der OMDb-API nach einem Filmtitel.

Query-Parameter:

Parameter	Typ	Beschreibung
`q`	string	Suchbegriff
`type`	string	`movie` oder `series` (optional)

Beispiel: GET /api/pipeline/omdb/search?q=Inception&type=movie

Response:

{
  "results": [
    { "imdbId": "tt1375666", "title": "Inception", "year": "2010", "type": "movie", "poster": "https://..." }
  ]
}

POST /api/pipeline/select-metadata¶

Bestätigt Metadaten und optionale Playlist-Auswahl.

Request:

{
  "jobId": 42,
  "omdb": {
    "imdbId": "tt1375666",
    "title": "Inception",
    "year": "2010",
    "type": "movie",
    "poster": "https://..."
  },
  "selectedPlaylist": "00800"
}

Playlist-Felder

selectedPlaylist ist optional. Wird es beim ersten Aufruf weggelassen (kein Obfuskierungsverdacht), wird die Empfehlung automatisch übernommen.

Beim zweiten Aufruf aus dem WAITING_FOR_USER_DECISION-Dialog reicht es, nur jobId + selectedPlaylist zu schicken – omdb kann dann weggelassen werden.

Response: { "ok": true }

POST /api/pipeline/start/:jobId¶

Startet den Ripping-Prozess.

URL-Parameter: jobId

Response: { "ok": true, "message": "Ripping gestartet" }

Sonderfall: Falls für den Job bereits eine Raw-Datei vorhanden ist, wird das Ripping übersprungen und direkt der HandBrake-Scan gestartet.

Fehlerfälle: - 404 – Job nicht gefunden - 409 – Job nicht im Status READY_TO_START

POST /api/pipeline/confirm-encode/:jobId¶

Bestätigt die Encode-Konfiguration mit Track-Auswahl und Post-Encode-Skripten.

URL-Parameter: jobId

Request:

{
  "selectedEncodeTitleId": 1,
  "selectedTrackSelection": {
    "1": {
      "audioTrackIds": [1, 2],
      "subtitleTrackIds": [1]
    }
  },
  "selectedPostEncodeScriptIds": ["script-abc123", "script-def456"]
}

Feld	Typ	Beschreibung
`selectedEncodeTitleId`	number	HandBrake-Titel-ID (aus dem Encode-Plan)
`selectedTrackSelection`	object	Pro Titel: Audio- und Untertitel-Track-IDs
`selectedPostEncodeScriptIds`	string[]	Skript-IDs in Ausführungsreihenfolge (optional)

Track-IDs

Die Track-IDs entsprechen den id-Feldern aus dem Encode-Plan (encode_plan_json), nicht den rohen HandBrake-Track-Nummern.

Response: { "ok": true, "message": "Encoding gestartet" }

POST /api/pipeline/cancel¶

Bricht den aktiven Pipeline-Prozess ab.

Response: { "ok": true, "message": "Pipeline abgebrochen" }

SIGINT → graceful exit (10 s Timeout) → SIGKILL.

POST /api/pipeline/retry/:jobId¶

Wiederholt einen fehlgeschlagenen Job.

Response: { "ok": true, "message": "Job wird wiederholt" }

Fehlerfälle: - 404 – Job nicht gefunden - 409 – Job nicht im Status ERROR

POST /api/pipeline/resume-ready/:jobId¶

Reaktiviert einen Job im Status READY_TO_ENCODE in die aktive Pipeline (z. B. nach Neustart).

Response: { "ok": true }

POST /api/pipeline/reencode/:jobId¶

Encodiert eine abgeschlossene Raw-MKV erneut – ohne Ripping.

Request:

{
  "selectedEncodeTitleId": 1,
  "selectedTrackSelection": {
    "1": { "audioTrackIds": [1, 2], "subtitleTrackIds": [1] }
  },
  "selectedPostEncodeScriptIds": ["script-abc123"]
}

Gleiche Struktur wie confirm-encode – ermöglicht andere Track-Auswahl und Skripte als beim ersten Encoding.

Response: { "ok": true, "message": "Re-Encoding gestartet" }