Hướng dẫn sử dụng ReviewFilm Studio

Công cụ biến một bộ phim (phim lẻ hoặc cả bộ nhiều tập) thành video Recap (kể lại cốt truyện) hoặc Review (phê bình, chấm điểm) hoàn chỉnh. AI nghe và xem phim, viết lời bình, lồng tiếng, dựng hình theo lời kể; công cụ xuất video YouTube 16:9, clip ngắn 9:16, thumbnail, phụ đề và gói SEO.

1. Giới thiệu

Hai loại video

Tính năng chính

• AI viết lời bình từ lời thoại (nhận dạng giọng nói) và hình ảnh (AI mô tả khoảng 240 khung hình của phim).
• Phim dài và phim bộ: AI tóm tắt từng phần 20 phút, lập dàn ý và bảng nhân vật, rồi viết từng chương nối tiếp nhau.
• Ước tính chi phí và thời gian trước khi chạy; sau khi chạy có chi phí thực tế để đối chiếu.
• Xử lý nhiều video song song, tự chia việc theo cấu hình máy.
• Trình biên tập kịch bản: sửa lời bình, khoảng phim minh họa, thêm/bớt/đổi thứ tự đoạn, nghe thử giọng.
• Đầu ra: video 16:9, clip ngắn 9:16 có câu hook, 3 thumbnail, phụ đề .srt, SEO YouTube (kèm mục lục chương) và TikTok; logo, thanh tiêu đề, watermark, nhạc nền tùy chọn.

2. Cài đặt & khởi động

Yêu cầu

Chạy công cụ

cd D:\MySelf\ReviewFilmTools
npm install        (chỉ lần đầu)
npm start

Mở http://localhost:3210. Cửa sổ dòng lệnh phải để mở trong lúc dùng; đóng cửa sổ là tắt công cụ (video đang chạy sẽ ở trạng thái “Bị gián đoạn”, mở lại rồi bấm ↻ Chạy tiếp).

3. Làm video từ A đến Z

1. Thêm phim. Trên trang Dự án:
   • Phim trên máy (khuyên dùng): dán đường dẫn file vào ô “Dùng file / thư mục có sẵn trên máy”, ví dụ D:\Phim\chuyen-xom-tui.mp4, rồi bấm Thêm. File được dùng tại chỗ, không sao chép.
   • Phim bộ: dán đường dẫn thư mục chứa các tập (xem mục 6).
   • Hoặc kéo thả / bấm Chọn video để tải lên (tạo bản sao trong storage/).

   

2. Cấu hình & xem ước tính. Bấm Mở trên thẻ video, tab Cấu hình & ước tính:
   • Loại video: Recap hoặc Review.
   • Tên phim (dùng cho lời bình, thumbnail, SEO) và phong cách lời bình: Kịch tính / Trung lập / Hài hước / Bí ẩn.
   • Ngôn ngữ thoại trong phim – chọn đúng để nhận dạng giọng nói chính xác – và ngôn ngữ lời bình.
   • Thời lượng mục tiêu: 5 / 10 / 15 / 30 / 45 / 60 phút hoặc tự nhập số giây.
   • Phạm vi phân tích: bỏ qua đoạn giới thiệu, quảng cáo, credits để tiết kiệm thời gian.
   • Ghi chú cho AI: tên phim gốc, tên nhân vật, điều muốn nhấn mạnh.
   • Dịch vụ AI cho từng bước, kèm nhãn Miễn phí Free-tier (cần key) Trả phí; giọng đọc, tốc độ đọc, nút nghe thử.
   • Xuất video: 16:9 và/hoặc 9:16, phụ đề, hiệu ứng, video dọc (tự động / toàn bộ / clip ngắn), bộ nhận diện kênh, nhạc nền, tự động render.
   Khung Ước tính trước khi chạy bên phải cập nhật ngay khi đổi tùy chọn: chi phí từng bước (USD/VNĐ), số chương và lượt gọi AI, thời gian dự kiến trên máy của bạn.

   

   Bấm ▶ Bắt đầu phân tích.
3. Theo dõi tiến trình. Tab Tiến trình có thanh tiến độ, nhật ký từng bước, chi phí ước tính/thực tế. Bấm ■ Hủy để dừng ngay; bấm ↻ Chạy tiếp để tiếp tục sau khi lỗi, hủy hoặc tắt máy. Các bước đã xong (lời thoại, cắt cảnh, mô tả hình ảnh, giọng đọc) được lưu lại và dùng lại, không phải làm lại.

   

