Edit

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/SamurAIGPT/AI-Youtube-Shorts-Generator/llms.txt

Use this file to discover all available pages before exploring further.

​

Functions

​

extractAudio

extractAudio(video_path: str, audio_path: str = "audio.wav") -> str | None

​

Features

• Format: Outputs WAV format for maximum compatibility
• Quality: Preserves original audio quality
• Error Handling: Returns None on failure with error message
• Automatic Cleanup: Properly closes video clip after extraction

from Components.Edit import extractAudio

# Extract audio with default filename
audio_file = extractAudio("video.mp4")
if audio_file:
    print(f"Audio extracted to: {audio_file}")
    # Output: Extracted audio to: audio.wav
else:
    print("Audio extraction failed")

​

Error Handling

audio_path = extractAudio("video.mp4")

if audio_path is None:
    print("Failed to extract audio")
    # Possible causes:
    # - Video file not found
    # - Video has no audio track
    # - Insufficient permissions
    # - Corrupted video file

​

crop_video

crop_video(input_file: str, output_file: str, 
           start_time: float, end_time: float) -> None

​

Features

• Precise Timing: Supports fractional seconds (e.g., 31.92)
• Safety Checks: Automatically caps end time to video duration
• Quality Preservation: Uses libx264 codec for high quality
• Audio Included: Preserves audio track in the segment

from Components.Edit import crop_video

# Extract 2-minute segment
crop_video(
    input_file="full_video.mp4",
    output_file="highlight.mp4",
    start_time=45.5,
    end_time=165.5
)

# Output: Creates highlight.mp4 with 120-second segment

​

Automatic Duration Capping

with VideoFileClip(input_file) as video:
    # Ensure end_time doesn't exceed video duration
    max_time = video.duration - 0.1  # 0.1s buffer for safety
    if end_time > max_time:
        print(f"Warning: Requested end time ({end_time}s) exceeds " +
              f"video duration ({video.duration}s). Capping to {max_time}s")
        end_time = max_time
    
    cropped_video = video.subclip(start_time, end_time)

• Video duration: 300 seconds
• Requested: crop_video("video.mp4", "out.mp4", 250, 350)
• Result: Crops from 250s to 299.9s (capped)
• Console: Warning: Requested end time (350s) exceeds video duration (300s). Capping to 299.9s

​

Output Specifications

​

extractAudio

• Format: WAV (Waveform Audio File Format)
• Channels: Preserves original (mono/stereo)
• Sample Rate: Preserves original
• Bit Depth: Preserves original

​

crop_video

• Video Codec: libx264 (H.264)
• Audio Codec: Preserves original (typically AAC or MP3)
• FPS: Preserves original frame rate
• Resolution: Preserves original dimensions
• Quality: High quality (lossless where possible)

​

Timing Examples

# Precise decimal timing
crop_video("video.mp4", "segment.mp4", 31.92, 49.2)

# Whole seconds
crop_video("video.mp4", "segment.mp4", 30, 60)

# From start of video
crop_video("video.mp4", "intro.mp4", 0, 10)

# Last 30 seconds (if video is 300s long)
crop_video("video.mp4", "outro.mp4", 270, 300)

​

Use Cases

# Extract AI-selected highlight
transcriptions = transcribeAudio(audio)
TransText = "\n".join([f"{s} - {e}: {t}" 
                       for t, s, e in transcriptions])
start, end = GetHighlight(TransText)
crop_video(video_path, "highlight.mp4", start, end)

# Split video into chapters
chapters = [
    (0, 120, "chapter1.mp4"),
    (120, 300, "chapter2.mp4"),
    (300, 480, "chapter3.mp4")
]

for start, end, filename in chapters:
    crop_video("full_video.mp4", filename, start, end)

# Remove 10s intro and 15s outro
from moviepy.editor import VideoFileClip

with VideoFileClip("video.mp4") as video:
    duration = video.duration

crop_video("video.mp4", "main_content.mp4", 
           10, duration - 15)

​

Error Handling

try:
    audio = extractAudio("video.mp4")
    if audio is None:
        raise ValueError("Audio extraction failed")
    
    crop_video("video.mp4", "segment.mp4", 30, 90)
except FileNotFoundError:
    print("Video file not found")
except Exception as e:
    print(f"Error: {e}")

• File not found: Invalid input path
• No audio track: Video has no audio
• Invalid time range: start_time >= end_time
• Corrupted video: Unable to read video file

​

Performance Tips

1. Audio Extraction: Fast (~5-10s for a 10-minute video)
2. Video Cropping: Depends on segment length and codec
   • 2-minute segment: ~30-60 seconds
   • Longer segments: Proportionally longer
3. Memory Usage: Loads entire segment into memory
   • Recommend ≤5 minute segments at a time
4. Concurrent Processing: Use unique filenames (see main.py example)

​

Concurrent Execution Support

import uuid

# Generate unique session ID
session_id = str(uuid.uuid4())[:8]

# Use unique filenames
audio_file = f"audio_{session_id}.wav"
temp_clip = f"clip_{session_id}.mp4"

extractAudio(video_path, audio_file)
crop_video(video_path, temp_clip, start, end)

# Clean up when done
import os
os.remove(audio_file)
os.remove(temp_clip)