YouTubeチャプターの概要欄を自動作成する──台本データと音声の実尺から計算する考え方

YouTubeの概要欄に書くチャプター（タイムスタンプ＋章名の一覧）は、動画を台本や章立てといった構成データから作っているなら、手で書く必要がありません。各章の音声ファイルの長さをffprobe（メディアファイルの情報を調べるコマンドラインツール）で実測し、順番に足し合わせれば、「0:00 章名」形式の一覧を機械的に出力できます。この記事では、その考え方と、YouTube公式のチャプター表示条件、そして「推定ではなく実測」でなければいけない理由を整理します。

• チャプターの開始時刻は「前の章までの音声の実尺の合計」なので、構成データがあれば計算で出せる
• 尺は必ずffprobeなどで実測する。音声合成の長さは文字数から正確には予測できない
• YouTube側の表示条件は「最初が0:00・3つ以上・昇順・各チャプター10秒以上」（公式ヘルプ）

YouTubeのチャプターはどんな仕組みで表示されるのか

チャプターは、概要欄にタイムスタンプと章名を書くだけで動画プレーヤーに反映されます。YouTube公式ヘルプによると、表示には条件があります。最初のタイムスタンプが0:00で始まっていること、タイムスタンプが3つ以上昇順で並んでいること、各チャプターが10秒以上あることです。

つまりYouTube側に特別な設定画面があるわけではなく、「正しい形式のテキストを概要欄に置く」ことがすべてです。逆に言えば、このテキストをどう用意するかが自動化の対象になります。なおYouTubeには動画から自動でチャプターを付ける機能もありますが、すべての動画に付くわけではない、と公式ヘルプに明記されています。確実に出したいなら自分で用意するのが基本です。

チャプターを自動で用意する方法は大きく2つある

A案：完成した動画から起こす。 文字起こしやAIツールで動画の内容を解析し、章の切れ目を推定させる方法です。カメラで撮った動画や過去の動画にも使える一方、章の切れ目や章名が意図通りになるかは都度確認が必要です。

B案：制作データから計算する。 動画そのものを台本・章立てのデータから生成しているなら、チャプターは「解析」するまでもなく「計算」で出せます。この記事の主題はこちらです。撮って出しの動画には使えませんが、条件が合えば原理的に正確です。

どちらが良いかは制作スタイル次第で、撮影ベースの人はA案、生成パイプラインを持つ人はB案が素直な選択です。

「音声の実尺から計算する」とはどういうことか

動画が「章1の音声→章2の音声→…」という連結でできているなら、ある章の開始時刻は、それより前の章の音声の長さをすべて足したものです。各音声ファイルの長さはffprobeで実測できます。

ffprobe -v error -show_entries format=duration -of csv=p=0 chapter01.wav

このコマンドは音声の秒数を返します。章ごとに実行して累積し、分:秒の形式に整形して章名と並べれば、概要欄にそのまま貼れる一覧が完成します。

0:00 オープニング
1:23 チャプター機能の仕組み
3:45 自動化の考え方

台本データに章名がすでに入っていれば、章名の転記すら不要です。動画自体を台本から自動生成する流れについては、ずんだもん動画の自動化の記事でも紹介しています。

なぜ推定値ではなく実測が必要なのか

「文字数から尺を見積もれば、音声を測らなくてもいいのでは」と考えたくなりますが、これは避けるべきです。音声合成の尺は、話す速さ、句読点の間、記号や数字の読み方などで変わるため、文字数からは正確に予測できません。章が進むほど誤差が積み重なり、後半のチャプターほど実際の映像とずれていきます。

ずれたチャプターは視聴者にとって「押しても目的の場所に飛ばない目次」であり、無い方がましな状態になりかねません。生成に使った音声ファイルそのものをffprobeで測る、つまり見積もりではなく実物を測ることが、この自動化の信頼性を支えています。

筆者の現場から

私のチャンネルでは、概要欄のチャプターは毎回スクリプトが音声の実測値から自動生成しています。動画を再生しながら手で時刻をメモする、という作業そのものをやめられました。台本から動画を作るパイプラインの副産物として、チャプターが常に付いてくる形です。

正直な但し書き

• B案（実尺からの計算）は、動画を構成データから生成している場合にしか使えません。カメラで撮影した動画には適用できないので、その場合はA案や手作業になります。
• 章と章の間に無音や転換演出を挟む構成なら、その分の秒数も加算する必要があります。パイプラインの作りに依存する部分です。
• チャプターの表示条件や自動チャプター機能の挙動はYouTube側の仕様であり、変更される可能性があります。最新の条件は公式ヘルプで確認してください。
• ffprobeの導入方法はOSにより異なります。この記事はコマンドの網羅的な解説ではなく、考え方の紹介です。

出典

• 動画チャプター - YouTube ヘルプ
• ffprobe Documentation - FFmpeg