Pipeline API¶

Endpunkte zur Steuerung des Pipeline-Workflows.

GET /api/pipeline/state¶

Liefert aktuellen Pipeline- und Hardware-Monitoring-Snapshot.

Response (Beispiel):

{
  "pipeline": {
    "state": "READY_TO_ENCODE",
    "activeJobId": 42,
    "progress": 0,
    "eta": null,
    "statusText": "Mediainfo bestätigt - Encode manuell starten",
    "context": {
      "jobId": 42
    },
    "jobProgress": {
      "42": {
        "state": "MEDIAINFO_CHECK",
        "progress": 68.5,
        "eta": null,
        "statusText": "MEDIAINFO_CHECK 68.50%"
      }
    },
    "queue": {
      "maxParallelJobs": 1,
      "runningCount": 1,
      "queuedCount": 2,
      "runningJobs": [],
      "queuedJobs": []
    }
  },
  "hardwareMonitoring": {
    "enabled": true,
    "intervalMs": 5000,
    "updatedAt": "2026-03-10T09:00:00.000Z",
    "sample": {
      "cpu": {},
      "memory": {},
      "gpu": {},
      "storage": {}
    },
    "error": null
  }
}

POST /api/pipeline/analyze¶

Startet Disc-Analyse und legt Job an.

Response:

{
  "result": {
    "jobId": 42,
    "detectedTitle": "INCEPTION",
    "omdbCandidates": []
  }
}

POST /api/pipeline/rescan-disc¶

Erzwingt erneute Laufwerksprüfung.

Response (Beispiel):

{
  "result": {
    "present": true,
    "changed": true,
    "emitted": "discInserted",
    "device": {
      "path": "/dev/sr0",
      "discLabel": "INCEPTION",
      "mediaProfile": "bluray"
    }
  }
}

POST /api/pipeline/rescan-drive¶

Erzwingt Rescan für ein konkretes Laufwerk.

Request:

{ "devicePath": "/dev/sr0" }

GET /api/pipeline/omdb/search?q=¶

OMDb-Titelsuche.

Response:

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

GET /api/pipeline/tmdb/series/search?q=&season=¶

TMDb-Seriensuche (für Serien-Workflow bei DVD/Blu-ray).

GET /api/pipeline/cd/drives¶

Liefert Snapshot der aktuell bekannten CD-Laufwerke.

GET /api/pipeline/cd/musicbrainz/search?q=¶

MusicBrainz-Suche für CD-Metadaten.

GET /api/pipeline/cd/musicbrainz/release/:mbId¶

Lädt Release-Details zu einer MusicBrainz-ID.

POST /api/pipeline/cd/select-metadata¶

Übernimmt CD-Metadaten für einen Job.

Request (Beispiel):

{
  "jobId": 91,
  "title": "Album",
  "artist": "Artist",
  "year": 2020,
  "mbId": "f5093c06-23e3-404f-aeaa-40f72885ee3a",
  "coverUrl": "https://...",
  "tracks": []
}

POST /api/pipeline/cd/start/:jobId¶

Startet/queued CD-Rip mit Format-/Script-/Chain-Konfiguration.

POST /api/pipeline/audiobook/upload¶

Upload von AAX-Datei (Multipart/FormData).

FormData-Felder:

file (Pflicht)
format (optional)
startImmediately (optional)

GET /api/pipeline/audiobook/pending-activation¶

Zeigt AAX-Jobs mit fehlenden Activation-Bytes.

POST /api/pipeline/audiobook/start/:jobId¶

Startet Audiobook-Job mit optionaler Konfiguration.

GET /api/pipeline/audiobook/jobs¶

Liefert Audiobook-Jobliste.

GET /api/pipeline/audiobook/output-tree¶

Read-only Baumansicht des Audiobook-Ausgabeordners.

POST /api/pipeline/select-metadata¶

Setzt Metadaten (und optional Playlist) für einen Job.

Request:

{
  "jobId": 42,
  "title": "Inception",
  "year": 2010,
  "imdbId": "tt1375666",
  "poster": "https://...",
  "fromOmdb": true,
  "selectedPlaylist": "00800"
}

Wichtige optionale Felder:

selectedHandBrakeTitleId / selectedHandBrakeTitleIds: Titel-Auswahl für Review/MediaInfo.
metadataProvider: omdb oder tmdb.
workflowKind: bei Disc-Jobs typischerweise film oder series.
discNumber: Pflicht für Serien-Disc-Zuordnung (workflowKind=series).
duplicateAction: Duplikatverhalten bei Film-Metadaten (allow_new oder multipart_movie).
existingJobId: optionaler Referenzjob für multipart_movie.
existingDiscNumber: Disc-Nummer des bestehenden Jobs für multipart_movie.

Response:

{ "job": { "id": 42, "status": "READY_TO_START" } }

Konflikt-Response (Beispiel, HTTP 409):

{
  "message": "Metadaten bereits in der Historie gefunden. Bitte Auswahl übernehmen oder Multipart movie wählen.",
  "details": [
    {
      "code": "METADATA_DUPLICATE_FOUND",
      "mediaProfile": "bluray",
      "existingJob": {
        "id": 17,
        "title": "Inception",
        "year": 2010,
        "status": "FINISHED",
        "jobKind": "bluray",
        "discNumber": 1,
        "isMultipartMovie": false
      }
    }
  ]
}

Relevante Fehlercodes (POST /api/pipeline/select-metadata):

Code	Bedeutung
`METADATA_DUPLICATE_FOUND`	Film-Metadaten existieren bereits in der Historie (Konfliktdialog im UI).
`MULTIPART_DISC_REQUIRED`	Für Multipart fehlen Disc-Nummern (`discNumber`/`existingDiscNumber`).
`MULTIPART_DISC_ALREADY_EXISTS`	Disc-Nummer im Multipart-Container bereits vergeben oder doppelt.
`MULTIPART_MEDIA_MISMATCH`	Multipart nur bei gleichem Medientyp (DVD oder Blu-ray).
`MULTIPART_SERIES_NOT_ALLOWED`	Multipart ist nur für Film-Jobs erlaubt, nicht für Serien-Workflow.
`MULTIPART_METADATA_MISMATCH`	Ausgewählter bestehender Job passt nicht zu den Film-Metadaten.
`SERIES_DISC_ALREADY_EXISTS`	Serien-Disc-Nummer innerhalb einer Staffel bereits vorhanden.

POST /api/pipeline/jobs/:jobId/raw-decision¶

Trifft Entscheidung bei vorhandenem RAW (continue oder restart je nach Dialogfluss).

Request:

{ "decision": "continue" }

POST /api/pipeline/start/:jobId¶

Startet vorbereiteten Job oder queued ihn (je nach Parallel-Limit).

Mögliche Responses:

{ "result": { "started": true, "stage": "RIPPING" } }

{ "result": { "queued": true, "started": false, "queuePosition": 2, "action": "START_PREPARED" } }

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

Bestätigt Review-Auswahl (Tracks, Pre/Post-Skripte/Ketten, User-Preset).

Request (typisch):

{
  "selectedEncodeTitleId": 1,
  "selectedTrackSelection": {
    "1": {
      "audioTrackIds": [1, 2],
      "subtitleTrackIds": [3]
    }
  },
  "selectedPreEncodeScriptIds": [1],
  "selectedPostEncodeScriptIds": [2, 7],
  "selectedPreEncodeChainIds": [3],
  "selectedPostEncodeChainIds": [4],
  "selectedUserPresetId": 5,
  "skipPipelineStateUpdate": false
}

Response:

{ "job": { "id": 42, "encode_review_confirmed": 1 } }

POST /api/pipeline/cancel¶

Bricht laufenden Job ab oder entfernt Queue-Eintrag.

Request (optional):

{ "jobId": 42 }

Mögliche Responses:

{ "result": { "cancelled": true, "queuedOnly": true, "jobId": 42 } }

{ "result": { "cancelled": true, "queuedOnly": false, "jobId": 42 } }

{ "result": { "cancelled": true, "queuedOnly": false, "pending": true, "jobId": 42 } }

POST /api/pipeline/retry/:jobId¶

Retry für ERROR/CANCELLED-Jobs (oder Queue-Einreihung).

POST /api/pipeline/reencode/:jobId¶

