カウントダウンビデオ は何をしますか?
ランキングリストを、映画/リストチャンネル風の完成済みリストビデオに変換します。2つのモードがあります:
"mode": "countdown"(デフォルト):No.N → No.1へ、各エントリの前にオレンジの「No.X」スラムがあります。"mode": "timeline":「進化」ビデオ(例:LAIKAアニメーション進化史 2005–2022)、過去から未来へ、各エントリの前に大きな年カードがあります。
両方のモードで、各エントリは予告編クリップを持つことができ、そのカードの後にフルスクリーンで再生され、下部タイトルと独自の音声(音楽がその下にダック)が付きます。リストチャンネルでは、カード+約25~30秒の予告編が視聴維持率を最大化します。
ビデオはイントロ、各エントリの「No.X」ランクスラム、アニメーションカード(画像、タイトル、年、ジャンル、収益統計(棒グラフ付き)、評価、豆知識)、進行トラッカー、YouTubeエンド画面用スロット付きアウトロで構成されます。すべてデータ駆動:研究結果はitems.jsonに入力され、エンジンがレンダリングします。
オンデマンドでテキストを他の言語にする場合を除き、コードとitems.jsonは英語のままユーザーの希望言語で会話します。
ファイル(このスキルフォルダを基準とした相対パス)
| ファイル | 目的 |
|---|---|
templates/countdown_template.html | エンジン:イントロ、ランクカード、アイテムカード、トラッカー、アウトロ。テーマとタイミングはitems.jsonから上書き可能。 |
scripts/build_countdown.py | items.json → _work/build.html、timeline.json、cues.json(SFX)、chapters.txt;欠落/読み取り不能な画像をフラグ付け。 |
scripts/render.py | 決定論的フレーム範囲レンダラー(Playwright → x264)。 |
scripts/compose_clips.py | 各エントリの予告編クリップをフルフレーム(レターボックス)で配置し、下部に「TRAILER · タイトル(年)」を表示、クリップ音声を抽出します。make_countdown.shによって自動実行されます。 |
scripts/countdown_audio.py | オリジナルのアップビート音楽ループ(または--music your_track.mp3)、キューに合わせてウーッシュ/ヒット/ポップ/チックのSFX、予告編音声(音楽は--clip-music(デフォルト0.12)でダック)、オプションのランク音声。 |
scripts/make_countdown.sh | パイプライン全体:ビルド → パラレルレンダリング → オーディオ → MP4 + QAシート + チャプター。 |
セットアップ:pip install soundfile scipy pillow --break-system-packages と playwright install chromium(不足している場合)、ffmpegをPATHに追加。オプションの音声:Kokoro TTS(PPTアニメーションスキルのvoiceover.pyを参照)。
ワークフロー
- ブリーフィング。 トピック、モード(countdown または timeline)、エントリ数(N)、ランキング基準(例:全世界興行収入)、表示するフィールド、予告編クリップを含めるかどうか(および時間、デフォルト25秒)、ビデオ長(約5秒のイントロ + N ×(約11秒 + クリップ)+ 12秒のアウトロ)、音楽(ユーザーのトラックまたは生成)。ユーザーがいる場合は一度確認し、いない場合は適切なデフォルトを選択してその旨を伝えます。
- ランキングを調査する。 Web検索を使用し、ソースページを開きます。記憶から数値を埋めないでください。推奨ソース:Box Office Mojo / The Numbers(予算、全世界興行収入)、IMDb、Rotten Tomatoes、Metacritic(評価)、Wikipedia(年、ジャンル)。各アイテムの
sourcesにURLを記録します。2つのソースが一致しない場合は、ランキング基準に1つのソースを一貫して使用し、その旨をメモします。値が見つからない場合はフィールドを省略します(カードが適応します)。決して値を発明しないでください。 items.jsonを書く(以下のスキーマ)、ランク1~N(1がトップエントリ)。ビデオはNから1へカウントダウンします("order": "up"で逆転)。- 画像とクリップ。 ユーザーが提供する画像と予告編ファイルを使用します(
posters/<slug>.jpg、2:3縦長;clips/<slug>.mp4)。自分でWebからポスター、予告編、静止画、人物の写真をダウンロードしないでください。フォルダにドロップするようユーザーに依頼します。画像がない場合、カードはクリーンなタイトルプレースホルダーを表示し、クリップがない場合はスキップされるため、下書きを先にレンダリングできます。各クリップに対して、start(スタジオロゴや黒フレームをスキップ)とdurationを選択します。予告編はYouTubeでContent IDクレームを引き起こす可能性があります。それはチャンネル所有者の判断ですので、一度だけ伝えます。 - ビルド+プレビュー。
python3 scripts/build_countdown.py items.json _work/を実行し、いくつかの瞬間(イントロ約3秒、ランクカード、フルアイテムカードの終了時、アウトロ)をスクリーンショットして確認:オーバーラップがないこと、長いタイトルが収まっていること、360pで数字が読めること。 - レンダリング。
bash scripts/make_countdown.sh items.json out.mp4 [chunks] [-- --music track.mp3 --music-vol 0.5 --voice vo_dir]。 - QA。
out_sheet.pngを開き、items.jsonと数値をスポットチェックし、再生時間を確認し、すべてのランクが1回ずつ出現することを確認します。 - 納品。 MP4、チャプター(
out_chapters.txt。YouTubeの説明欄に貼り付け)、ソースリスト、推奨タイトル/説明/タグ。YouTube Studioでアウトロスロットにエンド画面要素を追加するようユーザーに伝えてください。
items.json スキーマ
以下の値は構造を示すプレースホルダーであり、実際のデータではありません。
{
"title": "ストップモーション映画トップ5",
"subtitle": "全世界興行収入ランキング",
"channel": "チャンネル名",
"currency": "$",
"order": "down",
"mode": "countdown",
"intro_image": "logo.png",
"outro_title": "あなたのお気に入りはどれ?",
"outro_subtitle": "コメントで教えてください!",
"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": "チキンラン", "year": 2000, "subtitle": "ファミリー/コメディ",
"image": "posters/chicken-run.jpg",
"stats": [{"label": "予算", "value": 45000000}, {"label": "興行収入", "value": 225100000}],
"multiple": "予算の5倍",
"ratings": {"imdb": 7.0, "rt": 90, "rt_audience": 75, "metacritic": 80},
"fact": "短い、ソース付きの文。",
"teaser": "No.Xスラムの下の任意の行",
"clip": {"file": "clips/chicken-run-trailer.mp4", "start": "0:12", "duration": 25},
"label": "スラムカードにNo.X/年の代わりに表示する任意テキスト",
"seconds": 9,
"sources": ["https://www.boxofficemojo.com/title/tt0120630/"]
}
]
}
stats[].valueが数値の場合→アニメーションカウントアップ+比較棒グラフ(棒はカードごとに同じスケールを共有);文字列の場合→そのまま表示(例:"N/A"、"8,848 м")。任意のラベルが機能するため、同じエンジンで映画以外のカウントダウン(最も高い建物、最も裕福な人、最速の車)にも対応します。ratingsキーはオプション:imdb(0–10、星)、rt/rt_audience/metacritic(0–100、リング)。欠落したキーは非表示になり;評価がないカードは他のボックスを中央に配置します。clip.startは秒数またはm:ssを受け入れ、クリップは16:9にレターボックス化され、カードの後に再生されます。チャプターとエンド画面のタイミングはクリップ長を自動的に考慮します。intro_image(例:ユーザーが提供するスタジオロゴ)は、イントロの TOP N / EVOLUTION バッジを置き換えます。- タイムラインモードではエントリは
yearでソートされ、カードのランクバッジは非表示になり、チャプターは「タイトル(年)」と表示されます。 multipleはマネーボックスの下の短いハイライトピルです。ソースの数値から計算し(小数点1桁に丸める)。- 評価はテキストラベルのみで表示され、ブランドロゴはありません。
- 画面に表示される評価、数値、豆知識はすべて
sources内のソースに由来している必要があります。
スタイルノート
- デフォルトのテーマはクラシックなリストチャンネルと一致:緑/黄色のクレヨンテクスチャカード、赤い枠、オレンジの「No.X」スラム(光線付き)、紫のマネーボックス、青の評価ボックス。
themeで任意の色を上書きできます。 - 360pでの読みやすさ:タイトルは短く保ち(サブタイトルがジャンルを伝える)、豆知識は2行以内に、統計は4つまでにします。
- 視聴維持:エントリあたり約11秒。最も強いエントリは最後に配置。ランクスラム+ウーッシュ/ヒットSFXが各エントリで視聴者の注意をリセット。イントロは5秒以内に。
- YouTubeチャプターはそれぞれ10秒以上必要なので、イントロは自動的に最初のランクのチャプターに折り込まれます。