Welcome to the comprehensive documentation for Auto Clipper - an intelligent video clipper powered by Gemini AI.
- Installation Guide - Step-by-step installation instructions
- Usage Examples - Practical examples and use cases
- Configuration - Configuration options and settings
- API Reference - Technical API documentation
- Development Guide - Guide for contributors and developers
- New to Auto Clipper? Start with Installation Guide
- Want to see examples? Check Usage Examples
- Need to configure settings? See Configuration
- Want to contribute? Read Development Guide
- Need API details? Check API Reference
- Contributing guidelines? See ../CONTRIBUTING.md
Auto Clipper is a powerful Rust-based tool that automatically creates viral-worthy video clips from YouTube videos using AI analysis. It combines:
- Gemini AI for intelligent content analysis
- FFmpeg for high-performance video processing
- yt-dlp for seamless YouTube integration
- Rust for maximum performance and reliability
- Automatically identifies viral-worthy moments
- Suggests optimal clip durations (10-30 seconds)
- Analyzes content for social media engagement
- Direct URL processing
- Automatic video download
- Quality optimization
- Built with Rust for speed
- Stream copying for fast processing
- Parallel clip generation
- JSON-based configuration
- Environment variable support
- Flexible timestamp formats
graph LR
A[YouTube URL] --> B[Download Video]
B --> C[AI Analysis]
C --> D[Generate Clips]
D --> E[Viral Content]
- Input: Provide YouTube URL or manual configuration
- Analysis: Gemini AI analyzes video content
- Processing: FFmpeg creates optimized clips
- Output: Ready-to-share viral clips
- OS: Linux, macOS, or Windows
- Rust: 1.75.0 or higher
- Memory: 2GB RAM
- Storage: 1GB free space
- OS: Ubuntu 20.04+ or equivalent
- Rust: Latest stable version
- Memory: 4GB RAM
- Storage: 5GB free space
- Network: Stable internet connection
- FFmpeg: Video processing engine
- yt-dlp: YouTube download utility
- curl: HTTP client for API calls
- serde: JSON serialization
- tokio: Async runtime
- dotenv: Environment variables
| Operation | Typical Time | Notes |
|---|---|---|
| Video Download | 10-30s | Depends on video size |
| AI Analysis | 3-5s | Gemini API response |
| Clip Generation | 1-3s per clip | Stream copy mode |
| Total Process | 20-60s | For 3-5 minute video |
- Extract highlights from long-form content
- Create social media teasers
- Generate promotional clips
- Create engaging video ads
- Extract key moments from presentations
- Generate social media content
- Create lesson highlights
- Extract key concepts
- Generate study materials
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Contributing: Contributing Guide
Next Steps: Start with the Installation Guide to get Auto Clipper running on your system.