AI Video Translate

• macOS: phiên bản 11 (Big Sur) trở lên, chip Apple Silicon (M1/M2/M3/M4).
• Windows: Windows 10 hoặc 11, 64-bit.
• Dung lượng trống: khoảng 3–5 GB (cho Python, ffmpeg và model giọng tải về lần đầu).
• Internet: cần cho lần cài đầu tiên (tải Python/model). Sau đó dùng được offline (trừ giọng đọc "Studio" online).

1. Mở file .dmg
   Double-click file vừa tải — một cửa sổ hiện ra với app + thư mục Extension + hướng dẫn.
2. Kéo AI Video Translate vào thư mục Applications
   Đúng kiểu cài app Mac quen thuộc. Xong có thể đẩy (eject) file .dmg.
3. Lần đầu mở: chuột phải app trong Applications → Mở → Mở
   App chưa ký số nên macOS cảnh báo — chỉ cần làm một lần. Lười hơn: double-click Mở lần đầu (gỡ cảnh báo).command ngay trong cửa sổ .dmg, nó tự gỡ cảnh báo.
4. Lần đầu chạy: tự tải model AI (~vài GB)
   Cần mạng, chỉ tải 1 lần. Các lần sau mở từ Launchpad / Applications là vào ngay.
5. Muốn dịch YouTube trực tiếp?
   Kéo thư mục Extension Chrome (dich YouTube) từ cửa sổ .dmg vào Documents rồi xem mục Extension bên dưới.

1. Mở AI-Video-Translate-Setup-windows-x64.exe
   Nếu SmartScreen cảnh báo ("Windows protected your PC") → bấm More info → Run anyway. Cài vào tài khoản của bạn — không cần quyền admin.
2. Next → Install → Finish
   Giữ ô "Cài đặt & chạy ngay" ở bước cuối — app tự mở để cài phần còn lại.
3. Lần đầu: tự cài Python + ffmpeg + model (~vài phút, cần mạng)
   Nếu nó vừa cài Python qua winget và nhắc — đóng cửa sổ rồi mở lại từ icon. Cài xong, icon AI Video Translate nằm sẵn ngoài Desktop + Start Menu.
4. Từ đó: double-click icon là vào app
   Mở thẳng cửa sổ app, không hiện cửa sổ đen. Gỡ app: Settings → Apps → AI Video Translate → Uninstall.
5. Muốn dịch YouTube trực tiếp?
   Start Menu → AI Video Translate - Extension YouTube (mở thư mục) → xem mục Extension bên dưới.

1. Cài Node.js
   Tải bản LTS tại nodejs.org và cài như bình thường.
2. Cài Ollama
   Tải tại ollama.com. Sau đó mở Terminal/CMD chạy: ollama pull qwen2.5:7b (tải model ~4.7 GB).
3. Cài thư viện cho Remotion
   Mở Terminal/CMD, vào thư mục Resources/remotion bên trong app rồi chạy: npm install (chỉ làm một lần).

1. FPT.AI — 9 giọng Việt 3 miền (khuyên dùng · free 100.000 ký tự/tháng)
   Đăng ký tại console.fpt.ai → tạo Project → mở dịch vụ Text to Speech → copy API key. Quan trọng: nhớ bấm Kích hoạt dịch vụ TTS trong console — chưa kích hoạt thì key sẽ báo lỗi "cannot consume this service". Dán key vào ô FPT.AI TTS Key → 💾 Lưu cài đặt.
2. ElevenLabs — 6 giọng tiếng Anh cao cấp (hợp dub Việt → Anh)
   Tạo tài khoản tại elevenlabs.io → menu góc dưới trái → API Keys → tạo key và chọn full quyền → dán vào ô ElevenLabs API Key. Gói Free được ~10.000 ký tự/tháng và không dùng cho video thương mại. Nếu có gói trả phí (Starter trở lên) thì bật thêm được clone giọng qua ElevenLabs ở mục Clone giọng (nguồn).
3. Groq — nghe (ASR) đám mây siêu nhanh (free)
   Lấy key tại console.groq.com → dán vào ô Groq API Key → chuyển Chế độ ASR sang Đám mây · siêu nhanh. Đỡ phải tải ~4.5GB model nghe về máy.
4. OpenAI — nghe chính xác cao (trả phí)
   Lấy key tại platform.openai.com → dán vào ô OpenAI API Key → Chế độ ASR Đám mây · độ chính xác cao.

1. Mở trang tiện ích
   Mở Google Chrome → gõ chrome://extensions vào thanh địa chỉ → Enter.
2. Bật Chế độ nhà phát triển
   Gạt công tắc “Chế độ dành cho nhà phát triển” / Developer mode ở góc trên bên phải.
3. Tải tiện ích đã giải nén
   Bấm “Tải tiện ích đã giải nén” / Load unpacked → chọn thư mục Extension Chrome (dich YouTube). Thư mục này lấy ở đâu? Mac (.dmg): kéo từ cửa sổ .dmg vào Documents trước (dmg chỉ-đọc). Windows (Setup.exe): Start Menu → "AI Video Translate - Extension YouTube (mở thư mục)". Windows (bản nén): nằm cạnh nút cài.
4. Dùng ngay
   Mở app (chạy nền) → vào video YouTube → bấm biểu tượng tiện ích → bật Phụ đề tiếng Việt (hoặc Lồng tiếng nếu đã có license).

Người dùng chỉ cần để ý app + thư mục Extension. Mọi file kỹ thuật đã gom gọn — không cần đụng tới.