4. Duyệt & sửa kịch bản. Phân tích xong, trạng thái chuyển sang Chờ duyệt kịch bản. Tab Kịch bản:
   • Cột trái: trình phát phim gốc, tóm tắt (logline), toàn bộ lời thoại gốc – bấm một dòng để tua tới đó.
   • Cột phải: các đoạn lời bình theo thứ tự trong video, nhóm theo chương. Mỗi đoạn có ảnh cảnh, khoảng phim minh họa (mm:ss.s → mm:ss.s), lời bình, lý do AI chọn cảnh và lời thoại gốc của khoảng đó.
   • Nút trên mỗi đoạn: ⤓ lấy thời điểm đang xem, ▶ Xem, 🔊 nghe thử, ↑ ↓ đổi thứ tự, ✕ xóa.
   • Nhãn xanh “dựng montage ~N shot” = khoảng phim dài hơn lời đọc, sẽ được cắt thành nhiều shot ngắn. Nhãn vàng = khoảng phim ngắn hơn lời đọc, hệ thống kéo dài hoặc làm chậm hình.
   • Để trống lời bình = trích nguyên câu thoại gốc (kèm phụ đề).
   • ＋ Thêm đoạn tại vị trí đang xem: tua tới cảnh cần dùng rồi bấm.
   • Thanh trên cùng cho biết số đoạn và thời lượng dự kiến so với mục tiêu.

   

   Bấm Lưu để lưu nháp, hoặc ▶ Lưu & Render.
5. Render. Công cụ tạo giọng đọc cho từng đoạn, dựng hình theo lời kể, chèn phụ đề, rồi ghép thành video. Đoạn giọng đã tạo được giữ lại nếu bạn sửa kịch bản và render lại.

   

6. Nhận kết quả. Tab Kết quả:
   • Video YouTube 16:9 và các clip ngắn 9:16 (xem trực tiếp, nút Tải).
   • SEO YouTube: tiêu đề, mô tả (đã kèm mục lục chương), tags; SEO TikTok: tiêu đề, caption, hashtag – mỗi mục có nút Sao chép.
   • 3 thumbnail (bấm ảnh để tải), bảng mục lục chương, phụ đề .srt, kịch bản .json, SEO .json, thời lượng và chi phí thực tế.

   

   

   

4. Ví dụ thực tế: “Chuyện Xóm Tui” → Recap 15 phút

Lần chạy dùng để chụp các ảnh trong tài liệu này. Phim lẻ 1 giờ 31 phút 50 giây, 640×338, chạy trên laptop i7-1185G7 (4 nhân / 8 luồng, 16 GB RAM, không card rời), chỉ dùng dịch vụ miễn phí: Whisper local + Gemini (key miễn phí) + Edge TTS.

5. Xử lý nhiều video cùng lúc

1. Thêm nhiều phim một lần (chọn nhiều file, hoặc dán nhiều đường dẫn cách nhau bằng ;). Video mới được tự động chọn và hiện khung “Cấu hình chung cho N video đã chọn”.
2. Chọn cấu hình chung. Bảng ước tính hiển thị tổng chi phí cả lô và so sánh thời gian chạy tuần tự với song song.
3. Bấm ▶ Bắt đầu N video. Muốn đặt tên phim / phạm vi riêng: mở từng video để chỉnh trước.

Công cụ chia mỗi video thành từng loại công việc, mỗi loại có số luồng riêng: trong khi video A đang nhận dạng giọng nói, video B có thể cắt cảnh và video C đang render.

6. Phim bộ nhiều tập → 1 video dài

Cách các kênh recap làm video 30–60 phút cho cả bộ phim: tải các tập về máy rồi gộp lại kể thành một câu chuyện liền mạch.

1. Đặt các tập vào một thư mục, tên file có số tập: Tên phim Tập 01.mp4, tap-2.mkv, EP03, S01E04… Công cụ sắp đúng thứ tự (tập 10 sau tập 9).
2. Tạo dự án: dán đường dẫn thư mục vào ô “Dùng file / thư mục có sẵn trên máy” rồi bấm Thêm. Hoặc chọn nhiều file và tích “Các file là các tập của cùng 1 phim bộ”.
3. Cấu hình: Recap/Review, thời lượng 30 / 45 / 60 phút; nhập số giây bỏ qua ở đầu và cuối mỗi tập (nhạc mở đầu, tóm tắt tập trước, credits); điền tên các nhân vật chính trong Ghi chú cho AI.
4. AI viết theo chương: tóm tắt từng tập (tập dài chia mỗi 20 phút) → dàn ý cả bộ với bảng nhân vật thống nhất → viết từng chương nối tiếp.
5. Duyệt: mỗi đoạn có ô Tập (lấy hình từ tập nào); trình phát bên trái có ô chọn tập.
6. Kết quả: 1 video 16:9 dài, mục lục chương trong mô tả YouTube, clip ngắn 9:16 và 3 thumbnail.

7. Nhận diện kênh, thumbnail, nhạc nền, clip ngắn

