Was macht Countdown-Video?
Verwandle eine Rangliste in ein fertiges Listenvideo im Stil von Film-/Listenkanälen. Zwei Modi:
"mode": "countdown"(Standard): No.N → No.1, ein orangefarbener "No.X"-Slam vor jedem Eintrag."mode": "timeline": ein „Evolution“-Video (z.B. LAIKA Animation Evolution 2005–2022), ältester → neuester, eine große Jahreskarte vor jedem Eintrag.
In beiden Modi kann ein Eintrag einen Trailerausschnitt enthalten, der nach seiner Karte im Vollbild abgespielt wird, mit einem unteren Drittel-Titel und dem eigenen Ton des Trailers (Musik wird darunter ausgeblendet). Auf Listenkanälen ist das Format Karte + ~25–30 s Trailer pro Film dasjenige, das die Zuschauer am längsten hält.
Das Video hat ein Intro, dann für jeden Eintrag einen „No.X“-Rang-Slam, gefolgt von einer animierten Karte (Bild, Titel, Jahr, Genre, Finanzstatistiken mit Balken, Bewertungen, Fun Fact), einem Fortschrittsbalken und einer Endcard mit Slots für YouTube-Endscreen-Elemente. Alles ist datengesteuert: Recherche geht in items.json, die Engine rendert es.
Sprich mit dem Benutzer in seiner bevorzugten Sprache; behalte Code und items.json auf Englisch, es sei denn, der Benutzer wünscht Bildschirmtext in einer anderen Sprache.
Dateien (relativ zu diesem Skill-Ordner)
| Datei | Zweck |
|---|---|
templates/countdown_template.html | Die Engine: Intro, Rang-Karten, Item-Karten, Fortschrittsbalken, Outro. Thema und Timing sind aus items.json überschreibbar. |
scripts/build_countdown.py | items.json → _work/build.html, timeline.json, cues.json (SFX), chapters.txt; kennzeichnet fehlende/unlesbare Bilder. |
scripts/render.py | Deterministischer Frame-Bereichs-Renderer (Playwright → x264). |
scripts/compose_clips.py | Legt jeden Trailerausschnitt eines Eintrags im Vollbild (letterboxed) mit einem unteren Drittel „TRAILER · Titel (Jahr)“ an und extrahiert die Clip-Audio. Wird automatisch von make_countdown.sh ausgeführt. |
scripts/countdown_audio.py | Originelle Upbeat-Musikschleife (oder --music your_track.mp3), Whoosh/Hit/Pop/Tick-SFX auf Cues, Trailer-Audio mit duckender Musik auf --clip-music (Standard 0,12), optionale Rang-Sprachausgabe. |
scripts/make_countdown.sh | Ganze Pipeline: Build → paralleles Rendern → Audio → MP4 + QA-Blatt + Kapitel. |
Einrichtung: pip install playwright soundfile scipy pillow --break-system-packages und playwright install chromium falls fehlend; ffmpeg im PATH. Optionale Sprachausgabe: Kokoro TTS (siehe voiceover.py des PPT-Animation-Skills).
Arbeitsablauf
- Briefing. Thema, Modus (Countdown oder Timeline), Anzahl der Einträge (N), Ranking-Metrik (z.B. weltweites Einspielergebnis), welche Felder anzuzeigen sind, ob Trailerausschnitte enthalten sein sollen (und wie lang, Standard 25 s), Videolänge (≈ 5 s Intro + N × (~11 s + Clip) + 12 s Outro), Musik (eigene Spur oder generiert). Frage einmal nach, wenn der Benutzer anwesend ist; ansonsten wähle sinnvolle Standardwerte und sage dies.
- Recherchiere das Ranking. Verwende Websuche und öffne die Quellseiten; fülle niemals Zahlen aus dem Gedächtnis. Bevorzugte Quellen: Box Office Mojo / The Numbers (Budget, weltweites Einspielergebnis), IMDb, Rotten Tomatoes, Metacritic (Bewertungen), Wikipedia für Jahre und Genres. Notiere die URL(s) in den
sourcesjedes Eintrags. Wenn zwei Quellen widersprechen, verwende eine Quelle konsistent für die Ranking-Metrik und vermerke dies. Wenn ein Wert nicht gefunden werden kann, lasse das Feld weg (die Karte passt sich an) – erfinde ihn niemals. - Schreibe
items.json(Schema unten), Ränge 1..N, wobei 1 der oberste Eintrag ist. Das Video zählt N → 1 herunter ("order": "up"kehrt dies um). - Bilder und Clips. Verwende Bilder und Trailerdateien, die der Benutzer bereitstellt (
posters/<slug>.jpg, 2:3 Hochformat;clips/<slug>.mp4). Lade keine Poster, Trailer, Standbilder oder Fotos von Personen aus dem Web herunter; bitte den Benutzer, sie in den Ordner zu legen. Ohne Bild zeigt die Karte einen sauberen Titel-Platzhalter, und ein fehlender Clip wird übersprungen, sodass zuerst ein Entwurf gerendert werden kann. Wähle für jeden Clipstart(überspringe Studio-Logos und schwarze Frames) undduration. Trailer können Content-ID-Ansprüche auf YouTube auslösen; das liegt in der Verantwortung des Kanaleigentümers, erwähne es also einmal. - Build + Vorschau.
python3 scripts/build_countdown.py items.json _work/und dann Screenshots von einigen Momenten (Intro ~3 s, eine Rang-Karte, eine vollständige Item-Karte am Ende, das Outro) und PRÜFEN: nichts überlappt, lange Titel passen, Zahlen sind bei 360p lesbar. - Rendern.
bash scripts/make_countdown.sh items.json out.mp4 [chunks] [-- --music track.mp3 --music-vol 0.5 --voice vo_dir]. - Qualitätssicherung. Öffne
out_sheet.png; überprüfe stichprobenartig Zahlen gegenitems.json; bestätige die Dauer und dass jeder Rang genau einmal vorkommt. - Ausliefern. Die MP4, die Kapitel (
out_chapters.txt, in die YouTube-Beschreibung einfügen), die Quellenliste und einen vorgeschlagenen Titel / Beschreibung / Tags. Erinnere den Benutzer daran, in YouTube Studio die Endscreen-Elemente über die Outro-Slots zu legen.
items.json Schema
Die folgenden Werte sind Platzhalter, die die Struktur zeigen, keine echten Daten.
{
"title": "Top 5 erfolgreichste Stop-Motion-Filme",
"subtitle": "Rangliste nach weltweitem Einspielergebnis",
"channel": "Kanalname",
"currency": "EUR",
"order": "down",
"mode": "countdown",
"intro_image": "logo.png",
"outro_title": "Welcher ist dein Favorit?",
"outro_subtitle": "Sag es uns in den Kommentaren!",
"timing": {"intro": 5, "rank": 1.8, "item": 9, "outro": 12},
"theme": {"bgA": "#8BE36A", "bgB": "#F7E25A", "border": "#F0385C", "money": "#9B59D0", "ratings": "#5BD3F5"},
"items": [
{
"rank": 1, "title": "Chicken Run", "year": 2000, "subtitle": "Familie/Komödie",
"image": "posters/chicken-run.jpg",
"stats": [{"label": "Budget", "value": 45000000}, {"label": "Einspielergebnis", "value": 225100000}],
"multiple": "das 5-fache seines Budgets",
"ratings": {"imdb": 7.0, "rt": 90, "rt_audience": 75, "metacritic": 80},
"fact": "Ein kurzer, belegter Satz.",
"teaser": "optionale Zeile unter dem No.X-Slam",
"clip": {"file": "clips/chicken-run-trailer.mp4", "start": "0:12", "duration": 25},
"label": "optionaler Text für die Slam-Karte anstelle von No.X / dem Jahr",
"seconds": 9,
"sources": ["https://www.boxofficemojo.com/title/tt0120630/"]
}
]
}
stats[].valueals Zahl → animiertes Hochzählen + Vergleichsbalken (Balken teilen sich eine Skala pro Karte); als Zeichenkette → wird unverändert angezeigt (z.B."N/A","8.848 m"). Jede Beschriftung funktioniert, sodass dieselbe Engine für nicht-filmische Countdowns (höchste Gebäude, reichste Menschen, schnellste Autos) verwendet werden kann.ratings-Schlüssel sind optional:imdb(0–10, Stern),rt/rt_audience/metacritic(0–100, Ring). Fehlende Schlüssel verschwinden; eine Karte ohne Bewertungen zentriert ihre anderen Boxen.clip.startakzeptiert Sekunden oderm:ss; der Clip wird auf 16:9 letterboxed und nach der Karte abgespielt. Kapitel und die Endcard-Zeitplanung berücksichtigen die Cliplänge automatisch.intro_image(z.B. ein vom Benutzer bereitgestelltes Studio-Logo) ersetzt das TOP N / EVOLUTION-Abzeichen auf dem Intro.- Im Timeline-Modus werden Einträge nach
yearsortiert; das Rang-Abzeichen auf der Karte wird ausgeblendet und Kapitel lesen „Titel (Jahr)". multipleist eine kurze hervorgehobene Pille unter der Geld-Box; berechne es aus den Quellzahlen (auf eine Dezimalstelle gerundet).- Bewertungen werden nur als Textbeschriftungen angezeigt – keine Markenlogos.
- Jede Bewertung, Zahl oder Tatsache, die auf dem Bildschirm angezeigt wird, muss aus einer Quelle in
sourcesstammen.
Stilhinweise
- Standard-Theme entspricht klassischen Listenkanälen: abwechselnd grüne/gelbe Kreidestruktur-Karten, roter Rand, orangefarbener „No.X"-Slam mit Strahlen, lila Geld-Box, blaue Bewertungs-Box. Überschreibe jede Farbe in
theme. - Lesbarkeit bei 360p: halte Titel kurz (Subtitle trägt das Genre), Fakten ≤ 2 Zeilen, füge nicht mehr als 4 Stats hinzu.
- Bindung: ~11 s pro Eintrag; platziere die stärksten Einträge zuletzt; der Rang-Slam + Whoosh/Hit-SFX setzt die Aufmerksamkeit bei jedem Eintrag zurück; halte das Intro ≤ 5 s.
- YouTube-Kapitel benötigen ≥ 10 s, daher wird das Intro automatisch in das Kapitel des ersten Rangs integriert.