Skip to content
Back to search

stream-auto-clipper

Automated highlight detection, vertical video synthesis, and thumbnail generator for stream VODs.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jvstin47--stream-auto-clipper/badge.svg)](/listings/jvstin47--stream-auto-clipper)

HTML

<a href="/listings/jvstin47--stream-auto-clipper"><img src="/api/listings/jvstin47--stream-auto-clipper/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# 1. Install dependencies
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# 2. Configure settings
cp config.example.json config.json

# 3. Run clipper
python stream_clipper.py --file input.mp4 --count 5

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 50 lines
  1. # stream-auto-clipper
  2. An automated pipeline and agent skill for generating vertical short-form video highlights from live streams and long-form video files.
  3. ## Features
  4. - **Multimodal Peak Detection**: Combines audio loudness analysis with computer vision frame motion variance to find peak action moments.
  5. - **Dynamic Clip Durations**: Adjusts clip lengths between 30 and 75 seconds depending on action continuity.
  6. - **Vertical 9:16 Video Synthesis**:
  7. - Stacked layout: Streamer facecam cropped to the top third, gameplay tracking on the bottom two thirds.
  8. - Landscape fit: Center gameplay with dynamically blurred background padding.
  9. - Smooth audio mixing with background music ducking.
  10. - **Thumbnail Generation**: Automated cover frame extraction with color grading, bold typography, and safe zone constraints for mobile social platforms.
  11. - **Social Media Publishing**: Multi-platform publishing support via social media APIs.
  12. ## Quick Start
  13. ```bash
  14. # 1. Install dependencies
  15. python3 -m venv .venv
  16. source .venv/bin/activate
  17. pip install -r requirements.txt
  18. # 2. Configure settings
  19. cp config.example.json config.json
  20. # 3. Run clipper
  21. python stream_clipper.py --file input.mp4 --count 5
  22. ```
  23. ## Repository Structure
  24. - `stream_clipper.py`: Main highlight detection and video synthesis script.
  25. - `thumbnail_engine.py`: Standalone thumbnail generation tool.
  26. - `zernio_publish.py`: Cross-platform publishing integration.
  27. - `clipper_config.py`: Configuration schema and loader.
  28. - `skills/stream-auto-clipper/`: Agent skill instructions.
  29. ## Acknowledgements & Credits
  30. This project builds upon ideas and techniques explored in several open-source projects:
  31. - **[GTA-Auto-Clipper](https://github.com/AnIntellectualBeing/GTA-Auto-Clipper)** by AnIntellectualBeing: Live stream ingest pipelines and initial audio chunking architectures.
  32. - **[neonclipping](https://github.com/iamajmeena/neonclipping)** by iamajmeena: Stacked vertical video layout patterns and corner facecam detection techniques.
  33. - **[youtube-instagram-auto-uploader](https://github.com/Abhinavkumar-07/youtube-instagram-auto-uploader)** by Abhinavkumar-07: Reference patterns for cross-platform social media dispatch.
  34. - **[OpenCV Model Zoo](https://github.com/opencv/opencv_zoo)**: The lightweight YuNet ONNX face detection model.
  35. ## License
  36. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.