This commit is contained in:
michael committed 2026-03-05 19:34:01 +00:00
1 parent c3d1df42b0
commit 6836892907
22 files changed
+1869 -302

No files matched your search

+20 -22
View File
@@ -1,38 +1,36 @@
<!doctype html><html lang=de class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Halbautomatische Disc-Ripping-Plattform für DVDs & Blu-rays mit HandBrake-Encoding"><meta name=author content=Michael><link href=https://mboehmlaender.github.io/ripster/getting-started/quickstart/ rel=canonical><link href=../configuration/ rel=prev><link href=../../architecture/ rel=next><link rel=icon href=../../assets/images/favicon.png><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.7.0"><title>Schnellstart - Ripster</title><link rel=stylesheet href=../../assets/stylesheets/main.618322db.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.ab4e12ef.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../stylesheets/extra.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script></head> <body dir=ltr data-md-color-scheme=default data-md-color-primary=deep-purple data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#schnellstart-vollstandiger-workflow class=md-skip> Zum Inhalt </a> </div> <div data-md-component=announce> </div> <div data-md-color-scheme=default data-md-component=outdated hidden> </div> <header class="md-header md-header--shadow md-header--lifted" data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Kopfzeile> <a href=../.. title=Ripster class="md-header__button md-logo" aria-label=Ripster data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 14a2 2 0 0 1-2-2c0-1.11.89-2 2-2s2 .89 2 2a2 2 0 0 1-2 2m0-10a8 8 0 0 0-8 8 8 8 0 0 0 8 8 8 8 0 0 0 8-8 8 8 0 0 0-8-8"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Ripster </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Schnellstart </span> </div> </div> </div> <form class=md-header__option data-md-component=palette> <input class=md-option data-md-color-media data-md-color-scheme=default data-md-color-primary=deep-purple data-md-color-accent=purple aria-label="Dunkelmodus aktivieren" type=radio name=__palette id=__palette_0> <label class="md-header__button md-icon" title="Dunkelmodus aktivieren" for=__palette_1 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> <input class=md-option data-md-color-media data-md-color-scheme=slate data-md-color-primary=deep-purple data-md-color-accent=purple aria-label="Hellmodus aktivieren" type=radio name=__palette id=__palette_1> <label class="md-header__button md-icon" title="Hellmodus aktivieren" for=__palette_0 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> </form> <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24Line truncated
<!doctype html><html lang=de class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Halbautomatische Disc-Ripping-Plattform für DVDs & Blu-rays mit HandBrake-Encoding"><meta name=author content=Michael><link href=https://mboehmlaender.github.io/ripster/getting-started/quickstart/ rel=canonical><link href=../configuration/ rel=prev><link href=../../architecture/ rel=next><link rel=icon href=../../assets/images/favicon.png><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.7.0"><title>Schnellstart - Ripster</title><link rel=stylesheet href=../../assets/stylesheets/main.618322db.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.ab4e12ef.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../stylesheets/extra.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script></head> <body dir=ltr data-md-color-scheme=default data-md-color-primary=deep-purple data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#schnellstart-vollstandiger-workflow class=md-skip> Zum Inhalt </a> </div> <div data-md-component=announce> </div> <div data-md-color-scheme=default data-md-component=outdated hidden> </div> <header class="md-header md-header--shadow md-header--lifted" data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Kopfzeile> <a href=../.. title=Ripster class="md-header__button md-logo" aria-label=Ripster data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 14a2 2 0 0 1-2-2c0-1.11.89-2 2-2s2 .89 2 2a2 2 0 0 1-2 2m0-10a8 8 0 0 0-8 8 8 8 0 0 0 8 8 8 8 0 0 0 8-8 8 8 0 0 0-8-8"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Ripster </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Schnellstart </span> </div> </div> </div> <form class=md-header__option data-md-component=palette> <input class=md-option data-md-color-media data-md-color-scheme=default data-md-color-primary=deep-purple data-md-color-accent=purple aria-label="Dunkelmodus aktivieren" type=radio name=__palette id=__palette_0> <label class="md-header__button md-icon" title="Dunkelmodus aktivieren" for=__palette_1 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> <input class=md-option data-md-color-media data-md-color-scheme=slate data-md-color-primary=deep-purple data-md-color-accent=purple aria-label="Hellmodus aktivieren" type=radio name=__palette id=__palette_1> <label class="md-header__button md-icon" title="Hellmodus aktivieren" for=__palette_0 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> </form> <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24Line truncated
START(( )) --&gt; IDLE
IDLE --&gt;|Disc erkannt| DD[DISC_DETECTED]
DD --&gt;|Analyse starten| META[METADATA\nSELECTION]
META --&gt;|1 Kandidat| RTS[READY_TO\nSTART]
META --&gt;|mehrere Kandidaten| WUD[WAITING_FOR\nUSER_DECISION]
WUD --&gt;|Playlist bestätigt| RTS
META --&gt;|Metadaten übernommen| RTS[READY_TO\nSTART]
META --&gt;|vorhandenes RAW +\nPlaylist offen| WUD[WAITING_FOR\nUSER_DECISION]
RTS --&gt;|Auto-Start| RIP[RIPPING]
RTS --&gt;|Auto-Start mit RAW| MIC[MEDIAINFO\nCHECK]
RTS --&gt;|Raw vorhanden| MIC[MEDIAINFO\nCHECK]
RTS --&gt;|Ripping starten| RIP[RIPPING]
RIP --&gt;|MKV fertig| MIC
RIP --&gt;|Fehler| ERR
MIC --&gt;|Playlist offen (Backup)| WUD
WUD --&gt;|Playlist bestätigt| MIC
WUD --&gt;|Playlist bestätigt,\nnoch kein RAW| RTS
MIC --&gt; RTE[READY_TO\nENCODE]
RTE --&gt;|bestätigt| ENC[ENCODING]
RTE --&gt;|Encoding starten| ENC[ENCODING]
ENC --&gt;|mit Skripten| PES[POST_ENCODE\nSCRIPTS]
ENC --&gt;|ohne Skripte| FIN([FINISHED])
ENC --&gt;|inkl. Post-Skripte| FIN([FINISHED])
ENC --&gt;|Fehler| ERR
PES --&gt;|Erfolg| FIN
PES --&gt;|Fehler| ERR
ERR([ERROR]) --&gt;|Retry / Cancel| IDLE
style FIN fill:#e8f5e9,stroke:#66bb6a,color:#2e7d32
style ERR fill:#ffebee,stroke:#ef5350,color:#c62828
style WUD fill:#fff8e1,stroke:#ffa726,color:#e65100
style PES fill:#f3e5f5,stroke:#ab47bc,color:#6a1b9a
style ENC fill:#f3e5f5,stroke:#ab47bc,color:#6a1b9a</code></pre> </div> </details> <hr> <h2 id=schritt-1-ripster-starten>Schritt 1 – Ripster starten<a class=headerlink href=#schritt-1-ripster-starten title="Permanent link">&para;</a></h2> <div class="language-bash highlight"><pre><span></span><code><span id=__span-0-1><a id=__codelineno-0-1 name=__codelineno-0-1 href=#__codelineno-0-1></a><span class=nb>cd</span><span class=w> </span>ripster
</span><span id=__span-0-2><a id=__codelineno-0-2 name=__codelineno-0-2 href=#__codelineno-0-2></a>./start.sh
</span></code></pre></div> <p>Öffne <a href=http://localhost:5173>http://localhost:5173</a> im Browser. Das Dashboard zeigt <code>IDLE</code>.</p> <hr> <h2 id=schritt-2-disc-einlegen-disc_detected>Schritt 2 – Disc einlegen → <code>DISC_DETECTED</code><a class=headerlink href=#schritt-2-disc-einlegen-disc_detected title="Permanent link">&para;</a></h2> <p>Lege eine DVD oder Blu-ray ein. Der <code>diskDetectionService</code> pollt das Laufwerk alle <code>disc_poll_interval_ms</code> Millisekunden (Standard: 5 Sekunden).</p> <p><strong>Was passiert im Code:</strong></p> <ul> <li><code>diskDetectionService</code> emittiert <code>disc:inserted</code> mit Geräteinformationen</li> <li><code>pipelineService.onDiscInserted()</code> wird aufgerufen</li> <li>Dashboard zeigt Badge <strong>"Neue Disc erkannt"</strong></li> <li>Der <strong>"Analyse starten"</strong>-Button wird aktiv</li> </ul> <div class="admonition tip"> <p class=admonition-title>Manuelle Auslösung</p> <p>Falls die automatische Erkennung nicht greift: <div class="language-bash highlight"><pre><span></span><code><span id=__span-1-1><a id=__codelineno-1-1 name=__codelineno-1-1 href=#__codelineno-1-1></a>curl<span class=w> </span>-X<span class=w> </span>POST<span class=w> </span>http://localhost:3001/api/pipeline/analyze
</span></code></pre></div></p> </div> <hr> <h2 id=schritt-3-analyse-starten-metadata_selection>Schritt 3 – Analyse starten → <code>METADATA_SELECTION</code><a class=headerlink href=#schritt-3-analyse-starten-metadata_selection title="Permanent link">&para;</a></h2> <p>Klicke auf <strong>"Analyse starten"</strong> oder warte auf automatischen Start.</p> <p><strong>Was passiert im Code:</strong></p> <ol> <li>Ein neuer Job-Datensatz wird in der Datenbank angelegt (<code>status: METADATA_SELECTION</code>)</li> <li>Ripster versucht, den Titel automatisch aus dem Disc-Label/Modell zu ermitteln</li> <li>Mit diesem erkannten Titel wird sofort eine <strong>OMDb-Suche</strong> ausgelöst</li> <li>Der <code>MetadataSelectionDialog</code> öffnet sich im Frontend mit den vorgeladenen Suchergebnissen</li> </ol> <p><strong>Erkannter Titel:</strong> Der Disc-Label (z. B. <code>INCEPTION</code>) wird als Suchbegriff verwendet. Falls kein Label vorhanden, bleibt das Suchfeld leer.</p> <hr> <h2 id=schritt-4-metadaten-auswahlen-metadataselectiondialog>Schritt 4 – Metadaten auswählen (<code>MetadataSelectionDialog</code>)<a class=headerlink href=#schritt-4-metadaten-auswahlen-metadataselectiondialog title="Permanent link">&para;</a></h2> <p>Der Dialog zeigt vorgeladene OMDb-Suchergebnisse. Du kannst:</p> <h3 id=4a-omdb-suchergebnis-wahlen>4a) OMDb-Suchergebnis wählen<a class=headerlink href=#4a-omdb-suchergebnis-wahlen title="Permanent link">&para;</a></h3> <div class="language-text highlight"><pre><span></span><code><span id=__span-2-1><a id=__codelineno-2-1 name=__codelineno-2-1 href=#__codelineno-2-1></a>┌─────────────────────────────────────────────────┐
</span></code></pre></div> <p>Öffne <a href=http://localhost:5173>http://localhost:5173</a> im Browser. Das Dashboard zeigt <code>IDLE</code>.</p> <hr> <h2 id=schritt-2-disc-einlegen-disc_detected>Schritt 2 – Disc einlegen → <code>DISC_DETECTED</code><a class=headerlink href=#schritt-2-disc-einlegen-disc_detected title="Permanent link">&para;</a></h2> <p>Lege eine DVD oder Blu-ray ein. Der <code>diskDetectionService</code> pollt das Laufwerk alle <code>disc_poll_interval_ms</code> Millisekunden (Standard: 4 Sekunden).</p> <p><strong>Was passiert im Code:</strong></p> <ul> <li><code>diskDetectionService</code> emittiert <code>discInserted</code> mit Geräteinformationen</li> <li><code>pipelineService.onDiscInserted()</code> wird aufgerufen</li> <li>Dashboard-Status-Badge zeigt <strong>"Medium erkannt"</strong></li> <li>Status-Text zeigt <strong>"Neue Disk erkannt"</strong></li> <li>Der <strong>"Analyse starten"</strong>-Button wird aktiv</li> </ul> <div class="admonition tip"> <p class=admonition-title>Manuelle Auslösung</p> <p>Falls die automatische Erkennung nicht greift: <div class="language-bash highlight"><pre><span></span><code><span id=__span-1-1><a id=__codelineno-1-1 name=__codelineno-1-1 href=#__codelineno-1-1></a>curl<span class=w> </span>-X<span class=w> </span>POST<span class=w> </span>http://localhost:3001/api/pipeline/analyze
</span></code></pre></div></p> </div> <hr> <h2 id=schritt-3-analyse-starten-metadata_selection>Schritt 3 – Analyse starten → <code>METADATA_SELECTION</code><a class=headerlink href=#schritt-3-analyse-starten-metadata_selection title="Permanent link">&para;</a></h2> <p>Klicke auf <strong>"Analyse starten"</strong>.</p> <p><strong>Was passiert im Code:</strong></p> <ol> <li>Ein neuer Job-Datensatz wird in der Datenbank angelegt (<code>status: METADATA_SELECTION</code>)</li> <li>Ripster versucht, den Titel automatisch aus dem Disc-Label/Modell zu ermitteln</li> <li>Mit diesem erkannten Titel wird sofort eine <strong>OMDb-Suche</strong> ausgelöst</li> <li>Der <code>MetadataSelectionDialog</code> öffnet sich im Frontend mit den vorgeladenen Suchergebnissen</li> </ol> <p><strong>Erkannter Titel:</strong> Der Disc-Label (z. B. <code>INCEPTION</code>) wird als Suchbegriff verwendet. Falls kein Label vorhanden, bleibt das Suchfeld leer.</p> <hr> <h2 id=schritt-4-metadaten-auswahlen-metadataselectiondialog>Schritt 4 – Metadaten auswählen (<code>MetadataSelectionDialog</code>)<a class=headerlink href=#schritt-4-metadaten-auswahlen-metadataselectiondialog title="Permanent link">&para;</a></h2> <p>Der Dialog zeigt vorgeladene OMDb-Suchergebnisse. Du kannst:</p> <h3 id=4a-omdb-suchergebnis-wahlen>4a) OMDb-Suchergebnis wählen<a class=headerlink href=#4a-omdb-suchergebnis-wahlen title="Permanent link">&para;</a></h3> <div class="language-text highlight"><pre><span></span><code><span id=__span-2-1><a id=__codelineno-2-1 name=__codelineno-2-1 href=#__codelineno-2-1></a>┌─────────────────────────────────────────────────┐
</span><span id=__span-2-2><a id=__codelineno-2-2 name=__codelineno-2-2 href=#__codelineno-2-2></a>│ Suche: [Inception ] 🔍 │
</span><span id=__span-2-3><a id=__codelineno-2-3 name=__codelineno-2-3 href=#__codelineno-2-3></a>├─────────────────────────────────────────────────┤
</span><span id=__span-2-4><a id=__codelineno-2-4 name=__codelineno-2-4 href=#__codelineno-2-4></a>│ ▶ Inception (2010) · Movie · tt1375666 │
@@ -40,7 +38,7 @@
</span><span id=__span-2-6><a id=__codelineno-2-6 name=__codelineno-2-6 href=#__codelineno-2-6></a>├─────────────────────────────────────────────────┤
</span><span id=__span-2-7><a id=__codelineno-2-7 name=__codelineno-2-7 href=#__codelineno-2-7></a>│ [Auswahl übernehmen] │
</span><span id=__span-2-8><a id=__codelineno-2-8 name=__codelineno-2-8 href=#__codelineno-2-8></a>└─────────────────────────────────────────────────┘
</span></code></pre></div> <ul> <li>Suche durch Titel anpassen und Enter drücken</li> <li>Typ-Filter: <code>movie</code> / <code>series</code> umschalten möglich</li> <li>Einen Eintrag anklicken, dann <strong>"Auswahl übernehmen"</strong></li> </ul> <h3 id=4b-manuelle-eingabe-ohne-omdb>4b) Manuelle Eingabe (ohne OMDb)<a class=headerlink href=#4b-manuelle-eingabe-ohne-omdb title="Permanent link">&para;</a></h3> <p>Falls kein passendes Ergebnis gefunden wird: - Titel, Jahr und IMDb-ID manuell eingeben - OMDb-Poster wird übersprungen</p> <p><strong>Was passiert nach Bestätigung:</strong></p> <p>Ripster ruft <code>pipelineService.selectMetadata()</code> auf und führt sofort eine <strong>Playlist-Analyse</strong> durch:</p> <ul> <li>MakeMKV wird im Info-Modus gestartet</li> <li>Alle Titel und deren Segment-Reihenfolgen werden analysiert</li> <li>Das Ergebnis entscheidet über den nächsten Zustand (→ Schritt 5)</li> </ul> <hr> <h2 id=schritt-5-playlist-situation-zwei-wege>Schritt 5 – Playlist-Situation (zwei Wege)<a class=headerlink href=#schritt-5-playlist-situation-zwei-wege title="Permanent link">&para;</a></h2> <h3 id=5a-keine-obfuskierung-ready_to_start>5a) Keine Obfuskierung → <code>READY_TO_START</code><a class=headerlink href=#5a-keine-obfuskierung-ready_to_start title="Permanent link">&para;</a></h3> <p>Der Dialog schließt sich automatisch. Die empfohlene Playlist wird still übernommen. Weiter zu <strong>Schritt 6</strong>.</p> <h3 id=5b-obfuskierung-erkannt-waiting_for_user_decision>5b) Obfuskierung erkannt → <code>WAITING_FOR_USER_DECISION</code><a class=headerlink href=#5b-obfuskierung-erkannt-waiting_for_user_decision title="Permanent link">&para;</a></h3> <p>Der <strong>Playlist-Auswahl-Dialog</strong> erscheint <strong>zusätzlich</strong> (nach dem Metadaten-Dialog):</p> <div class="language-text highlight"><pre><span></span><code><span id=__span-3-1><a id=__codelineno-3-1 name=__codelineno-3-1 href=#__codelineno-3-1></a>┌───────────────────────────────────────────────────────────────┐
</span></code></pre></div> <ul> <li>Suche durch Titel anpassen und Enter drücken</li> <li>Typ-Filter: <code>movie</code> / <code>series</code> umschalten möglich</li> <li>Einen Eintrag anklicken, dann <strong>"Auswahl übernehmen"</strong></li> </ul> <h3 id=4b-manuelle-eingabe-ohne-omdb>4b) Manuelle Eingabe (ohne OMDb)<a class=headerlink href=#4b-manuelle-eingabe-ohne-omdb title="Permanent link">&para;</a></h3> <p>Falls kein passendes Ergebnis gefunden wird: - Titel, Jahr und IMDb-ID manuell eingeben - OMDb-Poster wird übersprungen</p> <p><strong>Was passiert nach Bestätigung:</strong></p> <p>Ripster ruft <code>pipelineService.selectMetadata()</code> auf und startet den nächsten Schritt automatisch:</p> <ul> <li>Job wird auf <code>READY_TO_START</code> gesetzt (kurzer Übergangszustand)</li> <li>Falls bereits RAW vorhanden: direkter Sprung zu <code>MEDIAINFO_CHECK</code></li> <li>Falls kein RAW vorhanden: automatischer Start von <code>RIPPING</code></li> <li>Wenn bereits andere Jobs laufen, landet der Start stattdessen in der Queue</li> </ul> <hr> <h2 id=schritt-5-optional-playlist-auswahl-waiting_for_user_decision>Schritt 5 – Optional: Playlist-Auswahl → <code>WAITING_FOR_USER_DECISION</code><a class=headerlink href=#schritt-5-optional-playlist-auswahl-waiting_for_user_decision title="Permanent link">&para;</a></h2> <p>Dieser Zustand erscheint nur bei mehrdeutigen Blu-ray-Playlists (typisch nach RAW-Analyse im Backup-Modus).</p> <p>Der <strong>Playlist-Auswahl-Dialog</strong> erscheint <strong>zusätzlich</strong> (nach dem Metadaten-Dialog):</p> <div class="language-text highlight"><pre><span></span><code><span id=__span-3-1><a id=__codelineno-3-1 name=__codelineno-3-1 href=#__codelineno-3-1></a>┌───────────────────────────────────────────────────────────────┐
</span><span id=__span-3-2><a id=__codelineno-3-2 name=__codelineno-3-2 href=#__codelineno-3-2></a>│ Playlist-Auswahl │
</span><span id=__span-3-3><a id=__codelineno-3-3 name=__codelineno-3-3 href=#__codelineno-3-3></a>│ Es wurden mehrere Titel mit ähnlicher Laufzeit gefunden. │
</span><span id=__span-3-4><a id=__codelineno-3-4 name=__codelineno-3-4 href=#__codelineno-3-4></a>│ Bitte wähle die korrekte Playlist: │
@@ -57,14 +55,14 @@
</span><span id=__span-3-15><a id=__codelineno-3-15 name=__codelineno-3-15 href=#__codelineno-3-15></a>└───────────┴──────────┴────────┴──────────────────────────────┘
</span><span id=__span-3-16><a id=__codelineno-3-16 name=__codelineno-3-16 href=#__codelineno-3-16></a> 847 Playlists insgesamt · 3 relevante Kandidaten (≥ 15 min)
</span><span id=__span-3-17><a id=__codelineno-3-17 name=__codelineno-3-17 href=#__codelineno-3-17></a> Empfehlung: 00800 (vorausgewählt)
</span><span id=__span-3-18><a id=__codelineno-3-18 name=__codelineno-3-18 href=#__codelineno-3-18></a> [Playlist bestätigen]
</span></code></pre></div> <ul> <li>Die empfohlene Playlist ist <strong>vorausgewählt</strong> (Radio-Button)</li> <li>Score und Bewertungslabel helfen bei der Entscheidung</li> <li>Nach Bestätigung: Pipeline wechselt zu <code>READY_TO_START</code></li> </ul> <div class="admonition info"> <p class=admonition-title>Scoring-Details</p> <p>Wie die Scores berechnet werden, erklärt die <a href=../../pipeline/playlist-analysis/ >Playlist-Analyse</a>-Seite.</p> </div> <hr> <h2 id=schritt-6-ripping-starten-ripping>Schritt 6 – Ripping starten → <code>RIPPING</code><a class=headerlink href=#schritt-6-ripping-starten-ripping title="Permanent link">&para;</a></h2> <p><strong>Vorher prüft Ripster:</strong> Existiert bereits eine Raw-Datei für diesen Job?</p> <ul> <li><strong>Ja, Raw-Datei vorhanden</strong> → Direkt zu Schritt 7 (Track-Review), kein erneutes Ripping</li> <li><strong>Nein</strong> → MakeMKV-Ripping startet</li> </ul> <p>Klicke auf <strong>"Starten"</strong> im Dashboard.</p> <p><strong>Was MakeMKV ausführt (MKV-Modus):</strong></p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-4-1><a id=__codelineno-4-1 name=__codelineno-4-1 href=#__codelineno-4-1></a>makemkvcon<span class=w> </span>mkv<span class=w> </span>disc:0<span class=w> </span>all<span class=w> </span>/mnt/raw/Inception-2010/<span class=w> </span><span class=se>\</span>
</span><span id=__span-3-18><a id=__codelineno-3-18 name=__codelineno-3-18 href=#__codelineno-3-18></a> [Playlist übernehmen]
</span></code></pre></div> <ul> <li>Die empfohlene Playlist ist <strong>vorausgewählt</strong> (Checkbox)</li> <li>Score und Bewertungslabel helfen bei der Entscheidung</li> <li>Nach <strong>"Playlist übernehmen"</strong> setzt Ripster automatisch fort:</li> <li>mit vorhandenem RAW in <code>MEDIAINFO_CHECK</code></li> <li>ohne RAW über <code>READY_TO_START</code> weiter Richtung <code>RIPPING</code></li> </ul> <div class="admonition info"> <p class=admonition-title>Scoring-Details</p> <p>Wie die Scores berechnet werden, erklärt die <a href=../../pipeline/playlist-analysis/ >Playlist-Analyse</a>-Seite.</p> </div> <hr> <h2 id=schritt-6-ripping-ripping>Schritt 6 – Ripping → <code>RIPPING</code><a class=headerlink href=#schritt-6-ripping-ripping title="Permanent link">&para;</a></h2> <p><strong>Vorher prüft Ripster:</strong> Existiert bereits eine Raw-Datei für diesen Job?</p> <ul> <li><strong>Ja, Raw-Datei vorhanden</strong> → Direkt zu Schritt 7 (Track-Review), kein erneutes Ripping</li> <li><strong>Nein</strong> → MakeMKV-Ripping startet</li> </ul> <p>Im Standardfall startet Ripster diesen Schritt automatisch nach der Metadaten-Auswahl. Der Button <strong>"Job starten"</strong> ist hauptsächlich für Sonderfälle sichtbar (z. B. Fallback/Queue).</p> <p><strong>Was MakeMKV ausführt (MKV-Modus):</strong></p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-4-1><a id=__codelineno-4-1 name=__codelineno-4-1 href=#__codelineno-4-1></a>makemkvcon<span class=w> </span>mkv<span class=w> </span>disc:0<span class=w> </span>all<span class=w> </span>/mnt/raw/Inception-2010/<span class=w> </span><span class=se>\</span>
</span><span id=__span-4-2><a id=__codelineno-4-2 name=__codelineno-4-2 href=#__codelineno-4-2></a><span class=w> </span>--minlength<span class=o>=</span><span class=m>900</span><span class=w> </span>-r
</span></code></pre></div> <p><strong>Was MakeMKV ausführt (Backup-Modus):</strong></p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-5-1><a id=__codelineno-5-1 name=__codelineno-5-1 href=#__codelineno-5-1></a>makemkvcon<span class=w> </span>backup<span class=w> </span>disc:0<span class=w> </span>/mnt/raw/Inception-2010-backup/<span class=w> </span><span class=se>\</span>
</span><span id=__span-5-2><a id=__codelineno-5-2 name=__codelineno-5-2 href=#__codelineno-5-2></a><span class=w> </span>--decrypt<span class=w> </span>-r
</span></code></pre></div> <p><strong>Live-Fortschritt</strong> wird aus der MakeMKV-Ausgabe geparst:</p> <div class="language-text highlight"><pre><span></span><code><span id=__span-6-1><a id=__codelineno-6-1 name=__codelineno-6-1 href=#__codelineno-6-1></a>PRGV:2048,0,65536 → Fortschritt wird berechnet und per WebSocket gesendet
</span><span id=__span-6-2><a id=__codelineno-6-2 name=__codelineno-6-2 href=#__codelineno-6-2></a>PRGT:5011,0,&quot;Sichern...&quot; → Aktueller Task-Name
</span></code></pre></div> <p><strong>Typische Dauer:</strong> - DVD: 20–45 Minuten - Blu-ray: 45–120 Minuten</p> <hr> <h2 id=schritt-7-track-review-ready_to_encode>Schritt 7 – Track-Review → <code>READY_TO_ENCODE</code><a class=headerlink href=#schritt-7-track-review-ready_to_encode title="Permanent link">&para;</a></h2> <p>Nach dem Ripping (oder direkt bei vorhandener Raw-Datei) startet der <strong>HandBrake-Scan</strong>:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-7-1><a id=__codelineno-7-1 name=__codelineno-7-1 href=#__codelineno-7-1></a>HandBrakeCLI<span class=w> </span>--scan<span class=w> </span>-i<span class=w> </span>&lt;quelle&gt;<span class=w> </span>-t<span class=w> </span><span class=m>0</span>
</span></code></pre></div> <p><strong>Typische Dauer:</strong> - DVD: 20–45 Minuten - Blu-ray: 45–120 Minuten</p> <hr> <h2 id=schritt-7-track-review-ready_to_encode>Schritt 7 – Track-Review → <code>READY_TO_ENCODE</code><a class=headerlink href=#schritt-7-track-review-ready_to_encode title="Permanent link">&para;</a></h2> <p>Nach dem Ripping, nach Playlist-Übernahme oder direkt bei vorhandenem RAW startet der <strong>HandBrake-Scan</strong>:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-7-1><a id=__codelineno-7-1 name=__codelineno-7-1 href=#__codelineno-7-1></a>HandBrakeCLI<span class=w> </span>--scan<span class=w> </span>-i<span class=w> </span>&lt;quelle&gt;<span class=w> </span>-t<span class=w> </span><span class=m>0</span>
</span></code></pre></div> <p>Dieser Scan liest alle Tracks aus ohne zu encodieren. Ripster baut daraus den Encode-Plan mit automatischer Vorauswahl:</p> <p><strong>Status: <code>MEDIAINFO_CHECK</code></strong> – läuft automatisch, kein Benutzereingriff</p> <p>Danach öffnet sich das <strong>Encode-Review-Panel</strong> (<code>READY_TO_ENCODE</code>):</p> <div class="language-text highlight"><pre><span></span><code><span id=__span-8-1><a id=__codelineno-8-1 name=__codelineno-8-1 href=#__codelineno-8-1></a>┌─────────────────────────────────────────────────────────────────┐
</span><span id=__span-8-2><a id=__codelineno-8-2 name=__codelineno-8-2 href=#__codelineno-8-2></a>│ Encode-Review │
</span><span id=__span-8-3><a id=__codelineno-8-3 name=__codelineno-8-3 href=#__codelineno-8-3></a>│ Titel: Disc Title 1 · Laufzeit: 2:28:05 · 28 Kapitel │
@@ -80,9 +78,9 @@
</span><span id=__span-8-13><a id=__codelineno-8-13 name=__codelineno-8-13 href=#__codelineno-8-13></a>│ ☑ │ Track 1: Deutsch │ Einbr.☐ │Forc.☐│Default☑ │
</span><span id=__span-8-14><a id=__codelineno-8-14 name=__codelineno-8-14 href=#__codelineno-8-14></a>│ ☐ │ Track 2: English │ Einbr.☐ │Forc.☐│Default☐ │
</span><span id=__span-8-15><a id=__codelineno-8-15 name=__codelineno-8-15 href=#__codelineno-8-15></a>├──────┴─────────────────────────────┴────────┴──────┴──────────┤
</span><span id=__span-8-16><a id=__codelineno-8-16 name=__codelineno-8-16 href=#__codelineno-8-16></a>│ [Encode bestätigen] │
</span><span id=__span-8-16><a id=__codelineno-8-16 name=__codelineno-8-16 href=#__codelineno-8-16></a>│ [Encoding starten] │
</span><span id=__span-8-17><a id=__codelineno-8-17 name=__codelineno-8-17 href=#__codelineno-8-17></a>└─────────────────────────────────────────────────────────────────┘
</span></code></pre></div> <h3 id=audio-track-aktionen-verstehen>Audio-Track-Aktionen verstehen<a class=headerlink href=#audio-track-aktionen-verstehen title="Permanent link">&para;</a></h3> <table> <thead> <tr> <th>Symbol/Text</th> <th>Bedeutung</th> </tr> </thead> <tbody> <tr> <td><code>Copy (ac3)</code></td> <td>Track wird <strong>verlustfrei</strong> direkt übernommen</td> </tr> <tr> <td><code>Copy (truehd)</code></td> <td>TrueHD-Track wird direkt übernommen</td> </tr> <tr> <td><code>Transcode (av_aac)</code></td> <td>Track wird zu AAC umgewandelt</td> </tr> <tr> <td><code>Fallback Transcode (av_aac)</code></td> <td>Copy nicht möglich → automatisch zu AAC</td> </tr> <tr> <td><code>Preset-Default (HandBrake)</code></td> <td>HandBrake-Preset entscheidet</td> </tr> <tr> <td><code>Nicht übernommen</code></td> <td>Track ist nicht ausgewählt</td> </tr> </tbody> </table> <h3 id=untertitel-flags>Untertitel-Flags<a class=headerlink href=#untertitel-flags title="Permanent link">&para;</a></h3> <table> <thead> <tr> <th>Flag</th> <th>Bedeutung</th> </tr> </thead> <tbody> <tr> <td><strong>Einbrennen</strong></td> <td>Untertitel werden fest ins Video gebrannt (nur ein Track möglich)</td> </tr> <tr> <td><strong>Forced</strong></td> <td>Nur erzwungene Untertitel-Einblendungen übernehmen</td> </tr> <tr> <td><strong>Default</strong></td> <td>Diese Spur wird beim Abspielen automatisch aktiviert</td> </tr> </tbody> </table> <h3 id=vorauswahl-regeln>Vorauswahl-Regeln<a class=headerlink href=#vorauswahl-regeln title="Permanent link">&para;</a></h3> <p>Die Tracks mit <code>☑</code> wurden nach der Regel aus den Einstellungen automatisch vorausgewählt (<code>selectedByRule: true</code>). Die Auswahl kann frei geändert werden.</p> <p>Klicke <strong>"Encode bestätigen"</strong> um fortzufahren.</p> <hr> <h2 id=schritt-8-encoding-encoding>Schritt 8 – Encoding → <code>ENCODING</code><a class=headerlink href=#schritt-8-encoding-encoding title="Permanent link">&para;</a></h2> <p>HandBrake startet mit dem finalisierten Plan:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-9-1><a id=__codelineno-9-1 name=__codelineno-9-1 href=#__codelineno-9-1></a>HandBrakeCLI<span class=w> </span><span class=se>\</span>
</span></code></pre></div> <h3 id=audio-track-aktionen-verstehen>Audio-Track-Aktionen verstehen<a class=headerlink href=#audio-track-aktionen-verstehen title="Permanent link">&para;</a></h3> <table> <thead> <tr> <th>Symbol/Text</th> <th>Bedeutung</th> </tr> </thead> <tbody> <tr> <td><code>Copy (ac3)</code></td> <td>Track wird <strong>verlustfrei</strong> direkt übernommen</td> </tr> <tr> <td><code>Copy (truehd)</code></td> <td>TrueHD-Track wird direkt übernommen</td> </tr> <tr> <td><code>Transcode (av_aac)</code></td> <td>Track wird zu AAC umgewandelt</td> </tr> <tr> <td><code>Fallback Transcode (av_aac)</code></td> <td>Copy nicht möglich → automatisch zu AAC</td> </tr> <tr> <td><code>Preset-Default (HandBrake)</code></td> <td>HandBrake-Preset entscheidet</td> </tr> <tr> <td><code>Nicht übernommen</code></td> <td>Track ist nicht ausgewählt</td> </tr> </tbody> </table> <h3 id=untertitel-flags>Untertitel-Flags<a class=headerlink href=#untertitel-flags title="Permanent link">&para;</a></h3> <table> <thead> <tr> <th>Flag</th> <th>Bedeutung</th> </tr> </thead> <tbody> <tr> <td><strong>Einbrennen</strong></td> <td>Untertitel werden fest ins Video gebrannt (nur ein Track möglich)</td> </tr> <tr> <td><strong>Forced</strong></td> <td>Nur erzwungene Untertitel-Einblendungen übernehmen</td> </tr> <tr> <td><strong>Default</strong></td> <td>Diese Spur wird beim Abspielen automatisch aktiviert</td> </tr> </tbody> </table> <h3 id=vorauswahl-regeln>Vorauswahl-Regeln<a class=headerlink href=#vorauswahl-regeln title="Permanent link">&para;</a></h3> <p>Die Tracks mit <code>☑</code> wurden nach der Regel aus den Einstellungen automatisch vorausgewählt (<code>selectedByRule: true</code>). Die Auswahl kann frei geändert werden.</p> <p>Klicke <strong>"Encoding starten"</strong> (bzw. im Pre-Rip-Modus <strong>"Backup + Encoding starten"</strong>), um fortzufahren. Falls die Auswahl noch nicht bestätigt wurde, übernimmt das Frontend die Bestätigung automatisch beim Start.</p> <hr> <h2 id=schritt-8-encoding-encoding>Schritt 8 – Encoding → <code>ENCODING</code><a class=headerlink href=#schritt-8-encoding-encoding title="Permanent link">&para;</a></h2> <p>HandBrake startet mit dem finalisierten Plan:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-9-1><a id=__codelineno-9-1 name=__codelineno-9-1 href=#__codelineno-9-1></a>HandBrakeCLI<span class=w> </span><span class=se>\</span>
</span><span id=__span-9-2><a id=__codelineno-9-2 name=__codelineno-9-2 href=#__codelineno-9-2></a><span class=w> </span>-i<span class=w> </span>/dev/sr0<span class=w> </span><span class=se>\</span>
</span><span id=__span-9-3><a id=__codelineno-9-3 name=__codelineno-9-3 href=#__codelineno-9-3></a><span class=w> </span>-o<span class=w> </span><span class=s2>&quot;/mnt/movies/Inception (2010).mkv&quot;</span><span class=w> </span><span class=se>\</span>
</span><span id=__span-9-4><a id=__codelineno-9-4 name=__codelineno-9-4 href=#__codelineno-9-4></a><span class=w> </span>-t<span class=w> </span><span class=m>1</span><span class=w> </span><span class=se>\</span>
@@ -94,4 +92,4 @@
</span></code></pre></div> <p><strong>Live-Fortschritt</strong> wird aus HandBrake-stderr geparst:</p> <div class="language-text highlight"><pre><span></span><code><span id=__span-10-1><a id=__codelineno-10-1 name=__codelineno-10-1 href=#__codelineno-10-1></a>Encoding: task 1 of 1, 73.50 % (45.23 fps, avg 44.12 fps, ETA 00h12m34s)
</span></code></pre></div> <p>Das Dashboard zeigt: - Fortschrittsbalken (0–100 %) - Aktuelle Encoding-Geschwindigkeit (FPS) - Geschätzte Restzeit (ETA)</p> <p><strong>Typische Dauer (abhängig von CPU/GPU und Preset):</strong> - Schnelles Preset (<code>fast</code>): 0.5× Echtzeit - Standard-Preset: 1–3× Echtzeit - Langsames Preset (<code>slow</code>): 5–10× Echtzeit</p> <hr> <h2 id=schritt-9-fertig-finished>Schritt 9 – Fertig! → <code>FINISHED</code><a class=headerlink href=#schritt-9-fertig-finished title="Permanent link">&para;</a></h2> <div class="language-text highlight"><pre><span></span><code><span id=__span-11-1><a id=__codelineno-11-1 name=__codelineno-11-1 href=#__codelineno-11-1></a>/mnt/nas/movies/
</span><span id=__span-11-2><a id=__codelineno-11-2 name=__codelineno-11-2 href=#__codelineno-11-2></a>└── Inception (2010).mkv ✓ Encodierung abgeschlossen
</span></code></pre></div> <ul> <li>Job-Status in der Datenbank: <code>FINISHED</code></li> <li>PushOver-Benachrichtigung (falls konfiguriert)</li> <li>Eintrag in der <a href=http://localhost:5173/history>History</a> mit vollständigen Logs</li> </ul> <hr> <h2 id=fehlerbehandlung>Fehlerbehandlung<a class=headerlink href=#fehlerbehandlung title="Permanent link">&para;</a></h2> <h3 id=job-im-status-error>Job im Status <code>ERROR</code><a class=headerlink href=#job-im-status-error title="Permanent link">&para;</a></h3> <ol> <li><strong>Dashboard</strong>: Details-Button → Log-Ausgabe prüfen</li> <li><strong>Retry</strong>: Job vom Fehlerzustand neu starten (behält Metadaten)</li> <li><strong>History</strong>: Vollständige Logs und Fehlerdetails</li> </ol> <h3 id=haufige-fehlerursachen>Häufige Fehlerursachen<a class=headerlink href=#haufige-fehlerursachen title="Permanent link">&para;</a></h3> <table> <thead> <tr> <th>Fehler</th> <th>Ursache</th> <th>Lösung</th> </tr> </thead> <tbody> <tr> <td>MakeMKV: Lizenzfehler</td> <td>Abgelaufene Beta-Lizenz</td> <td>Neue Lizenz im <a href="https://www.makemkv.com/forum/viewtopic.php?t=1053">MakeMKV-Forum</a></td> </tr> <tr> <td>HandBrake: Preset nicht gefunden</td> <td>Preset-Name falsch</td> <td><code>HandBrakeCLI --preset-list</code> prüfen</td> </tr> <tr> <td>Keine Disc erkannt</td> <td>Laufwerk-Berechtigungen</td> <td><code>sudo chmod a+rw /dev/sr0</code></td> </tr> <tr> <td>Falsches Video (zerstückelt)</td> <td>Falsche Playlist</td> <td>Job re-encodieren mit anderer Playlist</td> </tr> <tr> <td>OMDb: Keine Ergebnisse</td> <td>API-Key fehlt oder Titel nicht gefunden</td> <td>Einstellungen prüfen; manuell eingeben</td> </tr> </tbody> </table> <hr> <h2 id=kurzubersicht-aller-schritte>Kurzübersicht aller Schritte<a class=headerlink href=#kurzubersicht-aller-schritte title="Permanent link">&para;</a></h2> <table> <thead> <tr> <th>#</th> <th>Status</th> <th>Benutzeraktion</th> <th>Was Ripster tut</th> </tr> </thead> <tbody> <tr> <td>1</td> <td><code>IDLE</code></td> <td>Disc einlegen</td> <td>Disc-Polling erkennt Disc</td> </tr> <tr> <td>2</td> <td><code>DISC_DETECTED</code></td> <td>"Analyse starten" klicken</td> <td>Job anlegen, OMDb vorsuchen</td> </tr> <tr> <td>3</td> <td><code>METADATA_SELECTION</code></td> <td>Film im Dialog auswählen</td> <td>Playlist-Analyse durchführen</td> </tr> <tr> <td>4a</td> <td><code>READY_TO_START</code></td> <td>—</td> <td>Empfehlung automatisch übernommen</td> </tr> <tr> <td>4b</td> <td><code>WAITING_FOR_USER_DECISION</code></td> <td>Playlist manuell wählen</td> <td>Auf Bestätigung warten</td> </tr> <tr> <td>5</td> <td><code>READY_TO_START</code></td> <td>"Starten" klicken</td> <td>MakeMKV-Ripping starten</td> </tr> <tr> <td>6</td> <td><code>RIPPING</code></td> <td>Warten</td> <td>MakeMKV rippt, Fortschritt streamen</td> </tr> <tr> <td>7</td> <td><code>MEDIAINFO_CHECK</code></td> <td>Warten</td> <td>HandBrake-Scan, Encode-Plan bauen</td> </tr> <tr> <td>8</td> <td><code>READY_TO_ENCODE</code></td> <td>Tracks prüfen + bestätigen</td> <td>Auswahl in Plan übernehmen</td> </tr> <tr> <td>9</td> <td><code>ENCODING</code></td> <td>Warten</td> <td>HandBrake encodiert, Fortschritt streamen</td> </tr> <tr> <td>10</td> <td><code>FINISHED</code></td> <td>—</td> <td>Datei fertig, Benachrichtigung senden</td> </tr> </tbody> </table> </article> </div> <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> <button type=button class="md-top md-icon" data-md-component=top hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg> Zurück zum Seitenanfang </button> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> <div class=md-social> <a href=https://github.com/YOUR_GITHUB_USERNAME/ripster target=_blank rel=noopener title=github.com class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3Line truncated
</span></code></pre></div> <ul> <li>Job-Status in der Datenbank: <code>FINISHED</code></li> <li>PushOver-Benachrichtigung (falls konfiguriert)</li> <li>Eintrag in der <a href=http://localhost:5173/history>History</a> mit vollständigen Logs</li> </ul> <hr> <h2 id=fehlerbehandlung>Fehlerbehandlung<a class=headerlink href=#fehlerbehandlung title="Permanent link">&para;</a></h2> <h3 id=job-im-status-error>Job im Status <code>ERROR</code><a class=headerlink href=#job-im-status-error title="Permanent link">&para;</a></h3> <ol> <li><strong>Dashboard</strong>: Details-Button → Log-Ausgabe prüfen</li> <li><strong>Retry</strong>: Job vom Fehlerzustand neu starten (behält Metadaten)</li> <li><strong>History</strong>: Vollständige Logs und Fehlerdetails</li> </ol> <h3 id=haufige-fehlerursachen>Häufige Fehlerursachen<a class=headerlink href=#haufige-fehlerursachen title="Permanent link">&para;</a></h3> <table> <thead> <tr> <th>Fehler</th> <th>Ursache</th> <th>Lösung</th> </tr> </thead> <tbody> <tr> <td>MakeMKV: Lizenzfehler</td> <td>Abgelaufene Beta-Lizenz</td> <td>Neue Lizenz im <a href="https://www.makemkv.com/forum/viewtopic.php?t=1053">MakeMKV-Forum</a></td> </tr> <tr> <td>HandBrake: Preset nicht gefunden</td> <td>Preset-Name falsch</td> <td><code>HandBrakeCLI --preset-list</code> prüfen</td> </tr> <tr> <td>Keine Disc erkannt</td> <td>Laufwerk-Berechtigungen</td> <td><code>sudo chmod a+rw /dev/sr0</code></td> </tr> <tr> <td>Falsches Video (zerstückelt)</td> <td>Falsche Playlist</td> <td>Job re-encodieren mit anderer Playlist</td> </tr> <tr> <td>OMDb: Keine Ergebnisse</td> <td>API-Key fehlt oder Titel nicht gefunden</td> <td>Einstellungen prüfen; manuell eingeben</td> </tr> </tbody> </table> <hr> <h2 id=kurzubersicht-aller-schritte>Kurzübersicht aller Schritte<a class=headerlink href=#kurzubersicht-aller-schritte title="Permanent link">&para;</a></h2> <table> <thead> <tr> <th>#</th> <th>Status</th> <th>Benutzeraktion</th> <th>Was Ripster tut</th> </tr> </thead> <tbody> <tr> <td>1</td> <td><code>IDLE</code></td> <td>Disc einlegen</td> <td>Disc-Polling erkennt Disc</td> </tr> <tr> <td>2</td> <td><code>DISC_DETECTED</code></td> <td>"Analyse starten" klicken</td> <td>Job anlegen, OMDb vorsuchen</td> </tr> <tr> <td>3</td> <td><code>METADATA_SELECTION</code></td> <td>Film im Dialog auswählen</td> <td>Start automatisch einplanen/auslösen</td> </tr> <tr> <td>4</td> <td><code>READY_TO_START</code></td> <td>meist keine</td> <td>Übergangszustand vor Auto-Start</td> </tr> <tr> <td>5</td> <td><code>RIPPING</code></td> <td>Warten</td> <td>MakeMKV rippt, Fortschritt streamen</td> </tr> <tr> <td>6</td> <td><code>MEDIAINFO_CHECK</code></td> <td>Warten</td> <td>HandBrake-Scan, Encode-Plan bauen</td> </tr> <tr> <td>7</td> <td><code>WAITING_FOR_USER_DECISION</code> (optional)</td> <td>Playlist manuell wählen</td> <td>Auf Bestätigung warten</td> </tr> <tr> <td>8</td> <td><code>READY_TO_ENCODE</code></td> <td>Tracks prüfen + "Encoding starten"</td> <td>Auswahl übernehmen, Start auslösen</td> </tr> <tr> <td>9</td> <td><code>ENCODING</code></td> <td>Warten</td> <td>HandBrake encodiert, inkl. Post-Skripte</td> </tr> <tr> <td>10</td> <td><code>FINISHED</code></td> <td>—</td> <td>Datei fertig, Benachrichtigung senden</td> </tr> </tbody> </table> </article> </div> <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> <button type=button class="md-top md-icon" data-md-component=top hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg> Zurück zum Seitenanfang </button> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> <div class=md-social> <a href=https://github.com/YOUR_GITHUB_USERNAME/ripster target=_blank rel=noopener title=github.com class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6Line truncated