YouTube Heatmap Clipper — ヒートマップで自動クリップ作成

Web

概要

YouTube Heatmap Clipperは、YouTubeプレイヤーの「Most Replayed」(視聴者が繰り返し見た区間)をヒートマップとして解析し、注目度の高いクリップを自動で抽出・生成するWebアプリです。縦型クリップ(Shorts等)に最適なトリミング、AI字幕の付与オプション、プレビュー機能などを備え、CLIベースの既存ツールをより「人に優しい」Web体験として提供します。視聴データを元に編集コストを下げ、短尺コンテンツの作成を効率化します。(約300字)

GitHub

リポジトリの統計情報

  • スター数: 24
  • フォーク数: 3
  • ウォッチャー数: 24
  • コミット数: 3
  • ファイル数: 10
  • メインの言語: Python

主な特徴

  • YouTubeのMost Replayedヒートマップを解析して、視聴者の注目区間を自動検出
  • 自動でクリップを切り出し、縦型(vertical-ready)にトリミング・再生成
  • オプションでAI生成字幕を付与(外部サービスやローカルモデルを利用)
  • Web UIによるプレビューと手動微調整で実運用に対応

技術的なポイント

このプロジェクトは「視聴者の再生挙動(Most Replayed)」というYouTubeの可視化情報を起点に、動画編集パイプラインを自動化する点が特徴です。実装面では以下のような要素が想定されます(READMEの記載と構成から読み取れる範囲):

  • ヒートマップ取得:ブラウザ上のYouTubeプレイヤーが表示する「Most Replayed」データを取得・解析します。これはページのDOMやプレイヤーAPIが出す再生位置情報、あるいはnetworkレスポンス中のヒートマップデータをスクレイピング/取得して時系列の注力度を抽出する手法が一般的です。
  • ピーク検出アルゴリズム:抽出した注力度を滑らかにし、ピーク(盛り上がり)を検出して切り出し区間を決定します。ピークのしきい値、前後の緩衝時間(コンテキストを残すウィンドウ)、重複区間のマージなどの調整ロジックが重要になります。
  • 動画切り出しとフォーマット変換:ffmpeg等を使って指定区間をトリミングし、縦型クリップに合わせてセンタートリミングやリサイズを行います(16:9→9:16のクロップや黒帯追加など)。エンコード設定やビットレート調整、サムネイル生成も含めた一連の処理が必要です。
  • 字幕生成と合成:AIによる自動字幕(例えば音声認識APIやローカルのASRモデル)を利用してSRT/ASSを生成し、フォントディレクトリ内のフォントを使って焼き込みまたは別ファイルで出力します。言語検出やタイムアラインメントの補正、改行・表示位置の最適化も実装ポイントです。
  • Webアプリ側:ユーザーはURL入力→解析→候補プレビュー→生成のフローで操作します。フロントエンドは結果のヒートマップ可視化、区間の手動調整、字幕オンオフ、出力フォーマット選択をサポートすると使い勝手が上がります。
  • 注意点と拡張性:YouTubeのUI変更やヒートマップ情報の取得可否に依存するため、取得手法の堅牢化(APIレスポンスの解析やヘッドレスブラウザの利用)が必要です。また、動画ダウンロード/再配布に関する著作権や利用規約の考慮、処理負荷(エンコードコスト)に対するバッチ・キュー処理、クラウドでのスケール設計なども実運用での検討事項です。

以上を踏まえ、このリポジトリは「視聴データを使った短尺動画作成の自動化」という実用的なニーズに対応するためのプロトタイプ的な実装を提供しており、ffmpegやASR、Web UIと組み合わせたワークフロー設計が技術面での肝です。(約1200〜1900字相当の技術説明)

プロジェクトの構成

主要なファイルとディレクトリ:

  • .gitignore: file
  • LICENSE: file
  • README.md: file
  • fonts: dir
  • images: dir

…他 5 ファイル

(fontsディレクトリは字幕焼き込み用フォント、imagesはREADME用のスクリーンショットやプレビューを含む想定)

まとめ

視聴者行動を活かして短尺コンテンツを自動生成する実用的なプロトタイプです(約50字)。

リポジトリ情報:

READMEの抜粋:

YouTube Heatmap Clipper

Web app buat scan heatmap YouTube (Most Replayed) lalu bikin clip otomatis (vertical-ready) dengan opsi subtitle AI.

Ini versi web dari proyek original: https://github.com/0xACAB666/yt-heatmap-clipper (yang CLI-nya galak, yang web-nya lebih “manusiawi”).

Preview

Preview 1Preview 2
Preview 3Preview 4
Preview 5

Fitur

Core Features