YouTube動画フレーム抽出ツールレポート

導入

動画コンテンツの急増に伴い、効率的な視覚的要約ツールの需要が高まっています。本ツールは、YouTube動画から一定間隔でフレームを抽出し、それらを単一の画像にまとめることで、動画の内容を一目で把握できるようにします。

主な活用シーン

コンテンツ分析: クリエイターやマーケターが動画の構成や視覚的一貫性を分析
教育用資料: 授業や講演の重要な瞬間を捉えた視覚的サマリーの作成
映像研究: 映画やアニメーションの色彩パレット、シーン遷移、構図の変化の研究
タイムラプス観察: 自然現象や建設プロジェクトなどの経時変化の視覚化
ストーリーボード作成: 既存動画からストーリーボードのベースとなる画像の抽出
プレゼンテーション: 動画コンテンツを静止画として効果的に資料に組み込む

本ツールはGoogle Colaboratory上で動作し、プログラミングの詳細な知識がなくても、数クリックで簡単に使用できることが特徴です。

概要

このレポートでは、YouTube動画から特定の間隔でフレームを抽出し、それらを横に並べて単一の画像として出力するPythonツールについて説明します。このツールはGoogle Colaboratory環境での使用を想定しており、簡単な設定で動画の視覚的な要約を作成することができます。

主な機能

YouTube動画のダウンロード（yt-dlpを使用）
指定した間隔でのフレーム抽出
抽出したフレームを横に並べた一枚の画像生成
結果画像のダウンロード

使用技術

yt-dlp: YouTube動画のダウンロード
OpenCV (cv2): 動画処理とフレーム抽出
PIL (Python Imaging Library): 画像結合と保存
NumPy: 画像データの配列操作

実装詳細

セットアップ

# @title セットアップ { display-mode: "form" }
# @markdown 必要なライブラリのインストール
!pip install yt-dlp opencv-python-headless

設定パラメータ

# --- 設定 ---
youtube_url = "任意のYouTube URL"
output_image_path = "output_frames.png"
temp_video_path = "temp_video.mp4"
frame_interval = 30  # 何フレームごとに抽出するか (1秒あたり約30フレームなら、30で約1秒ごと)

必要なライブラリのインポート

import yt_dlp
import cv2
import numpy as np
from PIL import Image
import os

YouTube動画のダウンロード

# --- yt-dlp のオプション設定 ---
ydl_opts = {
    'format': 'bestvideo[ext=mp4]/best[ext=mp4]/best', # 音声なしでOK
    'outtmpl': temp_video_path,
    'noplaylist': True,
}

# --- YouTube動画のダウンロード ---
try:
    with yt_dlp.YoutubeDL(ydl_opts) as ydl:
        ydl.download([youtube_url])
except yt_dlp.utils.DownloadError as e:
    print(f"ダウンロードエラー: {e}")
    exit()

フレーム抽出プロセス

# --- 動画の読み込み ---
cap = cv2.VideoCapture(temp_video_path)
if not cap.isOpened():
    print("動画ファイルを開けませんでした")
    exit()

# --- フレームの抽出と結合 ---
frame_count = 0
all_frames = []  # 抽出したフレームを一時的に保存するリスト
while True:
    ret, frame = cap.read()
    if not ret:
        break  # フレームがなくなったら終了
    frame_count += 1
    # 指定した間隔でフレームを抽出
    if frame_count % frame_interval == 0:
        all_frames.append(cv2.cvtColor(frame, cv2.COLOR_BGR2RGB)) # OpenCV -> PIL互換形式

cap.release()
os.remove(temp_video_path)  # 一時動画ファイルは削除

画像結合処理

# --- 画像の結合 (横に並べる) ---
if not all_frames:
    print("フレームが抽出されませんでした")
    exit()

# 最初のフレームから、サイズを取得
frame_height = all_frames[0].shape[0]
frame_width = all_frames[0].shape[1]

# 全体の画像のサイズを計算
total_width = frame_width * len(all_frames)
total_height = frame_height

# 新しい画像を作成
final_image = Image.new("RGB", (total_width, total_height))

# 各フレームを貼り付け
x_offset = 0
for frame_array in all_frames:
  frame_img = Image.fromarray(frame_array)
  final_image.paste(frame_img, (x_offset, 0))
  x_offset += frame_width

# --- 画像の保存 ---
final_image.save(output_image_path)
print(f"画像を {output_image_path} に保存しました。")

画像のダウンロード（Colab専用機能）

# --- ダウンロード (Colab用) ---
# @markdown 生成された画像をダウンロードします。
from google.colab import files
files.download(output_image_path)

使用方法

Google Colaboratoryでノートブックを開く
上記のコードをセルに貼り付ける
必要に応じて設定パラメータを変更する
- youtube_url: 処理したいYouTube動画のURL
- frame_interval: フレームの抽出間隔（数値が小さいほど多くのフレームが抽出され、結果画像が大きくなる）
セルを実行する
処理完了後、生成された画像が自動的にダウンロードされる

注意点

抽出するフレーム数が多い場合、生成される画像のサイズが非常に大きくなる可能性があります
動画の長さやフレームレートによっては処理に時間がかかる場合があります
YouTubeの利用規約に準拠した使用を心がけてください

今後の改善点

画像サイズの調整機能の追加
フレーム間の時間表示の追加
グリッドレイアウト（複数行）での表示オプション
抽出するフレーム数の上限設定

YouTube動画フレーム抽出ツール

YouTube動画フレーム抽出ツール レポート

導入