Bộ nhận diện kênh (Cài đặt → Bộ nhận diện kênh)

• Logo PNG nền trong suốt: chọn góc đặt và kích thước.
• Thanh tiêu đề ở đáy, ví dụ Review Phim: {title} – {title} được thay bằng tên phim và tô màu nổi bật.
• Watermark chữ mờ (ví dụ @TenKenh) để hạn chế bị reup.
• Mỗi video có ô “Dùng bộ nhận diện kênh” để bật/tắt.

Thumbnail tự động

Mỗi video có 3 thumbnail 1280×720 từ các khung hình AI chọn: câu giật tít ở trên (một phần tô vàng), chữ dán cảm xúc, thanh tên phim ở dưới. Bấm ảnh trong tab Kết quả để tải.

Nhạc nền

Tải nhạc trong Cài đặt → Thư viện nhạc nền, rồi chọn nhạc và âm lượng trong cấu hình video. Nhạc tự lặp hết video và tự nhỏ đi khi có lời bình hoặc thoại. Chỉ dùng nhạc bạn có quyền sử dụng.

Clip ngắn 9:16

Mục Video dọc 9:16: Tự động (video ≤ 3 phút xuất bản dọc đầy đủ, dài hơn thì cắt clip), Toàn bộ, hoặc Clip ngắn kèm số clip. Clip dài 45–90 giây, lấy từ những chương AI đánh giá hấp dẫn nhất, có câu hook ở trên – dùng đăng TikTok/Shorts/Reels dẫn về video chính.

8. Dịch vụ AI & chi phí

Gemini key miễn phí + Whisper local + Edge TTS = 0đ. Khi dùng dịch vụ trả phí, khoản lớn nhất thường là giọng đọc (recap 15 phút ≈ 15.000 ký tự).

9. API key & trang Cài đặt

Vào Cài đặt → API keys, dán key và bấm Lưu cài đặt. Key chỉ lưu trên máy (storage/settings.json) và chỉ gửi tới đúng nhà cung cấp của key đó.

Dùng Ollama thay Gemini (tùy chọn)

Cài Ollama, chạy ollama pull qwen2.5:7b (~4,7 GB; thêm qwen2.5vl:7b nếu muốn phân tích hình ảnh), rồi chọn AI viết kịch bản = Ollama. Trên máy không có card đồ họa rời, model 7B viết chậm (một recap 10 phút mất 20–30 phút) và tiếng Việt kém Gemini rõ rệt.

10. Cấu hình máy & hiệu năng

Công thức ước tính cho một video

Thời gian ≈ Tách audio      (~0,003 × thời lượng phim)
          + max( Cắt cảnh   (~0,02–0,1 × thời lượng phân tích),
                 Whisper    (~0,3–0,5 × thời lượng phân tích) )   ← chạy song song
          + Vision         (2–15 phút cho 240 khung với Gemini, tùy mức quá tải)
          + AI kịch bản    (1–3 phút với Gemini)
          + Lồng tiếng     (~8 giây / 1 phút lời bình, Edge TTS)
          + Render         (~0,55 × thời lượng video 16:9, + clip ngắn)

Số liệu đo trên laptop i7-1185G7 (4 nhân/8 luồng, 16 GB RAM, không card rời) – xem bảng chi tiết ở mục 4. Công cụ tự hiệu chỉnh các hệ số sau mỗi lần chạy, nên ước tính ngày càng sát với máy của bạn.

Bộ nhớ & ổ đĩa

Cấu hình khuyến nghị

• Số luồng Whisper ≈ min(số luồng CPU ÷ 6, (RAM − 4 GB) ÷ 2,5). Nhiều hơn chỉ làm chậm vì tranh CPU.
• Số luồng render ≈ số luồng CPU ÷ 4. Có GPU: đổi Bộ mã hóa sang h264_nvenc (NVIDIA), h264_qsv (Intel) hoặc h264_amf (AMD) để render nhanh gấp 2–4 lần.
• Trang Cài đặt tự đọc CPU/RAM và gợi ý số luồng; bấm Áp dụng rồi Lưu cài đặt.
• Điểm nghẽn lớn nhất là Whisper trên CPU: muốn nhanh rõ rệt, dùng Groq STT thay vì nâng cấp máy.

11. File kết quả

Mỗi video có thư mục riêng storage/jobs/<mã-video>/:

source.mp4 / ep01.mp4…        Phim gốc (chỉ khi tải lên qua trình duyệt)
analysis/e0, e1…/             Mỗi tập: lời thoại, cắt cảnh, viền đen, mô tả hình ảnh (được dùng lại)
tts/                          Giọng đọc từng đoạn (dùng lại nếu lời bình không đổi)
output/review_16x9.mp4        Video YouTube
output/review_9x16.mp4        Video dọc đầy đủ (video ≤ 3 phút hoặc chọn “Toàn bộ”)
output/short_1_9x16.mp4…      Clip ngắn TikTok / Shorts / Reels
output/thumbnail_1..3.jpg     3 thumbnail 1280×720
output/subtitles.srt          Phụ đề để tải lên YouTube
output/script.json            Kịch bản: chương, nhân vật, các đoạn (tập, mốc thời gian, lời bình)
output/seo.json               Tiêu đề, mô tả (kèm mục lục chương), tags, hashtag

Xóa video trong giao diện sẽ xóa cả thư mục này. File phim gốc thêm bằng đường dẫn trên máy thì không bị đụng tới.

12. Câu hỏi thường gặp & xử lý lỗi

“Không tìm thấy FFmpeg”

Chưa cài FFmpeg hoặc chưa thêm vào PATH. Hoặc nhập đường dẫn đầy đủ (ví dụ C:\ffmpeg\bin\ffmpeg.exe) trong Cài đặt → FFmpeg.

Nhận dạng giọng nói rất lâu / đứng ở một mức %

• Whisper local cần khoảng 0,3–0,5 × thời lượng phim: phim 1,5 giờ mất 30–50 phút. Thanh tiến độ tăng khoảng 1% mỗi 30–40 giây là bình thường.
• Nếu một đoạn audio bị kẹt quá 5 phút (thường do cảnh la hét, nhạc lặp), video dừng với lỗi “Whisper local bị treo ở đoạn …”. Bấm ↻ Chạy tiếp hoặc chuyển sang Groq STT.
• ■ Hủy dừng video ngay; luồng Whisper làm nốt đoạn 28 giây đang dở rồi tự nghỉ.

Lời thoại nhận dạng sai nhiều

• Chọn đúng ngôn ngữ thoại trong phim.
• Đổi model sang Large v3 Turbo (chậm hơn) hoặc dùng Groq STT (chính xác và nhanh).
• Công cụ đã tự loại các câu Whisper hay “bịa” khi gặp nhạc nền (ví dụ “Hãy subscribe cho kênh…”).

Lời bình kể sai, thiếu hoặc lặp ý

• Bật Phân tích hình ảnh để AI “thấy” các cảnh ít thoại.
• Điền Ghi chú cho AI: tên nhân vật, bối cảnh; đặt Phạm vi phân tích bỏ phần quảng cáo/credits.
• Khi Gemini chính quá tải, công cụ tự dùng model Lite – văn ngắn và đôi khi lặp ý giữa hai chương. Sửa/xóa đoạn trong tab Kịch bản, hoặc bấm ▶ Chạy lại phân tích lúc khác (chỉ chạy lại phần AI, mất vài phút).

Video ngắn hơn mục tiêu

AI tự viết thêm khi kịch bản ngắn hơn ~80% mục tiêu. Video thực tế còn ngắn hơn kịch bản một chút nếu tốc độ đọc > 1,0×. Muốn dài hơn: tăng thời lượng mục tiêu hoặc giảm tốc độ đọc.

Phim đã có phụ đề in sẵn

Phụ đề lời bình nằm ở cuối khung hình nên có thể sát phụ đề gốc của phim. Có thể bỏ tích “Chèn phụ đề lời bình vào video” và tải subtitles.srt lên YouTube thay thế.

“Gemini … lỗi 429 / 503” trong nhật ký

Free-tier Gemini giới hạn số lần gọi mỗi phút/ngày và hay quá tải giờ cao điểm. Công cụ tự chờ, thử lại và chuyển sang model dự phòng trong 10 phút. Nếu video vẫn dừng ở Lỗi: kiểm tra key / hạn mức rồi bấm ↻ Chạy tiếp.

“Edge TTS lỗi”

Dịch vụ giọng đọc miễn phí đôi khi ngắt kết nối; công cụ đã tự thử lại 6 lần. Kiểm tra Internet rồi bấm ↻ Chạy tiếp – các đoạn giọng đã tạo được giữ lại. Có thể giảm Gọi API trong Cài đặt xuống 2.

Tắt máy / đóng cửa sổ dòng lệnh khi đang chạy

Mở lại bằng npm start; video ở trạng thái Bị gián đoạn. Bấm ↻ Chạy tiếp: các bước đã xong được dùng lại.

Video 9:16 bị nhân vật lệch khỏi khung

Chế độ Cắt giữa luôn lấy phần giữa khung hình. Với cảnh nhân vật đứng lệch, dùng Nền mờ (giữ trọn khung).

Bản quyền nội dung

Hãy đảm bảo bạn có quyền sử dụng phim và tuân thủ chính sách của YouTube / TikTok khi đăng tải.