为什么值得关注

它通过SSE提供实时进度反馈，缓存元数据和源视频，具备队列并发控制以及全面的错误处理，并封装成简洁的REST API和前端界面。

适合谁使用

需要自行托管YouTube剪辑服务的开发者
需要为社交媒体提取短视频的内容创作者
希望自动化截取视频片段的视频编辑人员
不愿安装桌面软件来完成简单剪辑的用户

典型使用场景

从长视频中提取精彩片段
为多平台复用创建短视频
将视频片段转换为MP3或提取音频
利用缓存机制批量剪辑同一视频的多个片段

项目优势

通过Server-Sent Events为每个任务提供实时进度流
智能缓存避免重复下载相同的视频源文件
可配置并发数的队列防止资源过载
包含速率限制、输入验证、路径遍历防护等安全措施

使用前须知

必须手动安装yt-dlp（未提供自动回退）
依赖FFmpeg（虽有静态回退）和Python（用于yt-dlp）
README明确禁止将软件本身用于商业转售（MIT许可证可能允许，但README另有说明）

README 快速开始

YouTube Video Clipper v1

Tools untuk mengambil bagian tertentu (clip) dari video YouTube dan mengekspornya menjadi file video baru — tanpa perlu mengunduh seluruh video secara manual.

Dibangun dengan Node.js + Express, yt-dlp untuk pengambilan video, dan FFmpeg untuk pemotongan/encoding. Progress real-time menggunakan Server-Sent Events.

Fitur

Ambil metadata video (judul, thumbnail, durasi, channel, resolusi, subtitle) tanpa download
Potong video berdasarkan rentang waktu (start – end) dengan pilihan resolusi output
Progress real-time (downloading → clipping → encoding → finished) via SSE
Cache metadata & source video (tidak download ulang video yang sama)
Auto-cleanup file setelah 30 menit
Rate limiting, validasi input, sanitasi filename, proteksi path traversal
Fitur bonus: convert ke MP3, extract audio, watermark, ubah FPS, compress, crop, burn subtitle, merge clip (lihat services/ffmpeg.service.js)

Struktur Project

youtube-clipper/
├── app.js                  # Entry point
├── config/                 # Konfigurasi & konstanta
├── routes/                 # Definisi endpoint
├── controllers/             # Request/response handler
├── services/                 # Business logic (yt-dlp, ffmpeg, job, queue, cache, cleanup)
├── middleware/               # Validator, rate limiter, security, error handler
├── utils/                    # Helper murni (validator, logger, sanitizer, dll)
├── views/ + public/          # Frontend (EJS + vanilla JS + CSS)
├── scripts/                   # Script maintenance (checkDependencies, clean)
├── temp/ downloads/ output/ logs/   # Folder runtime (auto-dibersihkan)

1. Instalasi

Prasyarat

Node.js ≥ 18 LTS
Python 3 (untuk instalasi yt-dlp via pip) — opsional jika pakai binary langsung
FFmpeg (opsional install manual — project sudah menyediakan fallback via ffmpeg-static)

Install dependency Node.js

git clone https://github.com/ray4rt/yt-clip
cd yt-clip
npm install

Install FFmpeg (opsional, untuk performa & codec terbaik)

Ubuntu/Debian

sudo apt update && sudo apt install -y ffmpeg

macOS

brew install ffmpeg

Windows

Download dari https://www.gyan.dev/ffmpeg/builds/
Extract, tambahkan folder bin ke PATH
Verifikasi: ffmpeg -version

Jika FFmpeg sistem tidak ditemukan, aplikasi otomatis f

yt-clip