Startet Re-Encode aus bestehendem RAW.

POST /api/pipeline/restart-review/:jobId¶

Berechnet Review aus RAW neu.

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

Startet Encoding mit letzter bestätigter Review neu.

POST /api/pipeline/restart-cd-review/:jobId¶

Berechnet CD-Review aus vorhandenem RAW neu.

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

Lädt READY_TO_ENCODE-Job nach Neustart wieder in aktive Session.

GET /api/pipeline/output-folders/:jobId¶

Liefert bekannte Output-Ordner entlang der Job-Lineage.

POST /api/pipeline/delete-output-folders/:jobId¶

Löscht ausgewählte Output-Ordner.

Request:

{ "folderPaths": ["/mnt/movies/Inception (2010)"] }

Alle Endpunkte liefern { result: ... } bzw. { job: ... }.

Queue-Endpunkte¶

GET /api/pipeline/queue¶

Liefert Queue-Snapshot.

{
  "queue": {
    "maxParallelJobs": 1,
    "runningCount": 1,
    "queuedCount": 3,
    "runningJobs": [
      {
        "jobId": 41,
        "title": "Inception",
        "status": "ENCODING",
        "lastState": "ENCODING"
      }
    ],
    "queuedJobs": [
      {
        "entryId": 11,
        "position": 1,
        "type": "job",
        "jobId": 42,
        "action": "START_PREPARED",
        "actionLabel": "Start",
        "title": "Matrix",
        "status": "READY_TO_ENCODE",
        "lastState": "READY_TO_ENCODE",
        "hasScripts": true,
        "hasChains": false,
        "enqueuedAt": "2026-03-10T09:00:00.000Z"
      },
      {
        "entryId": 12,
        "position": 2,
        "type": "wait",
        "waitSeconds": 30,
        "title": "Warten 30s",
        "status": "QUEUED",
        "enqueuedAt": "2026-03-10T09:01:00.000Z"
      }
    ],
    "updatedAt": "2026-03-10T09:01:02.000Z"
  }
}

POST /api/pipeline/queue/reorder¶

Sortiert Queue-Einträge neu.

Request:

{
  "orderedEntryIds": [12, 11]
}

Legacy fallback wird akzeptiert:

{
  "orderedJobIds": [42, 43]
}

POST /api/pipeline/queue/entry¶

Fügt Nicht-Job-Queue-Eintrag hinzu (script, chain, wait).

Request-Beispiele:

{ "type": "script", "scriptId": 3 }

{ "type": "chain", "chainId": 2, "insertAfterEntryId": 11 }

{ "type": "wait", "waitSeconds": 45 }

Response:

{
  "result": { "entryId": 12, "type": "wait", "position": 2 },
  "queue": { "...": "..." }
}

DELETE /api/pipeline/queue/entry/:entryId¶

Entfernt Queue-Eintrag.

Response:

{ "queue": { "...": "..." } }

Pipeline-Zustände¶

State	Bedeutung
`IDLE`	Wartet auf Medium
`DISC_DETECTED`	Medium erkannt
`ANALYZING`	MakeMKV-Analyse läuft
`METADATA_SELECTION`	Metadaten-Auswahl
`WAITING_FOR_USER_DECISION`	Nutzerentscheidung erforderlich (Playlist-Auswahl oder RAW-Entscheidung)
`READY_TO_START`	Übergang vor Start
`RIPPING`	MakeMKV-Rip läuft
`MEDIAINFO_CHECK`	Titel-/Track-Auswertung
`READY_TO_ENCODE`	Review bereit
`ENCODING`	HandBrake-Encoding läuft
`CD_METADATA_SELECTION`	CD-Metadatenauswahl aktiv
`CD_READY_TO_RIP`	CD-Job ist startbereit
`CD_ANALYZING`	CD-Struktur/Tracks werden vorbereitet
`CD_RIPPING`	CD-Ripping läuft
`CD_ENCODING`	CD-Encode läuft
`FINISHED`	Abgeschlossen
`DONE`	Abgeschlossen (v. a. Audiobook/Converter/CD-Varianten)
`CANCELLED`	Abgebrochen
`ERROR`	Fehler