garroshub/MixCut-Skill / skills
youtube-clipper
VerifiedYouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。 使用场景:当用户需要剪辑 YouTube 视频、生成短视频片段、制作双语字幕版本时。 关键词:视频剪辑、YouTube、字幕翻译、双语字幕、视频下载、clip video
| File | Kind | Size |
|---|---|---|
| .env.example | other | 2.8 KB |
| .github/REPOSITORY_SETTINGS.md | markdown | 1.4 KB |
| .gitignore | other | 372 B |
| FIXES_AND_IMPROVEMENTS.md | markdown | 8.0 KB |
| LICENSE | other | 1.0 KB |
| README.md | markdown | 8.4 KB |
| README.zh-CN.md | markdown | 7.8 KB |
| SKILL.md | skill md | 10.6 KB |
| TECHNICAL_NOTES.md | markdown | 11.3 KB |
| install_as_skill.sh | script | 6.8 KB |
| references/ffmpeg-guide.md | markdown | 3.4 KB |
| references/subtitle-formatting.md | markdown | 7.7 KB |
| references/yt-dlp-guide.md | markdown | 6.3 KB |
| scripts/__init__.py | script | 128 B |
| scripts/analyze_subtitles.py | script | 8.2 KB |
| scripts/burn_subtitles.py | script | 8.5 KB |
| scripts/clip_video.py | script | 7.4 KB |
| scripts/download_video.py | script | 6.6 KB |
| scripts/extract_subtitle_clip.py | script | 3.6 KB |
| scripts/generate_summary.py | script | 6.1 KB |
| scripts/merge_bilingual_subtitles.py | script | 2.2 KB |
| scripts/translate_subtitles.py | script | 6.9 KB |
| scripts/utils.py | script | 8.0 KB |
scripts/clip_video.py
View on GitHub#!/usr/bin/env python3
"""
Clip video segments.
Uses FFmpeg to accurately clip video segments while maintaining original quality.
"""
import sys
import shutil
import subprocess
from pathlib import Path
from typing import Union
from utils import (
time_to_seconds,
seconds_to_time,
format_file_size,
get_video_duration_display,
)
def clip_video(
video_path: str,
start_time: Union[str, float],
end_time: Union[str, float],
output_path: str,
ffmpeg_path: str = None,
) -> str:
"""
Clip video segment.
Args:
video_path: Input video path
start_time: Start time (seconds or time string like "00:01:30")
end_time: End time (seconds or time string)
output_path: Output video path
ffmpeg_path: Path to FFmpeg executable (optional)
Returns:
str: Path to output video
Raises:
FileNotFoundError: Input file missing
RuntimeError: FFmpeg execution failed
"""
video_path = Path(video_path)
output_path = Path(output_path)
# Validate input file
if not video_path.exists():
raise FileNotFoundError(f"Video file not found: {video_path}")
# Convert time to seconds
if isinstance(start_time, str):
start_seconds = time_to_seconds(start_time)
else:
start_seconds = float(start_time)
if isinstance(end_time, str):
end_seconds = time_to_seconds(end_time)
else:
end_seconds = float(end_time)
# Validate time range
if start_seconds >= end_seconds:
raise ValueError(
f"Start time ({start_seconds}s) must be before end time ({end_seconds}s)"
)
duration = end_seconds - start_seconds
# Detect FFmpeg
if ffmpeg_path is None:
ffmpeg_path = shutil.which("ffmpeg")
if not ffmpeg_path:
raise RuntimeError("FFmpeg not found. Please install FFmpeg.")
print(f"\nINFO: Clipping video segment...")
print(f"INFO: Input: {video_path.name}")
print(f"INFO: Start: {seconds_to_time(start_seconds)} ({start_seconds}s)")
print(f"INFO: End: {seconds_to_time(end_seconds)} ({end_seconds}s)")
print(f"INFO: Duration: {get_video_duration_display(duration)}")
print(f"INFO: Output: {output_path.name}")
# Create output directory
output_path.parent.mkdir(parents=True, exist_ok=True)
# Build FFmpeg command
# Use -ss and -t for accurate clipping
# -c copy: Direct stream copy, no re-encoding (fast and lossless)
cmd = [
ffmpeg_path,
"-ss",
str(start_seconds), # Start time
"-i",
str(video_path), # Input file
"-t",
str(duration), # Duration
"-c",
"copy", # Direct copy, no re-encoding
"-y", # Overwrite output
str(output_path),
]
print(f"INFO: Running FFmpeg...")
# Run FFmpeg
result = subprocess.run(cmd, capture_output=True, text=True)
if result.returncode != 0:
print(f"\nERROR: FFmpeg failed:")
print(result.stderr)
raise RuntimeError(f"FFmpeg failed with return code {result.returncode}")
# Verify output file
if not output_path.exists():
raise RuntimeError("Output file not created")
# Get file size
output_size = output_path.stat().st_size
print(f"DONE: Clipping complete")
print(f"INFO: Output file: {output_path}")
print(f"INFO: File size: {format_file_size(output_size)}")
return str(output_path)
def extract_subtitle_segment(
subtitles: list, start_time: float, end_time: float, adjust_timestamps: bool = True
) -> list:
"""
Extract subtitles for a specific time segment.
Args:
subtitles: Complete list of subtitles (each {start, end, text})
start_time: Start time (seconds)
end_time: End time (seconds)
adjust_timestamps: Whether to shift timestamps relative to start_time
Returns:
list: Extracted subtitles
"""
segment_subtitles = []
for sub in subtitles:
# Subtitle within time range
if sub["start"] >= start_time and sub["end"] <= end_time:
if adjust_timestamps:
# Adjust timestamp (relative to segment start)
adjusted_sub = {
"start": sub["start"] - start_time,
"end": sub["end"] - start_time,
"text": sub["text"],
}
segment_subtitles.append(adjusted_sub)
else:
segment_subtitles.append(sub.copy())
# Subtitle overlaps time range boundaries
elif sub["start"] < end_time and sub["end"] > start_time:
if adjust_timestamps:
adjusted_sub = {
"start": max(0, sub["start"] - start_time),
"end": min(end_time - start_time, sub["end"] - start_time),
"text": sub["text"],
}
segment_subtitles.append(adjusted_sub)
else:
segment_subtitles.append(sub.copy())
return segment_subtitles
def save_subtitles_as_srt(subtitles: list, output_path: str):
"""
Save subtitles in SRT format.
Args:
subtitles: List of subtitles
output_path: Path to output file
"""
output_path = Path(output_path)
output_path.parent.mkdir(parents=True, exist_ok=True)
with open(output_path, "w", encoding="utf-8") as f:
for i, sub in enumerate(subtitles, 1):
# SRT Index
f.write(f"{i}\n")
# SRT Timestamps (comma for milliseconds)
start_time = seconds_to_time(
sub["start"], include_hours=True, use_comma=True
)
end_time = seconds_to_time(sub["end"], include_hours=True, use_comma=True)
f.write(f"{start_time} --> {end_time}\n")
# Subtitle text
f.write(f"{sub['text']}\n")
# Empty line separator
f.write("\n")
print(f"DONE: Subtitles saved: {output_path}")
def main():
"""CLI entry point"""
if len(sys.argv) < 5:
print("Usage: python clip_video.py <video> <start_time> <end_time> <output>")
print("\nArguments:")
print(" video - Path to input video file")
print(" start_time - Start time (seconds or time string like 00:01:30)")
print(" end_time - End time (seconds or time string)")
print(" output - Path to output video file")
print("\nExample:")
print(" python clip_video.py input.mp4 0 195 output.mp4")
print(" python clip_video.py input.mp4 00:00:00 00:03:15 output.mp4")
print(" python clip_video.py input.mp4 01:30:00 01:33:15 output.mp4")
sys.exit(1)
video_path = sys.argv[1]
start_time = sys.argv[2]
end_time = sys.argv[3]
output_path = sys.argv[4]
try:
result_path = clip_video(video_path, start_time, end_time, output_path)
print(f"\nDONE: Clipping finished! Output: {result_path}")
except Exception as e:
print(f"\nERROR: {str(e)}")
import traceback
traceback.print_exc()
sys.exit(1)
video_path = sys.argv[1]
start_time = sys.argv[2]
end_time = sys.argv[3]
output_path = sys.argv[4]
try:
result_path = clip_video(video_path, start_time, end_time, output_path)
print(f"\n✨ 完成!输出文件: {result_path}")
except Exception as e:
print(f"\n❌ 错误: {str(e)}")
import traceback
traceback.print_exc()
sys.exit(1)
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |