Skip to content

usage.md

Latest commit

 

History

History
331 lines (268 loc) · 7.36 KB

usage.md

File metadata and controls

331 lines (268 loc) · 7.36 KB

Usage Examples 🎯

This guide provides practical examples of how to use Auto Clipper in different scenarios.

🤖 AI Mode (Recommended)

Basic Usage

# Analyze any YouTube video and create viral clips
./target/release/auto-clipper "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

Real-world Examples

Music Videos

# Extract catchy moments from music videos
./target/release/auto-clipper "https://www.youtube.com/watch?v=kJQP7kiw5Fk"

Podcasts

# Create highlight clips from podcast episodes
./target/release/auto-clipper "https://www.youtube.com/watch?v=PODCAST_ID"

Educational Content

# Extract key concepts from tutorials
./target/release/auto-clipper "https://www.youtube.com/watch?v=TUTORIAL_ID"

Gaming Content

# Create highlight reels from gaming videos
./target/release/auto-clipper "https://www.youtube.com/watch?v=GAMING_ID"

📝 Manual Mode

Basic Configuration

Create a config.json file:

{
  "input_video": "my_video.mp4",
  "clips": [
    {
      "start": "00:00:30",
      "end": "00:00:45",
      "output": "intro_clip.mp4"
    },
    {
      "start": "00:02:15",
      "end": "00:02:40",
      "output": "highlight_clip.mp4"
    }
  ]
}

Run with configuration:

./target/release/auto-clipper config.json

Advanced Configuration Examples

Precise Timing

{
  "input_video": "presentation.mp4",
  "clips": [
    {
      "start": "00:01:23.500",
      "end": "00:01:38.750",
      "output": "key_point_1.mp4"
    },
    {
      "start": "00:05:42.200",
      "end": "00:06:12.800",
      "output": "key_point_2.mp4"
    }
  ]
}

Multiple Short Clips

{
  "input_video": "long_video.mp4",
  "clips": [
    {
      "start": "00:00:10",
      "end": "00:00:20",
      "output": "teaser_1.mp4"
    },
    {
      "start": "00:01:30",
      "end": "00:01:40",
      "output": "teaser_2.mp4"
    },
    {
      "start": "00:03:45",
      "end": "00:03:55",
      "output": "teaser_3.mp4"
    },
    {
      "start": "00:05:20",
      "end": "00:05:30",
      "output": "teaser_4.mp4"
    }
  ]
}

🎬 Workflow Examples

Content Creator Workflow

  1. Record long-form content
  2. Upload to YouTube (can be unlisted)
  3. Generate clips with AI
./target/release/auto-clipper "https://www.youtube.com/watch?v=YOUR_VIDEO"
  1. Review and select best clips
  2. Share on social media platforms

Marketing Team Workflow

  1. Create product demo video
  2. Use AI to identify key selling points
./target/release/auto-clipper "https://www.youtube.com/watch?v=DEMO_VIDEO"
  1. Generate multiple ad variations
  2. A/B test different clips

Educational Workflow

  1. Record lecture or tutorial
  2. Extract key concepts automatically
./target/release/auto-clipper "https://www.youtube.com/watch?v=LECTURE_ID"
  1. Create study materials
  2. Share bite-sized learning content

📊 Output Analysis

Understanding AI Suggestions

When using AI mode, you'll see output like:

{
  "input_video": "video.mp4",
  "clips": [
    {
      "start": "00:00:07",
      "end": "00:00:22",
      "output": "viral_clip_1.mp4"
    },
    {
      "start": "00:01:15",
      "end": "00:01:30",
      "output": "viral_clip_2.mp4"
    }
  ]
}

What this means:

  • Clip 1: 15-second clip from 7s to 22s mark
  • Clip 2: 15-second clip from 1m15s to 1m30s mark
  • File names: Automatically generated with sequential numbering

Quality Assessment

AI considers these factors when suggesting clips:

  • Engagement potential: Moments likely to capture attention
  • Optimal length: 10-30 seconds for social media
  • Content density: Information-rich segments
  • Visual appeal: Interesting visual elements
  • Audio quality: Clear speech or music

🔧 Advanced Usage

Batch Processing

Process multiple videos:

#!/bin/bash
# batch_process.sh

videos=(
  "https://www.youtube.com/watch?v=VIDEO1"
  "https://www.youtube.com/watch?v=VIDEO2"
  "https://www.youtube.com/watch?v=VIDEO3"
)

for video in "${videos[@]}"; do
  echo "Processing: $video"
  ./target/release/auto-clipper "$video"
  echo "Completed: $video"
  echo "---"
done

Custom Output Directory

# Create output directory
mkdir -p output/clips

# Move generated clips
mv viral_clip_*.mp4 output/clips/

Integration with Other Tools

With FFmpeg for post-processing

# Generate clips
./target/release/auto-clipper "https://www.youtube.com/watch?v=VIDEO_ID"

# Add watermark to all clips
for clip in viral_clip_*.mp4; do
  ffmpeg -i "$clip" -i watermark.png -filter_complex "overlay=10:10" "watermarked_$clip"
done

With social media APIs

# Generate clips
./target/release/auto-clipper "https://www.youtube.com/watch?v=VIDEO_ID"

# Upload to social media (pseudo-code)
for clip in viral_clip_*.mp4; do
  # Upload to Twitter, Instagram, TikTok, etc.
  upload_to_social_media "$clip"
done

📱 Platform-Specific Optimization

TikTok/Instagram Reels (Vertical)

# Generate clips first
./target/release/auto-clipper "https://www.youtube.com/watch?v=VIDEO_ID"

# Convert to vertical format
for clip in viral_clip_*.mp4; do
  ffmpeg -i "$clip" -vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2" "vertical_$clip"
done

Twitter (Square)

# Convert to square format
for clip in viral_clip_*.mp4; do
  ffmpeg -i "$clip" -vf "scale=1080:1080:force_original_aspect_ratio=decrease,pad=1080:1080:(ow-iw)/2:(oh-ih)/2" "square_$clip"
done

YouTube Shorts

# Optimize for YouTube Shorts (vertical, under 60s)
for clip in viral_clip_*.mp4; do
  ffmpeg -i "$clip" -vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2" -t 59 "shorts_$clip"
done

🎯 Best Practices

For Content Creators

  • Test different video types to see what AI identifies as viral
  • Review AI suggestions before publishing
  • Combine multiple clips for variety
  • Add captions for accessibility

For Marketers

  • Focus on product demos and testimonials
  • Extract customer success stories
  • Create multiple versions for A/B testing
  • Optimize for each platform

For Educators

  • Extract key concepts and definitions
  • Create study guides from lectures
  • Generate quiz content from explanations
  • Share bite-sized learning

🚨 Common Pitfalls

Avoid These Mistakes

  • Don't use copyrighted content without permission
  • Check video quality before processing
  • Verify audio sync in output clips
  • Test on target platform before mass distribution

Quality Checks

# Check clip duration
ffprobe -v quiet -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 viral_clip_1.mp4

# Check video resolution
ffprobe -v quiet -select_streams v:0 -show_entries stream=width,height -of csv=s=x:p=0 viral_clip_1.mp4

📈 Performance Tips

Optimize Processing Speed

  • Use SSD storage for faster I/O
  • Ensure stable internet for downloads
  • Close unnecessary applications during processing
  • Use release build for production

Monitor Resource Usage

# Monitor during processing
htop  # or top on macOS

Next Steps: Learn about Configuration options to customize Auto Clipper for your specific needs.