Flaro/docs/ABSPANN-IM-BILD.md

Den Abspann im Bild finden — Entwurf

Der Tonabgleich findet Vorspann und Abspann, weil sie sich wiederholen: dieselbe Musik in Folge 1 und Folge 2. Ein Film hat nichts, womit er sich vergleichen liesse. Sein Abspann kommt genau einmal vor.

Was bleibt, ist das Bild. Dieser Entwurf sagt, was daran messbar ist, was es kostet, und wo das Verfahren danebenliegt.

Kapitelmarken sind hier bewusst nicht der Weg: sie sind exakt, wo sie stehen, aber bei einer gemischten Sammlung stehen sie selten.

---

1 · Das Signal, nachgemessen

Ein Abspann ist dunkel. Das ist keine Vermutung — nachgestellt mit einem erzeugten Film (90 Sekunden Bild, danach 40 Sekunden weisse Schrift auf schwarzem Grund), abgetastet mit zwei Bildern je Sekunde:

Stelle	mittlere Helligkeit (YAVG, 0–255)
0–89,5 s (Handlung)	125
ab 90,0 s (Abspann)	18

Der Sprung liegt auf dem Bild genau, an dem der Abspann anfängt. Kein Übergang, keine Grauzone — und das ist der Punkt: gesucht wird nicht „ein dunkles Bild", sondern die Kante.

Dieselbe Richtung geht Jellyfins Intro Skipper. Dort heisst es „Add support for using black frames to locate ending credits"; die Suche läuft rückwärts vom Ende und hört auf, wenn der Bereich auf vier Sekunden geschrumpft ist.

2 · Was es kostet

Das Rechnen ist umsonst, das Dekodieren ist der Preis. Gemessen an einer erzeugten Datei, 1080p, h264, 180 Sekunden:

Weg	Zeit
Jedes zweite Bild dekodieren (fps=2)	2,89 s
Nur Schlüsselbilder (-skip_frame nokey)	0,24 s

Hochgerechnet auf die letzten 15 Minuten eines Films: der erste Weg kostet rund anderthalb Minuten je Film, der zweite ein paar Sekunden. Das ist eine Hochrechnung, keine Messung an echtem Material.

Es geht noch billiger, und so macht es Jellyfin: nicht am Stück abtasten, sondern zielen. Binäre Suche mit Sonden von zwei Sekunden zwischen „sicher Handlung" und „sicher Abspann" — zehn Sonden genügen für eine Genauigkeit von vier Sekunden, und zehn mal zwei Sekunden Dekodierung sind nichts.

Vorschlag: beides. Erst eine grobe Reihe von Schlüsselbildern über die letzten zwanzig Minuten (ein Durchlauf, wenige Sekunden) — die sagt, ob es überhaupt eine dunkle Strecke am Ende gibt und ungefähr wo. Dann eine binäre Suche mit kurzen Sonden auf die Kante. Der erste Schritt verhindert, dass die binäre Suche in einem Film ohne dunklen Abspann wild herumspringt; der zweite macht sie genau.

3 · Der Zuschnitt

Dieselbe Trennung wie beim Tonabgleich: das Schwierige rein, das Dreckige dünn.

Bildabtaster (Flaro.Media) — der einzige Teil, der ffmpeg anfasst.

helligkeiten(pfad, ab, bis, schritt) -> [(sekunde, helligkeit)]
istDunkel(pfad, ab, dauer)           -> bool

Beides über signalstats beziehungsweise blackdetect, als eigener Prozess wie FfprobeRunner. Fehlt ffmpeg oder scheitert der Lauf: leere Antwort, keine Marke, kein Abbruch.

Abspannkante (Flaro.Core) — reine Rechnung, ohne Datei:

Suchen(messpunkte, laufzeit, regeln) -> Kante?

Nimmt die Reihe aus Schritt eins und gibt zurück, wo die dunkle Strecke anfängt — oder nichts. Hier liegen alle Schwellen, und hier liegen die Prüfungen. Dieselbe Rolle wie Tonabgleich.

Markenerkennung bekommt einen zweiten Zweig: Serien über den Ton, Filme über das Bild. Die Tabelle, der Vertrag, die Knöpfe in App und Web stehen schon — ein Abspann ist ein Abspann, egal woher er kommt.

