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

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

• チャプターの開始時刻は「前の章までの音声の実尺の合計」なので、構成データがあれば計算で出せる
• 尺は必ずffprobeなどで実測する。音声合成の長さは文字数から正確には予測できない（ffmpegの罠は出力ファイル名より後ろに書いたオプションが無視される事故も参照）
• YouTube側の表示条件は「最初が00:00・3つ以上・昇順・各チャプター10秒以上」（公式ヘルプ）

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

チャプターは、概要欄にタイムスタンプと章名を書くだけで動画プレーヤーに反映されます。YouTube公式ヘルプによると、表示には条件があります。最初のタイムスタンプが00: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

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

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

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

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

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

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

自分のチャンネルでの運用

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

この方法が使えない場合と前提条件

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

確認に使った一次資料

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