{"id":"ad52d8c5-26d5-496d-a9a3-3fd476b8536f","slug":"autogen-video","kind":"skill","name":"autogen-video","summary":"","owner":"hien23ns","repoUrl":"https://github.com/hien23ns/autogen-video","license":"MIT","licenseTier":"permissive","trust":"community","stars":1,"match":null,"fewStars":true,"format":"skill","createdAt":"2026-10-19T08:57:21.000Z","addedAt":"2026-10-22T02:04:02.606Z","logoUrl":"https://avatars.githubusercontent.com/u/211047272?u=dff731e1b67e8b6c2712babba716167a2e48acc4&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["design-media"],"tags":[],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-26T10:04:27.018Z","sample":false,"url":"https://conduits.dev/tools/autogen-video","language":"TypeScript","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"<a id=\"top\"></a>\n\n<div align=\"center\">\n\n# 🎬 Auto Video Gen 2.5 Pro Studio\n\n### 🚀 Studio AI Hoàn Chỉnh Biến URL Bài Báo, GitHub Repo & Video Quay Thô Thành Video Triệu View\n\n**1 câu lệnh · 18 Motion Templates · Phụ đề từng từ Karaoke · AI Ghost Editor · Âm thanh -14 LUFS Ducking · Đa tỉ lệ (9:16, 16:9, 1:1, 4:5)**\n\n[![License](https://img.shields.io/github/license/hien23ns/autogen-video?style=for-the-badge&color=green)](LICENSE)\n[![Node](https://img.shields.io/badge/node-20%2B-brightgreen?style=for-the-badge&logo=node.js&logoColor=white)](https://nodejs.org)\n[![TypeScript](https://img.shields.io/badge/typescript-5%2B-blue?style=for-the-badge&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)\n[![Vitest](https://img.shields.io/badge/tests-80%2F80%20passed-success?style=for-the-badge&logo=vitest&logoColor=white)](https://vitest.dev/)\n\n</div>\n\n---\n\n## 🌟 TỔNG QUAN KIẾN TRÚC STUDIO (PIPELINE ARCHITECTURE)\n\n```mermaid\nflowchart TD\n    subgraph Inputs[\"1. ĐẦU VÀO\"]\n        A1[\"📰 URL Bài Báo / Tin Tức\"]\n        A2[\"⭐ GitHub Repository\"]\n        A3[\"📹 Video Quay Thô (Raw Footage)\"]\n        A4[\"📝 Kịch Bản JSON / File .txt\"]\n    end\n\n    subgraph AI_Core[\"2. XỬ LÝ & BIÊN TẬP AI\"]\n        B1[\"Scraper & Content Ingest\"] --> B2[\"Gemini AI Kịch Bản Chuẩn TTS\"]\n        A3 --> B3[\"Ghost-Editor: Cắt Lặng, Bỏ Bad Takes\"]\n        B3 --> B4[\"9:16 Reframe & Punch-in Zooms\"]\n    end\n\n    subgraph Production[\"3. SẢN XUẤT AUDIO & MOTION\"]\n        C1[\"TTS Engine (Edge / LucyLab / Vbee / ElevenLabs)\"]\n        C2[\"5 Phong Cách Phụ Đề Word-Level Karaoke\"]\n        C3[\"18 Motion Templates (Spring Physics + GSAP)\"]\n        C4[\"BGM Ducking (-18dB) + Mastering -14 LUFS\"]\n    end\n\n    subgraph QA_Delivery[\"4. KIỂM SOÁT CHẤT LƯỢNG & ĐÓNG GÓI\"]\n        D1[\"Vòng QA Tự Động (Trích 5 Frame, Đo LUFS)\"]\n        D2[\"HyperFrames Studio Preview (npm run studio)\"]\n        D3[\"Bộ Xuất Bản (publish/): Copy TikTok/Shorts/Reels + Covers\"]\n    end\n\n    Inputs --> AI_Core\n    AI_Core --> Production\n    Production --> QA_Delivery\n```\n\n---\n\n## ✨ TÍNH NĂNG ĐỘT PHÁ Ở PHIÊN BẢN 2.5 PRO STUDIO\n\n### 1. 🎨 Hệ Thống Motion Design Đỉnh Cao (18 Templates)\n- **Spring Physics & Bezier Easing:** Chuyển động cơ học nảy mượt mà (`back.out(1.7)`), loại bỏ hoàn toàn các chuyển động phẳng.\n- **Quy tắc 3 thuộc tính:** Mọi phần tử vào cảnh đều phối hợp `opacity` + `translate` + `scale/blur`.\n- **Dynamic Mesh Gradient + Grain Overlay:** Nền sống động, chiều sâu điện ảnh, không còn nền màu phẳng nhàm chán.\n- **18 Templates đa năng:**\n  - *Tin tức & Số liệu:* `hook`, `stat-hero`, `comparison`, `feature-list`, `callout`, `outro`\n  - *Hướng dẫn & So sánh:* `tutorial-steps`, `before-after` (slider tương tác), `product-showcase`, `timeline`\n  - *Tech & Lập trình:* `github-repo-explainer`, `code-walkthrough` (gõ code & highlight dòng), `data-dashboard`\n  - *Tương tác & Mạng xã hội:* `top-list-ranking`, `chat-conversation`, `map-route`, `testimonial-reaction`, `cta-outro`\n- **6 Visual Styles (`--style`):** `news`, `tech`, `minimal`, `high-energy`, `luxury`, `retro`.\n- **Brand Kit:** Đọc màu sắc, font chữ và logo trực tiếp từ `brand.config.json`.\n\n### 2. 💬 Phụ Đề Từng Từ (Word-Level Viral Captions)\n- **5 Phong cách phụ đề hot trend:** `karaoke-highlight`, `pop-in`, `box-highlight`, `hand-drawn-underline`, `minimal`.\n- **Nhấn từ khóa tự động:** Tự động phát hiện số liệu, tên riêng công nghệ, từ cảm xúc để tăng cỡ chữ và đổi màu neon rực rỡ.\n- **Ngắt dòng thông minh tiếng Việt:** 2–5 từ mỗi nhịp, đặt chính xác trong Safe Zone TikTok/Shorts (không bị che bởi nút Like/Share).\n- **Xuất phụ đề đa năng:** Nhúng trực tiếp vào video hoặc xuất file `.srt` và `.vtt` rời.\n\n### 3. 🤖 AI Ghost Editor (`/edit-raw-video`)\n- **Tự cắt khoảng lặng:** Nhận diện và cắt sạch mọi khoảng lặng chết > 0.35s bằng FFmpeg `silencedetect`.\n- **Lọc từ đệm & tật nói:** Cắt bỏ \"ừm\", \"ờ\", \"à\", \"thì\", \"là\", \"kiểu như\" và các lần nói vấp lặp từ.\n- **Chọn Take Tốt Nhất:** Khi người quay nói hỏng và lặp lại câu, AI chấm điểm độ lưu loát và **chỉ giữ lại bản quay tốt nhất**.\n- **Reframe 9:16 & Punch-ins:** Tự động crop video ngang thành dọc 9:16 và đổi cỡ cảnh (wide 1.0x -> punch-in 1.18x -> close-up 1.25x) sau mỗi 2 câu.\n- **Bản so sánh Split-Screen:** Xuất video so sánh 2 nửa màn hình (Gốc vs Đã AI edit) với nhãn trực quan.\n\n### 4. 🔊 Sound Design & Mastering Chuẩn Phát Sóng\n- **Tự Động Ducking (Sidechain Compression):** Nhạc nền tự hạ -18dB khi người nói bắt đầu và dâng lên mượt mà khi ngắt câu.\n- **Mastering EBU R128:** Âm lượng đạt chuẩn quốc tế **-14.0 LUFS, True Peak ≤ -1.0 dBTP**, không bị xé tiếng hay rè loa điện thoại.\n- **SFX Frame-Accurate:** Tự động chọn âm thanh phù hợp theo chuyển động (whoosh, hit, cash register, chime).\n\n### 5. 🔍 Vòng QA Tự Động & Chẩn Đoán Môi Trường\n- **QA Verification:** Trích xuất 5 frame kiểm tra tràn chữ, vi phạm safe-zone, chênh lệch âm lượng, xuất báo cáo `qa-report.md`.\n- **Doctor Tool (`npm run doctor`):** Chẩn đoán Node 20+, FFmpeg filters, API keys và đưa ra hướng dẫn sửa lỗi tức thì.\n\n### 6. 🎛️ Studio Preview, Rerender & Đa Tỉ Lệ\n- **HyperFrames Studio:** Chạy `npm run studio` mở trình chỉnh timeline trực quan trên trình duyệt.\n- **Rerender theo cảnh:** `npm run rerender -- <dir> --scene hook --preset draft` chỉ render cảnh cần sửa trong vài giây nhờ cache SHA256.\n- **Đa tỉ lệ:** `--ratio 9:16 | 16:9 | 1:1 | 4:5` co giãn bố cục tự động.\n- **Batch Processing:** `npm run batch -- urls.txt` tạo hàng loạt video có hàng đợi và retry tự động.\n\n---\n\n## 🚀 CÀI ĐẶT & CHẠY NHANH\n\n### 1. Yêu Cầu Hệ Thống\n- **Node.js**: v20+ hoặc v22+\n- **FFmpeg**: Đã cài đặt và có trong PATH hệ thống (`ffmpeg -version`)\n\n### 2. Cài Đặt\n```bash\ngit clone https://github.com/hien23ns/autogen-video.git\ncd autogen-video\nnpm install\nnpm run doctor # Kiểm tra môi trường hoàn chỉnh\n```\n\n### 3. Cấu Hình `.env` (Tùy Chọn)\nCopy file mẫu:\n```bash\ncp .env.example .env.local\n```\n*Ghi chú: Nếu không có API Key, hệ thống vẫn chạy 100% miễn phí với Edge TTS và bộ phân tích offline!*\n\n---\n\n## 💻 HƯỚNG DẪN SỬ DỤNG CHI TIẾT\n\n### 1. Tạo Video Từ Link Bài Báo / GitHub Repo\n```bash\n# Video tin tức cơ bản:\nnpm run pipeline -- --url https://vnexpress.net/... --theme dark\n\n# Video giới thiệu repo GitHub phong cách công nghệ:\nnpm run pipeline -- --url https://github.com/facebook/react --theme cyberpunk\n\n# Tạo video với tỉ lệ màn hình ngang 16:9 (YouTube):\nnpm run pipeline -- --url https://... --ratio 16:9\n```\n\n### 2. Cắt Video Quay Thật Bằng AI Ghost-Editor\n```bash\n# Cắt bỏ lỗi, chọn best take, reframe 9:16:\nnpm run edit-raw -- raw-take.mp4 --reframe 9:16\n\n# Xuất thêm video so sánh split-screen (Gốc vs Edit):\nnpm run edit-raw -- raw-take.mp4 --compare\n\n# Chế độ xem trước kế hoạch cắt (Dry-run không tốn thời gian render):\nnpm run edit-raw -- raw-take.mp4 --dry-run\n```\n\n### 3. Tái Render Nhanh & Mở Studio\n```bash\n# Mở HyperFrames Visual Studio chỉnh sửa timeline:\nnpm run studio\n\n# Render lại chỉ 1 cảnh duy nhất:\nnpm run rerender -- output/my-video --scene hook --preset draft\n\n# Kiểm tra chất lượng và đo độ lớn LUFS:\nnpm run qa:video -- output/my-video/video.mp4\n\n# Tạo video hàng loạt từ danh sách URL:\nnpm run batch -- urls.txt --concurrency 2\n```\n\n---\n\n## 🤖 TÍCH HỢP AGENT SKILLS & LỆNH SLASH\n\nHệ thống cung cấp **8 Agent Skills** tương thích 100% cho cả **Google Antigravity** (`.agents/skills/`) và **Claude Code** (`.claude/skills/`).\n\n| Lệnh Slash | Skill | Chức Năng |\n| :--- | :--- | :--- |\n| `/create-news-video` | `create-news-video` | Tạo video 9:16 hoàn chỉnh từ bài báo / .txt |\n| `/edit-raw-video` | `edit-raw-video` | AI Ghost Editor: cắt lỗi, chọn best take, reframe 9:16 |\n| `/repo-to-video` | `github-repo-to-video` | Biến repo GitHub thành video giới thiệu công nghệ |\n| `/video-qa` | `video-qa` | Chạy bộ phân tích chất lượng video và đo LUFS |\n| `/make-captions` | `captions` | Tạo phụ đề karaoke 5 phong cách chuẩn viral |\n| `/sound-design` | `sound-design` | Thiết kế SFX, ducking nhạc nền và mastering -14 LUFS |\n| `/publish-pack` | `publish-pack` | Xuất copy đa nền tảng, checklist và cover thumbnail |\n| `/motion-design` | `motion-design` | Quy tắc chuyển động cơ học spring, bezier và brand kit |\n\nĐồng bộ skills 2 chiều bất kỳ lúc nào:\n```bash\nnpm run skills:sync\n```\n\n---\n\n## 💰 BẢNG CHI PHÍ VẬN HÀNH (0đ vs Có Key)\n\n| Dịch vụ | Chế độ Miễn Phí (Default 0đ) | Chế độ Nâng Cao (Khi có API Key) |\n| :--- | :--- | :--- |\n| **TTS Giọng Đọc** | **Edge TTS** (Nam Minh, Hoài My - Miễn phí 100%) | LucyLab, Vbee, ElevenLabs (Giọng clone cao cấp) |\n| **Biên Tập Kịch Bản** | Heuristic Parser / Scraper nội bộ | Google Gemini (`gemini-3.5-flash` - Miễn phí hạn mức lớn) |\n| **Whisper Transcribe** | Heuristic silence & pause alignment | OpenAI Whisper API (`whisper-1` timestamp từng từ) |\n| **SFX & BGM** | Thư viện âm thanh thương mại miễn phí bản quyền kèm sẵn | Bổ sung thêm SFX tùy ý vào `assets/sfx` |\n| **Render Engine** | HyperFrames cục bộ 100% offline | Render đám mây qua GitHub Actions Webhook |\n\n---\n\n## ❓ FAQ & XỬ LÝ SỰ CỐ (TROUBLESHOOTING)\n\n#### 1. Lệnh `ffmpeg` báo không tìm thấy?\n- Chạy `npm run doctor` để kiểm tra.\n- Trên Windows, cài đặt nhanh bằng lệnh: `winget install Gyan.FFmpeg`.\n\n#### 2. Phụ đề tiếng Việt có bị vỡ font không?\n- Hoàn toàn không! Mọi template sử dụng font Google Fonts hỗ trợ đầy đủ bộ gõ tiếng Việt có dấu: `Be Vietnam Pro`, `Montserrat`, `Inter`, `Anton`.\n\n#### 3. Làm thế nào để đổi màu thương hiệu (Brand Kit)?\n- Chỉnh sửa file `brand.config.json` ở thư mục gốc: thay đổi logo, mã màu primary/accent và font chữ.\n\n---\n\n## 📄 GIẤY PHÉP (LICENSE)\nDự án phát hành theo giấy phép [MIT License](LICENSE).  \nMọi tài nguyên âm thanh (SFX, BGM) tuân thủ danh mục bản quyền tại [assets/LICENSES.md](assets/LICENSES.md).\n"}