535 lines
10 KiB
Markdown
535 lines
10 KiB
Markdown
# Pipeline API
|
|
|
|
Endpunkte zur Steuerung des Pipeline-Workflows.
|
|
|
|
---
|
|
|
|
## GET /api/pipeline/state
|
|
|
|
Liefert aktuellen Pipeline- und Hardware-Monitoring-Snapshot.
|
|
|
|
**Response (Beispiel):**
|
|
|
|
```json
|
|
{
|
|
"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:**
|
|
|
|
```json
|
|
{
|
|
"result": {
|
|
"jobId": 42,
|
|
"detectedTitle": "INCEPTION",
|
|
"omdbCandidates": []
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## POST /api/pipeline/rescan-disc
|
|
|
|
Erzwingt erneute Laufwerksprüfung.
|
|
|
|
**Response (Beispiel):**
|
|
|
|
```json
|
|
{
|
|
"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:**
|
|
|
|
```json
|
|
{ "devicePath": "/dev/sr0" }
|
|
```
|
|
|
|
---
|
|
|
|
## GET /api/pipeline/tmdb/movie/search?q=<query>
|
|
|
|
TMDb-Filmsuche.
|
|
|
|
**Response:**
|
|
|
|
```json
|
|
{
|
|
"results": [
|
|
{
|
|
"imdbId": "tt1375666",
|
|
"title": "Inception",
|
|
"year": "2010",
|
|
"type": "movie",
|
|
"poster": "https://..."
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## GET /api/pipeline/tmdb/series/search?q=<query>&season=<n>
|
|
|
|
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=<query>
|
|
|
|
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):**
|
|
|
|
```json
|
|
{
|
|
"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:**
|
|
|
|
```json
|
|
{
|
|
"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:**
|
|
|
|
```json
|
|
{ "job": { "id": 42, "status": "READY_TO_START" } }
|
|
```
|
|
|
|
**Konflikt-Response (Beispiel, HTTP 409):**
|
|
|
|
```json
|
|
{
|
|
"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:**
|
|
|
|
```json
|
|
{ "decision": "continue" }
|
|
```
|
|
|
|
---
|
|
|
|
## POST /api/pipeline/start/:jobId
|
|
|
|
Startet vorbereiteten Job oder queued ihn (je nach Parallel-Limit).
|
|
|
|
**Mögliche Responses:**
|
|
|
|
```json
|
|
{ "result": { "started": true, "stage": "RIPPING" } }
|
|
```
|
|
|
|
```json
|
|
{ "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):**
|
|
|
|
```json
|
|
{
|
|
"selectedEncodeTitleId": 1,
|
|
"selectedTrackSelection": {
|
|
"1": {
|
|
"audioTrackIds": [1, 2],
|
|
"subtitleTrackIds": [3]
|
|
}
|
|
},
|
|
"selectedPreEncodeScriptIds": [1],
|
|
"selectedPostEncodeScriptIds": [2, 7],
|
|
"selectedPreEncodeChainIds": [3],
|
|
"selectedPostEncodeChainIds": [4],
|
|
"selectedUserPresetId": 5,
|
|
"skipPipelineStateUpdate": false
|
|
}
|
|
```
|
|
|
|
**Response:**
|
|
|
|
```json
|
|
{ "job": { "id": 42, "encode_review_confirmed": 1 } }
|
|
```
|
|
|
|
---
|
|
|
|
## POST /api/pipeline/cancel
|
|
|
|
Bricht laufenden Job ab oder entfernt Queue-Eintrag.
|
|
|
|
**Request (optional):**
|
|
|
|
```json
|
|
{ "jobId": 42 }
|
|
```
|
|
|
|
**Mögliche Responses:**
|
|
|
|
```json
|
|
{ "result": { "cancelled": true, "queuedOnly": true, "jobId": 42 } }
|
|
```
|
|
|
|
```json
|
|
{ "result": { "cancelled": true, "queuedOnly": false, "jobId": 42 } }
|
|
```
|
|
|
|
```json
|
|
{ "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:**
|
|
|
|
```json
|
|
{ "folderPaths": ["/mnt/movies/Inception (2010)"] }
|
|
```
|
|
|
|
Alle Endpunkte liefern `{ result: ... }` bzw. `{ job: ... }`.
|
|
|
|
---
|
|
|
|
## Queue-Endpunkte
|
|
|
|
### GET /api/pipeline/queue
|
|
|
|
Liefert Queue-Snapshot.
|
|
|
|
```json
|
|
{
|
|
"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:**
|
|
|
|
```json
|
|
{
|
|
"orderedEntryIds": [12, 11]
|
|
}
|
|
```
|
|
|
|
Legacy fallback wird akzeptiert:
|
|
|
|
```json
|
|
{
|
|
"orderedJobIds": [42, 43]
|
|
}
|
|
```
|
|
|
|
### POST /api/pipeline/queue/entry
|
|
|
|
Fügt Nicht-Job-Queue-Eintrag hinzu (`script`, `chain`, `wait`).
|
|
|
|
**Request-Beispiele:**
|
|
|
|
```json
|
|
{ "type": "script", "scriptId": 3 }
|
|
```
|
|
|
|
```json
|
|
{ "type": "chain", "chainId": 2, "insertAfterEntryId": 11 }
|
|
```
|
|
|
|
```json
|
|
{ "type": "wait", "waitSeconds": 45 }
|
|
```
|
|
|
|
**Response:**
|
|
|
|
```json
|
|
{
|
|
"result": { "entryId": 12, "type": "wait", "position": 2 },
|
|
"queue": { "...": "..." }
|
|
}
|
|
```
|
|
|
|
### DELETE /api/pipeline/queue/entry/:entryId
|
|
|
|
Entfernt Queue-Eintrag.
|
|
|
|
**Response:**
|
|
|
|
```json
|
|
{ "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 |
|