git-subtree-dir: vendor/dumas_h3_refmod_picker git-subtree-split: c732f8b8893bf4f00c6974c9b9941c763496fe48
138 lines
3.9 KiB
Python
138 lines
3.9 KiB
Python
"""Generate random PNG thumbnails for MP4 files in a directory.
|
|
|
|
Each thumbnail is extracted at full frame resolution from a random point
|
|
between 25% and 75% of the video's duration, then saved beside the source MP4
|
|
with the same basename and a `.png` extension.
|
|
|
|
Rerun the script to regenerate different thumbnails.
|
|
|
|
Usage:
|
|
python3 generate_video_thumbnails.py /path/to/folder
|
|
python3 generate_video_thumbnails.py /path/to/folder --seed 1234
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import argparse
|
|
import random
|
|
import subprocess # nosec B404
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
|
|
def _probe_duration(path: Path) -> float:
|
|
cmd = [
|
|
"ffprobe",
|
|
"-v",
|
|
"error",
|
|
"-show_entries",
|
|
"format=duration",
|
|
"-of",
|
|
"default=noprint_wrappers=1:nokey=1",
|
|
str(path),
|
|
]
|
|
result = subprocess.run(cmd, capture_output=True, text=True, check=True) # nosec B603
|
|
value = (result.stdout or "").strip()
|
|
if not value:
|
|
raise ValueError(f"Could not read duration for {path}")
|
|
duration = float(value)
|
|
if duration <= 0.0:
|
|
raise ValueError(f"Invalid duration for {path}: {duration}")
|
|
return duration
|
|
|
|
|
|
def _pick_timestamp(duration: float, rng: random.Random) -> float:
|
|
if duration <= 0.0:
|
|
return 0.0
|
|
start = duration * 0.25
|
|
end = duration * 0.75
|
|
if end <= start:
|
|
return duration * 0.5
|
|
return rng.uniform(start, end)
|
|
|
|
|
|
def _render_thumbnail(video_path: Path, timestamp: float) -> Path:
|
|
output_path = video_path.with_suffix(".png")
|
|
cmd = [
|
|
"ffmpeg",
|
|
"-y",
|
|
"-ss",
|
|
f"{timestamp:.6f}",
|
|
"-i",
|
|
str(video_path),
|
|
"-frames:v",
|
|
"1",
|
|
"-update",
|
|
"1",
|
|
str(output_path),
|
|
]
|
|
subprocess.run(cmd, check=True, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) # nosec B603
|
|
return output_path
|
|
|
|
|
|
def _iter_mp4s(folder: Path) -> list[Path]:
|
|
return sorted(
|
|
path for path in folder.iterdir()
|
|
if path.is_file() and path.suffix.lower() == ".mp4"
|
|
)
|
|
|
|
|
|
def _resolve_folder(folder_arg: str | None) -> Path:
|
|
folder_text = folder_arg
|
|
if not folder_text:
|
|
try:
|
|
folder_text = input("Folder containing MP4 files: ").strip()
|
|
except EOFError:
|
|
folder_text = ""
|
|
if not folder_text:
|
|
raise ValueError("No folder provided.")
|
|
return Path(folder_text).expanduser().resolve()
|
|
|
|
|
|
def main() -> int:
|
|
parser = argparse.ArgumentParser(
|
|
description=(
|
|
"Generate a random full-resolution PNG thumbnail for every MP4 in a folder. "
|
|
"The capture time is chosen between 25% and 75% of each video's duration."
|
|
)
|
|
)
|
|
parser.add_argument("folder", nargs="?", help="Folder containing MP4 files.")
|
|
parser.add_argument(
|
|
"--seed",
|
|
type=int,
|
|
default=None,
|
|
help="Optional random seed for repeatable thumbnail choices.",
|
|
)
|
|
args = parser.parse_args()
|
|
|
|
try:
|
|
folder = _resolve_folder(args.folder)
|
|
except ValueError as exc:
|
|
print(str(exc), file=sys.stderr)
|
|
return 1
|
|
if not folder.is_dir():
|
|
print(f"Folder not found: {folder}", file=sys.stderr)
|
|
return 1
|
|
|
|
rng = random.Random(args.seed)
|
|
videos = _iter_mp4s(folder)
|
|
if not videos:
|
|
print(f"No MP4 files found in {folder}", file=sys.stderr)
|
|
return 1
|
|
|
|
failures = 0
|
|
for video_path in videos:
|
|
try:
|
|
duration = _probe_duration(video_path)
|
|
timestamp = _pick_timestamp(duration, rng)
|
|
output_path = _render_thumbnail(video_path, timestamp)
|
|
print(f"{video_path.name} -> {output_path.name} at {timestamp:.2f}s / {duration:.2f}s")
|
|
except Exception as exc:
|
|
failures += 1
|
|
print(f"Failed: {video_path.name}: {exc}", file=sys.stderr)
|
|
|
|
return 1 if failures else 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
raise SystemExit(main()) |