Skip to content
Back to search

auto-compare-video

🎬 Tạo video "so sánh kiến thức" ngắn tự động — HyperFrames + AI voice, 1 template nhiều chủ đề.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cuongyd196--auto-compare-video/badge.svg)](/listings/cuongyd196--auto-compare-video)

HTML

<a href="/listings/cuongyd196--auto-compare-video"><img src="/api/listings/cuongyd196--auto-compare-video/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 224 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Tạo Video Dạng So Sánh Kiến Thức — Comparison Video Template
  2. **Template video giáo dục ngắn (TikTok/Reels/Shorts)** dựng trên **[HyperFrames](https://hyperframes.heygen.com)** — mỗi video so sánh một cặp khái niệm hay bị nhầm lẫn, theo đúng một layout/nhịp cố định, chỉ đổi nội dung.
  3. ![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
  4. [![HyperFrames License: Apache 2.0](https://img.shields.io/badge/HyperFrames-Apache%202.0-blue.svg)](https://github.com/heygen-com/hyperframes/blob/main/LICENSE)
  5. ![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)
  6. ![Built with HyperFrames](https://img.shields.io/badge/built%20with-HyperFrames-111827)
  7. ![PRs welcome](https://img.shields.io/badge/PRs-welcome-ff4fa3.svg)
  8. ## Mục lục
  9. - [Xem trước](#-xem-trước)
  10. - [Các video hiện có](#các-video-hiện-có)
  11. - [Tính năng nổi bật](#-tính-năng-nổi-bật)
  12. - [Bảng màu & thiết kế](#-bảng-màu--thiết-kế)
  13. - [Cấu trúc repo](#-cấu-trúc-repo)
  14. - [Yêu cầu hệ thống](#️-yêu-cầu-hệ-thống)
  15. - [Bắt đầu](#-bắt-đầu)
  16. - [Đóng góp](#-đóng-góp)
  17. - [Xem thêm](#-xem-thêm)
  18. - [License](#-license)
  19. ## 🎬 Xem trước
  20. | Thiên thạch vs Sao băng | Dev vs DevOps |
  21. | --- | --- |
  22. | ![Preview Thiên thạch vs Sao băng](docs/previews/thien-thach-vs-sao-bang.png) | ![Preview Dev vs DevOps](docs/previews/dev-vs-devops.png) |
  23. Ảnh chụp trực tiếp từ composition hiện tại (`hyperframes snapshot`) — bảng màu tím-hồng-lục lam và avatar
  24. robot 2D là giao diện **mặc định hiện hành** của cả series (xem [Bảng màu & thiết kế](#-bảng-màu--thiết-kế)).
  25. Một số demo video ngắn dạng TikTok/Reels/Shorts đã xuất bản:
  26. | Demo 1 | Demo 2 |
  27. | --- | --- |
  28. | [![Xem demo 1 trên YouTube Shorts](https://img.youtube.com/vi/PK-BZtdnkFU/hqdefault.jpg)](https://www.youtube.com/shorts/PK-BZtdnkFU) | [![Xem demo 2 trên YouTube Shorts](https://img.youtube.com/vi/8ZfXTse5HFw/hqdefault.jpg)](https://youtube.com/shorts/8ZfXTse5HFw) |
  29. | ▶️ **[youtube.com/shorts/PK-BZtdnkFU](https://www.youtube.com/shorts/PK-BZtdnkFU)** | ▶️ **[youtube.com/shorts/8ZfXTse5HFw](https://youtube.com/shorts/8ZfXTse5HFw)** |
  30. ## Các video hiện có trong repo
  31. | Video | Chủ đề | Thư mục |
  32. |---|---|---|
  33. | Thiên thạch vs Sao băng | Meteorite vs Meteor | [`videos/thien-thach-vs-sao-bang/`](videos/thien-thach-vs-sao-bang/) |
  34. | Dev vs DevOps | "Dev xây, DevOps vận hành" | [`videos/dev-vs-devops/`](videos/dev-vs-devops/)
  35. ## 📌 Tính năng nổi bật
  36. - **Layout 3 phần chuẩn hóa** (xem chi tiết trong [`DESIGN.md`](DESIGN.md)):
  37. 1. **Nửa trên** — 2 card minh họa đặt cạnh nhau bằng CSS/SVG (khái niệm A bên trái, B bên phải).
  38. 2. **Phần giữa** — caption chạy chữ động, tô nổi bật từ khóa quan trọng bằng màu định sẵn.
  39. 3. **Nửa dưới** — avatar MC robot 2D với 4 tư thế (chỉ tay trái, chỉ tay phải, nhún vai thắc mắc,
  40. giải thích), miệng/mắt LED nhấp nháy đồng bộ theo nhịp lời thoại.
  41. - **Voiceover tự động** — hỗ trợ **3 TTS provider**: **[VieNeu TTS](vieneu.md)** (chạy local qua CIT Voice Studio, phản hồi nhanh, chất lượng cao 48 kHz), **[Edge TTS](https://github.com/travisvn/edge-tts-universal)** (miễn phí, không cần API key, pure Node.js) và **[Vbee TTS API](vbee.md)** (chất lượng cao, cần tài khoản). Dùng `ffprobe` đo độ dài thật từng câu để đồng bộ animation GSAP chính xác tới mili-giây (không ước lượng).
  42. - **Font tiếng Việt chuẩn** — Be Vietnam Pro nhúng qua `@font-face` + `unicode-range`, không bị lỗi dấu như khi dùng font mặc định của compiler.
  43. - **Nhiều video, 1 template** — mỗi video là một project HyperFrames độc lập trong `videos/`, dùng chung thiết kế/credentials, dễ nhân bản cho chủ đề mới.
  44. ## 🎨 Bảng màu & thiết kế
  45. Toàn bộ hợp đồng layout/màu/font/motion nằm trong [`DESIGN.md`](DESIGN.md) — mọi video trong series
  46. đều phải theo đúng bảng màu và cấu trúc 3-zone này để giữ nhận diện đồng nhất.
  47. | Token | Hex | Vai trò |
  48. | --- | --- | --- |
  49. | `--bg` | `#0D0A1A` | Nền chính (đen ánh tím) |
  50. | `--panel` | `#17122C` | Nền card minh họa |
  51. | `--panel-edge` | `#2B2350` | Viền card / robot |
  52. | `--fg` | `#F3F1FF` | Chữ chính |
  53. | `--fg-dim` | `#9089B0` | Chữ phụ / label |
  54. | `--accent-pink` | `#FF4FA3` | Từ khóa nổi bật, mắt/miệng robot |
  55. | `--accent-cyan` | `#37E6C4` | Tên chủ đề, đầu robot, đèn ngực |
  56. ## 📁 Cấu trúc repo
  57. ```
  58. auto-compare-video/
  59. ├── README.md, LICENSE ← bạn đang ở đây
  60. ├── CLAUDE.md, AGENTS.md ← hướng dẫn cho AI coding agent (Claude Code, Cursor...)
  61. ├── DESIGN.md ← hợp đồng layout/màu/font/motion — dùng chung mọi video
  62. ├── vieneu.md ← tài liệu API VieNeu TTS (CIT Voice Studio)
  63. ├── vbee.md ← tài liệu API Vbee TTS
  64. ├── docs/previews/ ← ảnh preview tĩnh dùng trong README
  65. ├── .env ← credentials & cấu hình TTS dùng chung (tự tạo, không commit)
  66. ├── .claude/skills/create-video/ ← skill Claude Code: tạo video mới theo đúng template
  67. ├── .agents/skills/create-video/ ← skill Antigravity: cùng quy trình, cho Antigravity / Antigravity CLI
  68. └── videos/
  69. ├── thien-thach-vs-sao-bang/ ← 1 video = 1 project HyperFrames độc lập
  70. │ ├── package.json, hyperframes.json, meta.json, index.html
  71. │ ├── BRIEF.md ← brief riêng của video này
  72. │ ├── assets/vo/*.mp3, durations.json
  73. │ ├── scripts/generate-vo.mjs
  74. │ └── renders/, snapshots/ ← output, không commit
  75. ├── dev-vs-devops/ ← cấu trúc tương tự
  76. └── <video-mới>/ ← thêm video mới vào đây
  77. ```
  78. Mỗi video trong `videos/` là một project HyperFrames **hoàn toàn độc lập** (`npm run dev/check/render/publish` riêng), chỉ dùng chung `.env` ở root và bộ quy tắc thiết kế trong `DESIGN.md`.
  79. ## 🛠️ Yêu cầu hệ thống
  80. 1. **AI coding agent** (Claude Code, Cursor, Codex v.v.) để gọi skill tạo video tự động).
  81. 2. **TTS provider** (chọn 1 trong 3):
  82. - **[VieNeu TTS](vieneu.md)** — chạy local không tốn phí, 20 giọng đọc tự nhiên 48 kHz. **Yêu cầu cài đặt [CIT Voice Studio](https://github.com/Cuongyd196/cit-voice-studio)** và bật server API tại `http://127.0.0.1:8001`.
  83. - **[Edge TTS](https://github.com/travisvn/edge-tts-universal)** — miễn phí, không cần API key, giọng Microsoft Neural. Đã tích hợp sẵn qua npm (`edge-tts-universal`), không cần cài gì thêm.
  84. - **[Vbee TTS](https://vbee.vn/?aff=cuongit96)** — chất lượng cao, nhiều giọng Việt, cần tài khoản (App ID + Access Token). Xem [vbee.md](vbee.md).
  85. 3. **Node.js** ≥ 18 — tải tại [nodejs.org/en/download](https://nodejs.org/en/download)
  86. 4. **FFmpeg & FFprobe** trong `PATH` — cần để đo độ dài audio và render video. Hướng dẫn cài đặt: [ffmpeg.org/download.html](https://ffmpeg.org/download.html) (Windows có thể dùng `winget install ffmpeg` hoặc `choco install ffmpeg`; macOS dùng `brew install ffmpeg`; Linux dùng `apt install ffmpeg`)
  87. ## 🚀 Bắt đầu
  88. ### 1. Thiết lập credentials (dùng chung cho mọi video)
  89. Copy `.env.example` thành `.env` ở **thư mục gốc của repo**, rồi điền các biến môi trường:
  90. ```bash
  91. cp .env.example .env
  92. ```
  93. ```env
  94. TTS_PROVIDER=vieneu # "vieneu" (local) | "edge" (miễn phí) | "vbee" (cần tài khoản)
  95. VIENEU_API_URL=http://127.0.0.1:8001 # URL của CIT Voice Studio
  96. VIENEU_VOICE=Minh Đức # giọng VieNeu TTS (xem vieneu.md)
  97. EDGE_VOICE=vi-VN-NamMinhNeural # giọng Edge TTS — nam: NamMinhNeural, nữ: HoaiMyNeural
  98. CHANNEL=Cường IT # tên kênh hiển thị trên eyebrow tag
  99. AUTO_CREATE_VIDEO=0 # 0 = xác nhận từng bước | 1 = chạy tự động
  100. ```
  101. > **Hỗ trợ 3 TTS providers linh hoạt**:
  102. > - **VieNeu TTS**: đổi `TTS_PROVIDER=vieneu`. Để sử dụng, cần cài đặt và khởi chạy server local từ **[CIT Voice Studio](https://github.com/Cuongyd196/cit-voice-studio)** (mặc định tại `http://127.0.0.1:8001`, xem chi tiết tại [`vieneu.md`](vieneu.md)).
  103. > - **Edge TTS**: đổi `TTS_PROVIDER=edge`, chạy hoàn toàn bằng Node.js qua `edge-tts-universal`.
  104. > - **Vbee TTS**: đổi `TTS_PROVIDER=vbee` và điền `VBEE_APP_ID`, `VBEE_ACCESS_TOKEN` (xem chi tiết tại [`vbee.md`](vbee.md)).
  105. `.env` không commit (đã có trong `.gitignore`) — chỉ `.env.example` được đưa lên repo làm mẫu.
  106. ### 2. Tạo video mới
  107. Cách nhanh nhất — dùng **Claude Code**, gọi skill có sẵn kèm cặp khái niệm muốn so sánh, ví dụ:
  108. ```
  109. /create-video Dev và DevOps
  110. ```
  111. Chỉ cần lệnh này là skill tự động làm hết phần còn lại: hỏi/xác nhận lại cặp khái niệm + kịch bản
  112. 12 dòng (trừ khi `AUTO_CREATE_VIDEO=1` — xem bước 1), tự khởi tạo project, sinh giọng đọc VO, dựng
  113. composition đúng theo `DESIGN.md`, và chạy `npm run check` — xem chi tiết trong
  114. [`.claude/skills/create-video/SKILL.md`](.claude/skills/create-video/SKILL.md).
  115. **Dùng Google Antigravity?** Skill tương đương đã có sẵn ở
  116. [`.agents/skills/create-video/`](.agents/skills/create-video/) — clone repo về là Antigravity tự
  117. nhận, không cần cài gì. Không cần gõ tên skill, chỉ cần nói bình thường:
  118. ```
  119. Làm video so sánh Dev và DevOps
  120. ```
  121. Xem [`.agents/skills/create-video/README.md`](.agents/skills/create-video/README.md) để biết cách
  122. cài global cho mọi project và khác biệt so với bản Claude Code.
  123. Không dùng AI agent nào ở trên, hoặc muốn tự chạy từng bước thủ công — làm theo phần dưới đây:
  124. <details>
  125. <summary>Các bước thủ công (không dùng skill)</summary>
  126. **Sinh giọng đọc cho một video:**
  127. ```bash
  128. cd videos/thien-thach-vs-sao-bang
  129. node scripts/generate-vo.mjs
  130. ```
  131. Tải audio về `assets/vo/*.mp3` và ghi độ dài thật vào `assets/vo/durations.json`.
  132. **Preview / kiểm tra / render:**
  133. Mọi lệnh chạy với thư mục hiện tại là **thư mục video** (vì `package.json` nằm ở đó):
  134. ```bash
  135. cd videos/thien-thach-vs-sao-bang
  136. npm run dev # preview server (long-running)
  137. npm run check # lint + layout + motion + contrast
  138. npm run render # render ra renders/*.mp4
  139. npm run publish # xuất bản, lấy link chia sẻ
  140. ```
  141. **Tạo video hoàn toàn mới (thay vì lặp lại video có sẵn):**
  142. 1. Tạo thư mục mới `videos/<ten-video-moi>/`, chạy `npx hyperframes@latest init` bên trong.
  143. 2. Copy cấu trúc HTML/CSS/timeline từ một video có sẵn, giữ nguyên hợp đồng layout trong `DESIGN.md` — chỉ đổi nội dung/icon/audio theo chủ đề mới.
  144. 3. Viết `BRIEF.md` riêng cho video đó (chủ đề, góc so sánh, kịch bản).
  145. 4. `node scripts/generate-vo.mjs` rồi `npm run check` trước khi coi là xong.
  146. </details>
  147. ## 🤝 Đóng góp
  148. Repo mở cho việc nhân bản/tuỳ biến. Nếu thêm video mới hoặc sửa template, giữ đúng layout 3-zone cố định trong `DESIGN.md` (đây là "hợp đồng" giúp cả series đồng nhất) — mọi thay đổi khác (chủ đề, kịch bản, icon) đều được hoan nghênh. Mở PR hoặc issue nếu bạn tìm thấy lỗi hoặc muốn đề xuất cải tiến.
  149. ## 🔗 Xem thêm
  150. Xem các dự án và mẫu tạo video khác tại:
  151. - Công cụ sinh giọng đọc tiếng Việt offline (VieNeu TTS): 🔗 [github.com/Cuongyd196/cit-voice-studio](https://github.com/Cuongyd196/cit-voice-studio)
  152. - Link repo tạo video từ 1 đường Link/Bài viết: 🔗 [github.com/Cuongyd196/auto-video-gen](https://github.com/Cuongyd196/auto-video-gen)
  153. - 1 repo tương tự sử dụng Remotion: 🔗 [github.com/Cuongyd196/remotion-cuongit-template](https://github.com/Cuongyd196/remotion-cuongit-template)
  154. Các video mẫu mình đã làm, các bạn có thể xem trong Reels hoặc TikTok:
  155. - 📹 Facebook: [www.facebook.com/cuongit96/reels/](https://www.facebook.com/cuongit96/reels/)
  156. - 📹 TikTok: [www.tiktok.com/@cuongit96](https://www.tiktok.com/@cuongit96)
  157. Mình tạo nhóm này cho các bạn trao đổi về Làm Video với AI nhé.
  158. Với các repo mình công khai, có vướng mắc mình sẽ giải đáp cho các bạn.
  159. - 👥 Nhóm trên Facebook: [facebook.com/groups/1010029065373486](https://www.facebook.com/groups/1010029065373486/)
  160. - 👥 Nhóm trên Zalo: [zalo.me/g/8bfeotyh5ewtkzxmp5gt](https://zalo.me/g/8bfeotyh5ewtkzxmp5gt)
  161. Nếu hữu ích với các bạn thì cho mình 1 star GitHub nhé 🌟
  162. Nếu muốn ủng hộ mình 1 ly cà phê: [buymeacoffee.com/cuongit96/gallery/4959449](https://buymeacoffee.com/cuongit96/gallery/4959449)
  163. ## 📄 License
  164. - Mã nguồn dự án phát hành theo giấy phép **[MIT](LICENSE)**.
  165. - Dự án xây dựng dựa trên **[HyperFrames](https://github.com/heygen-com/hyperframes)** thuộc giấy phép **[Apache 2.0](https://github.com/heygen-com/hyperframes/blob/main/LICENSE)**.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.