Chuyển đến nội dung chính
Phần mềm nQivi Studio Client chạy cục bộ trên máy tính của bạn nhằm bảo vệ tối đa quyền riêng tư dữ liệu và tận dụng sức mạnh phần cứng của bạn để render video nhanh hơn. Để lắp ghép và xử lý video/hình ảnh, phần mềm bắt buộc phải sử dụng hai công cụ mã nguồn mở phổ biến: ImageMagick và FFmpeg. Làm theo các bước dưới đây để chuẩn bị môi trường chạy phần mềm.

🛠️ Hướng dẫn cài đặt theo Hệ điều hành

1. Cài đặt ImageMagick (Bắt buộc để xử lý chữ và phụ đề)

  1. Tải bộ cài đặt chính thức từ trang chủ ImageMagick: 👉 Tải ImageMagick cho Windows
  2. Chạy file cài đặt .exe vừa tải về.
  3. QUAN TRỌNG: Trong quá trình cài đặt, hãy chắc chắn tích chọn ô “Install legacy utilities (e.g. convert)”. Nếu bỏ qua tùy chọn này, nQivi Studio sẽ không thể kết xuất các phân đoạn văn bản/phụ đề chữ lên video.

2. Cài đặt FFmpeg

  1. Tải gói cài đặt tự động FFmpeg: 👉 Tải FFmpeg (Click chọn file FFmpeg_Full.msi)
  2. Chạy file .msi vừa tải. Bộ cài này sẽ tự động giải nén và cấu hình biến môi trường (PATH) của hệ thống để phần mềm có thể nhận diện FFmpeg ngay lập tức.

🚀 Khởi chạy Phần mềm Client

Sau khi đã hoàn thành việc cài đặt các công cụ phụ thuộc trên:
  1. Nhấp đúp chuột vào file chạy phần mềm nQivi Studio (hoặc phím tắt khởi động trên desktop) để kích hoạt máy chủ Gradio cục bộ.
  2. Một cửa sổ dòng lệnh đen (Terminal) sẽ mở ra báo hiệu phần mềm đang khởi động.
  3. Khi khởi động xong, hãy mở trình duyệt web của bạn và truy cập địa chỉ: 👉 http://127.0.0.1:8386 (hoặc cổng kết nối tùy chỉnh hiển thị trên màn hình terminal của bạn).
[!TIP] Nếu bạn gặp phải lỗi render phụ đề hoặc chữ bị biến dạng, hãy kiểm tra xem đường dẫn ImageMagick đã được tick cài đặt legacy chưa và khởi động lại máy tính của bạn để áp dụng các thay đổi đường dẫn môi trường (PATH variable).