Dafür braucht Marke eine Spalte MovieId neben EpisodeId (heute nur Folgen), und MovieResponse die Marken, wie EpisodeResponse sie schon hat.

4 · Die Schwellen

Alles hier ist eine Setzung und gehört an eine Stelle, damit man sie gemeinsam verschieben kann:

Grösse	Vorschlag	Warum
Helligkeit „dunkel"	YAVG < 35	Gemessen: Abspann 18, Handlung 125. Fünfunddreissig liegt weit von beiden.
Anteil dunkler Bilder in einer Sonde	85 %	Eine Schrifttafel blitzt hell auf; eine einzelne helle Sonde darf die Strecke nicht brechen.
Kürzester Abspann	45 s	Darunter lohnt kein Knopf, und zufällige Dunkelheit ist häufiger.
Längster Abspann	12 min	Darüber ist es kein Abspann, sondern ein Fehlfund.
Suchbereich	letzte 20 min	Bei einem Dreistünder wäre „die letzten 10 %" zu viel, bei einem Kurzfilm zu wenig.
Genauigkeit	4 s	Wie bei Jellyfin. Feiner zu suchen kostet Sonden und bringt niemandem etwas.

5 · Wo es danebenliegt — und was dann passiert

Das muss vorher dastehen, nicht hinterher.

• Abspann über laufendem Bild. Marvel, Pixar, jede zweite Komödie: die Namen laufen über eine Szene. Keine dunkle Strecke, kein Fund. → Kein Knopf. Das ist die richtige Antwort; ein geratener Knopf schnitte Handlung weg.
• Dunkle Schlussszene. Ein Film, der im Dunkeln endet, bekommt die Kante zu früh. Dagegen hilft die Mindestlänge und die Obergrenze — und dass die Kante die früheste dunkle Stelle einer durchgehenden Strecke bis zum Ende sein muss, nicht irgendeine.
• Schwarzblende mitten im Film. Kommt vor, hält aber selten bis zum Ende durch. Die Forderung „bis zum Dateiende dunkel" fängt das.
• Szene nach dem Abspann. Dann ist die Strecke unterbrochen, und der Fund fällt heraus. Lieber keiner als einer, der über die Szene springt.

Grobe Erwartung, ungemessen: bei Serien greift das Verfahren oft, bei Kinofilmen vielleicht bei der Hälfte. Mehr lässt sich erst sagen, wenn es an echtem Material gelaufen ist — und dafür braucht es einen Weg, die Funde nachzusehen.

6 · Nachsehen können

Ohne das wird aus dem Verfahren eine Blackbox, die manchmal recht hat. Vorschlag: auf der Detailseite steht bei einem Film mit Marke, wo sie liegt, mit einem Knopf „stimmt nicht" — der die Marke löscht und den Titel für weitere Läufe sperrt. Drei Zeilen Oberfläche, und man hat eine Messung statt eines Gefühls.

7 · Stufen

	Schritt	Prüfbar an
1	Abspannkante als reine Rechnung samt Prüfungen	erfundenen Messreihen
2	Bildabtaster über ffmpeg	der erzeugten Prüfdatei aus Abschnitt 1
3	Marke.MovieId, Wanderung, Marken im Filmvertrag	Serverprüfungen
4	Filme im Lauf nach dem Scan	am Bestand, im Protokoll
5	„stimmt nicht" auf der Detailseite	von Hand

Prüfliste

• V.1 Ein Film mit schwarzem Abspann bekommt eine Marke, und sie liegt innerhalb von fünf Sekunden an der richtigen Stelle.
• V.2 Ein Film mit Abspann über laufendem Bild bekommt keine Marke.
• V.3 Ein Film, der im Dunkeln endet, ohne Abspann, bekommt keine Marke.
• V.4 Der Lauf über hundert Filme belastet die Platte nicht länger als der Scan selbst.
• V.5 Der Überspringen-Knopf erscheint bei einem Film genauso wie bei einer Folge.
• V.6 Mit erkanntem Abspann gilt ein Film als gesehen, sobald er anfängt — dieselbe Regel wie bei Folgen, sie steht schon.

---

Quellen

• intro-skipper auf GitHub
• Intro Skipper, README
• Forenbeitrag zu Abspann-Erkennung