Lucky Me Clipper

Tools untuk memotong video horizontal YouTube (16:9) jadi video vertikal (9:16) siap upload ke Shorts, TikTok, atau Reels. Deteksi pergantian scene diproses dengan PySceneDetect, dan posisi wajah pembicara dipantau dengan MediaPipe agar cropping pas di tengah.

Proyek ini menyediakan:

1. MCP Server (Model Context Protocol) yang bisa dipanggil oleh Claude Desktop, Cursor, Antigravity, OpenCode, VS Code / Roo Code, dan Windsurf.

2. Web Control Center ringan berbasis FastAPI + Tailwind + Alpine.js untuk memantau status render, cek video di theater player, dan mengelola publish ke YouTube via Zernio API.

Cara Pasang MCP

Jalankan perintah ini di folder proyek untuk memasang server MCP ke semua editor AI yang terpasang di komputer Anda (Claude Desktop, Cursor, Antigravity, OpenCode, VS Code / Roo Code, atau Windsurf):

python doctor.py --install-all

Perintah ini akan mencari lokasi konfigurasi masing-masing editor secara otomatis dan mendaftarkan video-reframer.

Bila ingin memasang ke editor tertentu saja:

python doctor.py --install claude_desktop
# Pilihan lain: cursor, antigravity, opencode, windsurf, cline_roo

Related MCP server: VE-MCP

Setup Awal Proyek

1. Pasang Dependensi Python

git clone https://github.com/LuckyAnggara/lucky-me-clipper.git
cd lucky-me-clipper
pip install -r requirements.txt

2. Atur Environment (.env)

Salin contoh file .env:

cp .env.example .env

Lalu masukkan API key Anda ke file .env:

GEMINI_API_KEY=AIzaSyD-xxxxxx

# Opsional jika ingin auto publish ke YouTube Shorts
ZERNIO_API_KEY=
ZERNIO_YOUTUBE_ACCOUNT_ID=

3. Cek Status Sistem & Unduh FFmpeg

Jalankan diagnosa sistem:

python doctor.py --check

Jika FFmpeg belum terpasang di komputer Anda, jalankan Web UI untuk mengunduh FFmpeg portable sekali klik:

python ui.py

Buka browser di http://127.0.0.1:8080, lalu klik Unduh FFmpeg Portable. Binary akan tersimpan di folder lokal ./bin/ tanpa mengubah path sistem komputer Anda.

Fitur Utama

• Kurasi Otomatis (curate_youtube_clips): Menganalisis video YouTube langsung via Gemini 3.8 Flash tanpa perlu download file video utuh di awal. Memberi rekomendasi timestamp dan hook.

• Sistem Memory Interaktif: Server menyimpan percakapan analisis klip dan project aktif ke database SQLite lokal (clipper_memory.db). Jika Anda menanyakan "tadi klip nomor berapa yang tersisa?", AI masih mengingat konteks sebelumnya.

• Download Presisi (fetch_and_trim_clip): Hanya mengunduh potongan video yang dipilih menggunakan yt-dlp.

• Deteksi Shot Kamera (analyze_scene_composition): Memotong klip tepat di pergantian sudut kamera dan menghitung koordinat wajah.

• Layout Adaptif 9:16 (render_adaptive_video):

  • 1 Wajah: Fullscreen crop 9:16 mengikuti pembicara.

  • 2 Wajah: Split screen atas-bawah atau 1:1 berdampingan.

  • B-roll / multi-orang: Format 1:1 di tengah dengan background ambient blur.

• Subtitle Animasi Dinamis (render_dynamic_css_captions): Pilihan gaya hormozi, mrbeast, cyberpunk, atau minimal, dirender via Headless Chrome dan ditempel ke video dengan FFmpeg.

• Cover Thumbnail 9:16 (render_short_cover): Menghasilkan thumbnail vertikal dengan hook text 2 baris di area dada agar tidak menutupi wajah.

• Publish ke YouTube Shorts (publish_clip_to_social, schedule_clip_post): Upload dan jadwalkan posting lewat integrasi Zernio API dengan log audit tersimpan di database.

Contoh Penggunaan via Chat AI

Setelah MCP terhubung ke AI editor Anda, Anda cukup memberikan instruksi seperti ini di ruang obrolan:

"Ambil bagian menarik dari link YouTube ini: https://www.youtube.com/watch?v=xxxx. Buatkan klip vertikal 9:16 dengan subtitle gaya hormozi dan buatkan cover pembukanya."

AI Agent akan:

1. Menemukan momen terbaik dan memberikan daftar segmen.

2. Mengunduh segmen yang Anda pilih.

3. Mendeteksi pergantian shot dan wajah pembicara.

4. Merender klip 9:16 dan menempelkan subtitle animasi.

5. Memberikan tautan ke Web UI (http://127.0.0.1:8080) agar Anda bisa menonton hasilnya di theater player.

Menjalankan Pengujian

Untuk memverifikasi semua fungsi server dan web UI:

python tests/test_server.py
python tests/test_web_server.py