🎤 Hướng dẫn cài đặt Karaoke Kiosk

Làm theo các bước dưới đây, mất khoảng 10–15 phút. Nếu bạn chưa quen dòng lệnh, nhắn Zalo/SĐT cho chúng tôi để được hỗ trợ trực tiếp.

⚖️ Lưu ý về bản quyền: Nếu dùng để kinh doanh (quán karaoke, phòng hát thu phí...), quý khách tự chịu trách nhiệm xin phép & trả phí tác quyền âm nhạc (VCPMC, RIAV...) theo quy định pháp luật Việt Nam — sản phẩm chỉ là công cụ điều khiển/kiosk, không bao gồm giấy phép biểu diễn công khai.
Cần chuẩn bị trước: 1 TV Box hoặc mini PC đã cài sẵn Debian, Ubuntu hoặc Armbian, có kết nối mạng, và có quyền truy cập dòng lệnh (SSH hoặc màn hình + bàn phím cắm trực tiếp vào thiết bị).
1

Kết nối vào thiết bị

Cắm bàn phím + màn hình vào TV Box/mini PC (hoặc SSH từ máy tính khác vào thiết bị nếu bạn đã bật SSH sẵn).

2

Chạy lệnh cài đặt

Mở cửa sổ dòng lệnh (Terminal) trên thiết bị, dán đúng lệnh riêng của bạn (gửi kèm theo sau khi thanh toán, ở trang mua hàng — lệnh đó có thêm mã license LIC-XXXXXXXX để tự kích hoạt) rồi nhấn Enter. Lệnh bên dưới chỉ là ví dụ minh hoạ chung, chạy sẽ cài được nhưng máy sẽ ở chế độ dùng thử 7 ngày thay vì kích hoạt vĩnh viễn:

curl -fsSL https://karaoke.orvane.vn/downloads/install.sh | sudo LICENSE_KEY=LIC-XXXXXXXX bash

Quá trình cài sẽ mất 3–10 phút tuỳ tốc độ mạng. Script tự tải và cài mọi thứ cần thiết, bạn không cần làm gì thêm trong lúc chờ.

Về mã license: mỗi lần mua, bạn nhận 1 mã license dùng kích hoạt được đúng số thiết bị đã mua (mua 1 → kích hoạt 1 máy, mua 5 → kích hoạt 5 máy). Không có mã license hợp lệ, thiết bị chỉ chạy thử miễn phí 7 ngày rồi tự khoá màn hình, hiện QR để quét mua. Nếu cần kích hoạt máy khác bằng mã cũ khi máy đầu hỏng/thay thiết bị, nhắn Zalo cho chúng tôi hỗ trợ.
3

Khởi động lại thiết bị

Sau khi script báo "Cài đặt xong", gõ lệnh:

sudo reboot

Thiết bị sẽ tự khởi động vào thẳng màn hình karaoke (hiện mã QR) — không cần đăng nhập hay làm gì thêm.

4

Dùng thử

Lấy điện thoại quét mã QR hiện trên màn hình TV → tìm bài hát → bấm "Thêm" → bấm "▶ Bắt đầu" trên điện thoại. Bài hát sẽ tự phát trên TV.

⚠️ Thiết bị chạy ở chế độ dùng thử (trial) ngay sau khi cài. Khi hết hạn dùng thử, màn hình TV sẽ tự hiện mã QR để gia hạn — quét mã đó để thanh toán và kích hoạt tiếp.

Câu hỏi thường gặp

Chạy lệnh báo "command not found: curl" hoặc "sudo: command not found"?

Thiết bị của bạn thiếu gói cơ bản. Chạy apt-get update && apt-get install -y curl sudo trước (có thể cần đăng nhập bằng user root), rồi thử lại bước 2.

Script báo "chỉ hỗ trợ hệ điều hành dựa trên Debian/Ubuntu"?

Thiết bị của bạn không chạy hệ điều hành dựa trên Debian (vd: Android TV gốc, không phải bản Debian/Armbian). Rất tiếc gói phần mềm này không cài được trực tiếp lên Android TV gốc — cần một thiết bị chạy được Debian/Ubuntu/Armbian thật sự (TV Box "chạy Linux", Raspberry Pi, hoặc mini PC x86).

Không tìm được Chromium chạy được, dù script đã thử cài?

Một số thiết bị tối giản thiếu linh kiện cần cho Chromium/snap. Cài Chromium (hoặc trình duyệt Chromium-based bất kỳ) tay, rồi chạy lại: sudo CHROMIUM_BIN_OVERRIDE=/đường/dẫn/tới/chromium bash install.sh. Nhắn Zalo nếu cần hỗ trợ xác định đường dẫn.

Khởi động lại nhưng không tự vào màn hình karaoke?

Kiểm tra: (1) thiết bị có đang đăng nhập tự động vào user kiosk trên tty1 không — nếu thiết bị đã có sẵn một trình quản lý đăng nhập khác (display manager), có thể nó đang xung đột; (2) chạy sudo systemctl status cron để xem watchdog có chạy không. Nhắn Zalo gửi kèm ảnh chụp màn hình lỗi để được hỗ trợ nhanh.

Muốn cài cho nhiều thiết bị cùng lúc (quán karaoke nhiều phòng)?

Mua đúng số lượng phòng/thiết bị bạn cần — bạn sẽ nhận 1 mã license dùng được đúng từng đó máy. Chạy lệnh cài (kèm mã license đó) trên mỗi thiết bị là xong, mỗi máy tự kích hoạt 1 suất trong mã, không cần làm gì thêm. Nếu dùng ảnh nhân bản (Clonezilla...) để cài hàng loạt, nhắn Zalo để được hướng dẫn tránh trùng mã thiết bị.

Lỡ có file/lệnh cài rồi thì đem cài cho máy khác không trả tiền được không?

Không. Lệnh cài đặt chỉ là bước dựng trình duyệt trỏ về hệ thống của chúng tôi — phần mềm thật sự chạy trên máy chủ, không nằm trên thiết bị. Mỗi mã license chỉ kích hoạt được đúng số máy đã mua; cài thêm máy không có mã (hoặc mã đã dùng hết suất) sẽ chỉ chạy thử 7 ngày rồi tự khoá, không "dùng chùa" lâu dài được.

Mở quán karaoke kinh doanh có cần xin phép gì thêm không?

Có. Mua/dùng phần mềm này chỉ là công cụ kỹ thuật, không bao gồm quyền biểu diễn công khai. Theo luật sở hữu trí tuệ Việt Nam, kinh doanh có phát nhạc có bản quyền cho khách nghe/hát (quán karaoke, phòng hát thu phí...) là hành vi "biểu diễn công khai" — chủ kinh doanh phải tự xin phép và trả phí tác quyền cho các tổ chức giữ quyền (VCPMC cho quyền tác giả, RIAV cho quyền liên quan bản ghi), tương tự như khi dùng đầu karaoke, TV hay bất kỳ nguồn nhạc nào khác để kinh doanh.

Cần hỗ trợ thêm? Liên hệ qua số điện thoại/Zalo bạn đã cung cấp lúc đặt mua — chúng tôi trả lời trong giờ làm việc.