Skip to content

Add video_contact_sheet – automated key-frame contact sheets #425

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
libran11 opened this issue May 13, 2025 · 0 comments
Open

Add video_contact_sheet – automated key-frame contact sheets #425

libran11 opened this issue May 13, 2025 · 0 comments

Comments

@libran11
Copy link

Summary

Proposal to add a new script advanced_tools/video_contact_sheet/ that
bulk-generates contact-sheet thumbnails for videos.
It extracts scene-representative frames, composes them into a grid, and
overlays basic metadata.

Why it’s valuable

  • Fast visual QA for large video datasets / courseware / surveillance footage.
  • No existing script in repo covers multimedia summarization.

Key features

  • Scene-change detection via HSV histogram diff (OpenCV).
  • Multithreaded processing; ~8× realtime on 8-core CPU.
  • CLI flags: --max-frames, --cols, --scene-thresh, --threads.
  • Output JPEG contact sheet with footer: duration, resolution, codec.
  • Fully tested with pytest (auto-generated sample video).

Request

Feedback on default thresholds and whether to ship an HTML viewer variant.
If accepted, see accompanying PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant