Trợ giúp

Có ba dạng, cả ba đều tự chứa — Python, Qt, libmpv và ffmpeg nằm sẵn bên trong bản tải về, nên không phải cài gì thêm bên cạnh.

AppImage — nếu chưa chắc thì lấy bản này. Nó chạy trên mọi bản phân phối:

chmod +x dopeIPTV-*.AppImage
./dopeIPTV-*.AppImage

.deb trên Debian hoặc Ubuntu:

sudo apt install ./dopeiptv_*_amd64.deb

Flatpak:

flatpak install --user dopeIPTV-*.flatpak

Cả ba đều có bản arm64, dùng cho Raspberry Pi hay máy chủ ARM.

Mở tệp .dmg rồi kéo dopeIPTV vào Applications. Cần macOS 15 trở lên và ứng dụng chạy trên Apple Silicon — 1.2.10 là bản cuối cùng còn kèm bản dựng cho Intel.

Lần chạy đầu bị từ chối vì ứng dụng chưa được Apple công chứng. Nhấn chuột phải vào ứng dụng chọn Open, rồi bấm Open lần nữa trong hộp thoại. Nếu vẫn không xong, xem «macOS nói không mở được ứng dụng» ở dưới.

Không có trình cài đặt. Giải nén dopeIPTV-*-windows-x64.zip vào đâu tùy bạn — thư mục người dùng là đủ, không cần quyền quản trị — rồi chạy dopeiptv.exe bên trong.

Có bản arm64 gốc cho laptop Snapdragon; bản x64 cũng chạy được ở đó, nhưng qua giả lập nên chậm hơn.

Muốn có lối tắt ở menu Start hay màn hình nền: Cài đặt → Giao diện → Bảo trì → Tạo lối tắt. Tệp README.txt trong gói nén liệt kê mọi thứ cần xóa nếu bạn muốn gỡ ứng dụng mà không để lại dấu vết.

Ở lần chạy đầu, ứng dụng hỏi ba thứ từ tài khoản Xtream Codes của bạn:

• Máy chủ — địa chỉ kèm cổng, kiểu http://example.com:8080. Không phải đường dẫn danh sách phát đầy đủ, chỉ phần máy chủ.
• Tên đăng nhập và Mật khẩu — do nhà cung cấp cấp cho bạn.

Chúng được lưu lại. Muốn thêm tài khoản khác sau này hoặc sửa cái này: Cài đặt → Danh sách phát. Bạn có thể đổi danh sách phát khi ứng dụng đang chạy, và mục ưa thích cùng lịch sử được giữ riêng cho từng danh sách.

Được. Khi thêm danh sách, chọn M3U rồi dán địa chỉ nhà cung cấp đưa cho bạn.

Tuy vậy tài khoản Xtream khai thác được nhiều hơn — xem lại, hạn dùng tài khoản, lịch phát của chính nhà cung cấp — vì những thứ đó đến từ một API mà danh sách M3U không có. Danh sách M3U vẫn phát được và có thể gán riêng một địa chỉ XMLTV cho lịch phát, bù lại phần lớn khoảng cách.

Được. Trình thiết lập có sẵn kênh dùng thử: vài luồng thử nghiệm miễn phí, công khai của Mux, Apple và Bitmovin, để bạn thấy ứng dụng chạy trước khi gõ bất cứ thứ gì. Đó là luồng thử nghiệm chính thức, không phải dịch vụ truyền hình của ai, và bạn có thể chuyển sang danh sách thật bất cứ lúc nào.

Nhấp đúp trong danh sách ở giữa, hoặc bấm ▶ Phát ở bảng bên phải. Chọn kênh khác thì luồng được thay tại chỗ chứ không tháo trình phát ra dựng lại — vì thế chuyển kênh mới nhanh.

Nút Trước và Tiếp trên thanh trình phát đi qua đúng danh sách bạn đang ở — kênh, các tập của một loạt phim, bản ghi hay lịch sử.

Với phim, tập phim, bản ghi và nội dung xem lại — mọi thứ đã biết thời lượng:

• Đưa con trỏ lên hình, một thanh tua trượt lên, kèm thời gian đã xem và tổng thời lượng cùng nút −10 giây / +30 giây.
• Nhấp một lần vào video rồi dùng phím mũi tên: nhấn một cái nhảy mười giây, giữ thì tua liên tục.

Kênh trực tiếp không tua được và cố ý không hiện thanh tua. Muốn di chuyển bên trong một kênh trực tiếp thì cần timeshift — xem bên dưới.

Nhấp đúp vào hình, hoặc nhấn F. Esc thoát ra — nút Thoát toàn màn hình hiện rõ trên thanh nổi cũng vậy, nó có mặt chính vì để không ai phải biết đến Esc.

Thanh điều khiển và con trỏ chuột tự ẩn sau vài giây không động đậy, và trở lại chỉ với một cử động nhỏ.

Được — tách trình phát ra cửa sổ riêng rồi kéo tới đâu tùy bạn.

Mặc định nó không có khung: kéo ở bất kỳ chỗ nào trên hình để di chuyển. Nhấp phải để chọn luôn ở trên, thanh tiêu đề, hoặc thoát. Esc cũng đưa nó về. Trong lúc đó cửa sổ chính vẫn làm việc bình thường.

Nút ⚙ trên thanh trình phát — nó cũng có trong bộ điều khiển toàn màn hình — chứa mọi thứ liên quan tới luồng bạn đang xem:

• Rãnh tiếng và rãnh phụ đề
• Độ trễ tiếng, khi âm thanh lệch
• Tỷ lệ khung hình (16:9, 4:3, kéo giãn, v.v.)
• Kích thước bộ đệm mạng
• Stats for nerds: codec, độ phân giải, tốc độ khung hình, giải mã phần cứng, đồng bộ tiếng–hình, khung hình rơi, bộ đệm và tốc độ mạng, hiện trực tiếp trên hình

Rãnh bạn chọn được nhớ lại, và trong một loạt phim thì theo sang tập kế tiếp. Nếu muốn đặt một lựa chọn cho mọi luồng, xem phần Cài đặt bên dưới.

• Phím cách — tạm dừng và tiếp tục
• F — toàn màn hình, Esc để thoát
• ← / → — mười giây, giữ để tua tiếp
• M — tắt tiếng

Chúng hoạt động y như nhau ở cửa sổ chính, ở toàn màn hình và ở cửa sổ đã tách.

Có, với phim, tập phim, bản ghi và cả tệp cục bộ của bạn. Mở lại thì nó hỏi bạn muốn xem tiếp từ chỗ đó hay xem lại từ đầu.

Những vị trí rất gần đầu hoặc gần cuối bị bỏ qua có chủ ý, để không đề nghị xem tiếp thứ bạn vừa mới bắt đầu hoặc thực ra đã xem xong.

Từ nhà cung cấp của bạn. Mỗi kênh trực tiếp trong danh sách đều hiện đang phát gì kèm thanh tiến trình, còn bảng chi tiết cho biết cái gì tới sau.

Lịch phát được lưu đệm trên đĩa cho từng danh sách, nên nó có mặt ngay khi bạn mở ứng dụng — bản mới tải ngầm rồi thay thế. Nếu lần tải đó hỏng, bản đã lưu vẫn còn nguyên chứ không để bạn trắng tay.

Có. Nút Lịch phát ở thanh bên mở một bảng lưới chương trình bao trọn mọi kênh, tìm kiếm được, kèm trục thời gian cuộn được. Tìm kiếm sẽ tra một chương trình theo tên trên tất cả các kênh.

Trên kênh có xem lại, nhấp đúp vào một chương trình đã phát sẽ phát nó từ kho lưu.

Hãy cho danh sách đó một lịch phát riêng thay cho lịch của nhà cung cấp:

1. Cài đặt → Danh sách phát
2. Chọn danh sách rồi sửa
3. Điền một địa chỉ XMLTV vào ô lịch phát tùy chỉnh

Nó thay cho thứ nhà cung cấp gửi tới. Ứng dụng ghép kênh của bạn với lịch đó theo mã EPG trước, theo tên kênh sau, nên lịch từ một nguồn khác thường vẫn khớp.

Một số nhà cung cấp công bố giờ không khớp với thứ họ phát thật. Có hai chỉnh sửa tách biệt trong Cài đặt → Phát lại:

• Độ lệch EPG dịch mọi mốc giờ mà lịch phát hiển thị.
• Độ lệch phát lại dịch chỗ mà nội dung xem lại và timeshift bắt đầu phát, không đụng tới lịch.

Chúng tách nhau vì các nhà cung cấp sai ở cái này độc lập với cái kia.

Một số nhà cung cấp giữ bản ghi vài ngày cho mỗi kênh. Ở đâu nhà cung cấp của bạn làm vậy, kênh sẽ có dấu ⏪ trong danh sách, và bảng chi tiết cho biết kho lưu sâu bao nhiêu ngày.

Kênh nào không có dấu thì nhà cung cấp không cấp kho lưu cho kênh đó. Đó là thiết lập bên họ và không gì trong ứng dụng bật lên được.

Bấm nút ⏪ trên trình phát — nó cũng có trong bộ điều khiển toàn màn hình — hoặc nhấp phải lên kênh và chọn Timeshift. Rồi chọn từ đầu.

Thứ đang phát là một khúc trong kho lưu, nên tua được như một bộ phim: cả thanh tua lẫn phím mũi tên đều làm việc bên trong nó.

Được. Menu timeshift liệt kê các chương trình đã qua, nhóm theo ngày — nhấp đúp vào một cái để xem. Bạn cũng có thể lùi theo bước cố định, và các bước ấy co giãn theo độ sâu thật của kho lưu bên nhà cung cấp, từ ba mươi phút tới một tuần.

Một số nhà cung cấp nhận yêu cầu kho lưu rồi lặng lẽ trả về sóng trực tiếp. Ứng dụng kiểm tra điều đó và báo cho bạn, thay vì để bạn tưởng mình đang xem hôm qua.

Hai lối vào:

• Nút REC trên trình phát, cho thứ bạn đang xem.
• Nhấp phải lên kênh bất kỳ → Ghi hình, cho kênh bạn không xem.

Không chọn thời lượng thì nó ghi cho tới khi bạn dừng. Bản ghi có thể xem ngay trong lúc còn đang ghi.

Cả hai. Menu REC có 30 phút, 1, 2 hoặc 4 giờ, còn bản ghi hẹn giờ nhận một giờ bắt đầu và một giờ kết thúc.

Việc đã hẹn sống sót qua lần khởi động lại ứng dụng, nhưng đến giờ thì ứng dụng phải đang chạy — đây là một chương trình, không phải dịch vụ chạy nền. Bản ghi → Đang chạy và đã hẹn cho thấy những gì còn chờ.

Không, nếu bạn ghi chính kênh đang xem: bản ghi rẽ nhánh từ luồng của trình phát, nên không tốn thêm gì và vẫn chạy được trên những tài khoản thường chỉ cho một luồng một lúc.

Nhưng ghi một kênh khác, hay một việc đã hẹn khởi động sau đó, thì có mở kết nối riêng tới nhà cung cấp.

Một điều cần biết về ghi từ trình phát: nó được chốt lại khi ghi dừng, nên dừng phát, chuyển kênh hay lỗi luồng đều kết thúc bản ghi.

Được, ở hai mức. Cài đặt → Ghi hình nhận một giới hạn dung lượng áp cho mọi bản ghi — một con số kèm MB, GB hay TB. Còn menu REC trên trình phát có giới hạn nhanh chỉ cho phiên hiện tại, từ 250 MB tới 10 GB.

Ở nơi bạn đặt trong Cài đặt → Ghi hình. Mục Bản ghi ở thanh bên duyệt qua chúng, với thư mục con đóng vai trò phân loại: tạo thư mục, đổi tên, chuyển qua lại, và chọn nhiều cái để xóa một lượt.

Một cửa sổ riêng hiện 2, 4, 6 hoặc 9 kênh trực tiếp cùng lúc trong một lưới, mỗi ô là một luồng độc lập. Chúng có thể đến từ các danh sách phát khác nhau, thậm chí từ các tài khoản khác nhau.

Mở từ thanh bên; cỡ lưới nằm ở Cài đặt → Xem đa kênh. Nhấp đúp một ô để phóng to nó.

Nhấp vào một ô để trao tiếng cho nó — viền đỏ đánh dấu ô bạn đang nghe.

Nhấp phải lên ô bất kỳ để: tắt tiếng, chọn rãnh tiếng và phụ đề, chuyển chỗ hoặc hoán đổi với ô khác, hay bỏ nó ra. Kênh có xem lại còn có trục thời gian kho lưu riêng ngay trong ô của nó, nên bạn có thể tua lùi một kênh trong khi các kênh khác vẫn trực tiếp.

Vì đúng là như vậy — mỗi ô một kết nối. Phần lớn tài khoản IPTV chỉ cho một hoặc hai luồng cùng lúc, nên lưới chín ô sẽ bị hầu hết nhà cung cấp từ chối thẳng.

Ứng dụng nói điều đó một lần, trước khi bạn phải tự nhận ra qua một bức tường luồng lỗi. Nếu bạn thấy «đã chạm giới hạn kết nối» thì thường là vì thế.

Nhấp phải lên một kênh, phim hay tập phim → Truyền lên Chromecast…, rồi chọn thiết bị. Kênh trực tiếp được gửi dạng HLS, đúng thứ mà bộ nhận Cast chờ đợi.

Truyền sẽ dừng phát tại máy — hai thứ cùng lúc sẽ thành kết nối thứ hai tới nhà cung cấp. Một dải trên trình phát ghi tên thiết bị và nội dung đang chạy, kèm nút dừng. Phát thứ gì đó trong ứng dụng cũng kết thúc việc truyền và trả lại quyền phát.

Có những kênh là video H.264 bình thường nhưng tiếng lại là Dolby Digital Plus. Chromecast không phải Ultra cũng không phải Google TV thì không có bộ giải mã cho thứ đó và từ chối luồng mà không nói vì sao.

Ứng dụng chuyển đổi những trường hợp ấy ngay trên máy này rồi phục vụ kết quả trong mạng của chính bạn: phần hình được chép qua nguyên vẹn — chỉ mã hóa lại phần tiếng, việc này nhẹ — và chỉ xảy ra sau khi thiết bị thực sự từ chối luồng. Kênh nào thiết bị của bạn phát được thì luôn nhận luồng gốc của nhà cung cấp, không đụng chạm.

Việc này cần ffmpeg, và nó nằm sẵn trong mọi bản tải đã đóng gói.

Cài đặt → Trakt. Bạn tạo một ứng dụng trên trakt.tv, dán hai khóa nó cấp, rồi cấp quyền trong trình duyệt vừa mở ra.

Sau đó thứ bạn xem sẽ được ghi nhận, còn danh sách chờ xem và lịch sử thì duyệt được ngay trong ứng dụng. Tệp cục bộ của bạn cũng được ghi nhận, mỗi khi TMDB nhận diện được tệp.

Được. Tệp cục bộ ở thanh bên duyệt các thư mục bạn thêm trong Cài đặt → Tệp cục bộ.

Một chia sẻ mạng mà hệ thống đã gắn kết sẵn sẽ tự hiện ra — gắn kết SMB qua gvfs trên Linux, chia sẻ nằm dưới /Volumes trên macOS, ổ đã ánh xạ trên Windows. Với ứng dụng thì đó chỉ là những đường dẫn bình thường, nên bên trong nó không có sẵn một máy khách SMB nào để mà trục trặc.

Cả hai, đổi qua lại bằng nút ở cột giữa.

• Thư mục hiện cây đúng như trên đĩa.
• Thư viện đọc tên tệp rồi dựng thành loạt phim có mùa và tập, phim lẻ nằm dưới Phim — cùng hình dạng với các mục của nhà cung cấp.

Từ TMDB, cho những gì ghép được theo tên và năm. Thứ không ghép được thì lấy một khung hình cắt ra từ chính video, còn nhạc lấy bìa từ thẻ của tệp hoặc từ ảnh bìa trong thư mục.

Tệp nào tên không có năm và không có thẻ bản phát hành thì không bao giờ bị đoán. Đây là chủ ý: một tấm áp phích sai còn tệ hơn ảnh thu nhỏ. Muốn nó được ghép thì đổi tên tệp cho có năm.

Có. Album được xếp cạnh nhau, nghệ sĩ, album và tên bài lấy từ thẻ, và có một hàng chờ phát: thêm một bài, xếp cả thư mục vào hàng, hoặc cho phát tiếp theo. Hết một bài thì tự sang bài kế.

Còn có bộ hiệu ứng hình ảnh và một bộ chỉnh âm mười dải.

Nó đã bị chuyển đi, bị đổi tên, hoặc chia sẻ của nó chưa được gắn kết. Lịch sử cho biết là trường hợp nào, và đề nghị xóa mục đó, thay vì hỏng mà không nói gì.

Nếu là chia sẻ mạng: gắn kết vào rồi thử lại — mục đó sẽ chạy như trước.

Cài đặt → Giao diện. Giao diện được dịch sang 27 ngôn ngữ và đổi ngay, không cần khởi động lại. Tiếng Ả Rập, Ba Tư, Do Thái và Urdu lật gương toàn bộ bố cục.

Cùng thẻ đó có năm bộ màu và bảy màu nhấn, áp dụng tức thì.

Cài đặt → Phát lại định sẵn những gì nên xảy ra mà không phải bảo lại mỗi lần:

• Ngôn ngữ tiếng ưa dùng
• Phụ đề bật hay tắt, cùng ngôn ngữ ưa dùng thứ nhất và thứ hai
• Tỷ lệ khung hình và bộ đệm mạng mặc định
• Thẻ «Tập tiếp theo» hiện sớm bao nhiêu — tắt, hoặc từ một tới mười phút

Menu ⚙ trên trình phát vẫn ghi đè được bất kỳ mục nào trong số đó cho luồng đang xem.

Được. Một mã PIN bảo vệ các thể loại bị khóa và các nhóm ưa thích bị khóa. Nhóm bị khóa thậm chí không lộ ra trong đó có kênh nào cho tới khi nhập mã — nó giấu nội dung, chứ không chỉ chặn phát.

Mã PIN được lưu dạng băm có muối, không lưu dưới dạng chữ thường.

Nhấp phải lên kênh, phim hay loạt phim bất kỳ để đổi tên hoặc ẩn. Kết quả trên thực tế là một danh sách phát do chính bạn biên tập, lưu riêng cho từng danh sách, còn Khôi phục kênh mặc định… đưa mọi thứ về đúng như nhà cung cấp gửi.

Cả một thể loại cũng ẩn được, đổi tên được hoặc khóa được từ menu chuột phải của thể loại. Kênh trong thể loại bị ẩn cũng không xuất hiện trong «Tất cả».

Thêm bao nhiêu danh sách tùy bạn trong Cài đặt → Danh sách phát và chuyển qua lại khi ứng dụng đang chạy. Mỗi danh sách giữ riêng mục ưa thích, lịch sử, kênh đã ẩn và tên đã đổi.

Mỗi danh sách cũng có thể có địa chỉ XMLTV riêng và lịch làm mới riêng — không bao giờ, khi khởi động, mỗi 2, 6 hay 12 giờ, hằng ngày hoặc hằng tuần.

Nhật ký là thứ biến «không chạy» thành cái sửa được, và thông tin đăng nhập bị che đi tự động, nên đính kèm vào một issue là an toàn.

Chạy ứng dụng từ terminal với biến DOPEIPTV_LOG_FILE đã đặt, nó sẽ ghi thêm nhật ký ra đó ngoài phần in ra màn hình.

Linux — AppImage

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log ./dopeIPTV-*.AppImage

Linux — .deb hoặc pipx

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log dopeiptv

macOS

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log \
  /Applications/dopeIPTV.app/Contents/MacOS/dopeiptv

Windows — PowerShell, trong thư mục vừa giải nén

$env:DOPEIPTV_LOG_FILE="$env:TEMP\dopeiptv.log"
.\dopeiptv.exe

Tái hiện lại sự cố, đóng ứng dụng, rồi đính kèm tệp đó. Muốn chi tiết hơn nhiều thì thêm DOPEIPTV_LOG=debug vào trước cùng câu lệnh ấy.

Chạy nó từ terminal — câu trả lời ở trên có lệnh chính xác cho hệ thống của bạn — rồi đọc những gì nó in ra. Phần lớn trường hợp nguyên nhân nằm ngay ở đó.

Các bản đã đóng gói mang theo mọi thứ chúng cần. Nếu bạn cài từ mã nguồn bằng pipx thì cần thêm mpv và ffmpeg của bản phân phối:

sudo apt install mpv ffmpeg     # Debian/Ubuntu
sudo dnf install mpv ffmpeg     # Fedora
sudo pacman -S mpv ffmpeg       # Arch

Trình phát tích hợp không lấy được bề mặt để vẽ video.

1. Mở ⚙ → Stats for nerds và xem có khung hình nào tới không — điều đó tách vấn đề luồng khỏi vấn đề hiển thị.
2. Trên Wayland, thử Cài đặt → Phát lại → Chạy qua backend X11 rồi khởi động lại ứng dụng.
3. Chạy từ terminal và tìm những dòng nhắc tới GL hay mpv.

Nó chưa được Apple công chứng. Nhấp phải vào ứng dụng chọn Open, rồi Open trong hộp thoại — hoặc cho phép trong System Settings → Privacy & Security → Open Anyway.

Nếu macOS lại nói ứng dụng «bị hỏng» thì đó là cờ cách ly do lần tải về gắn vào. Gỡ nó đi:

xattr -dr com.apple.quarantine /Applications/dopeIPTV.app

Không cảnh báo nào trong hai cái đó có nghĩa là ứng dụng có vấn đề — chỉ là bản dựng chưa ký, mà ký thì cần một chứng chỉ Apple có phí.

SmartScreen không nhận ra nhà phát hành, vì bản dựng chưa ký — việc đó cần chứng chỉ có phí. Bấm More info, rồi Run anyway.

Báo động nhầm. Hai nguyên nhân của nó đã được xử lý trong 1.2.10: phần khởi chạy nay được biên dịch từ mã nguồn thay vì là tệp dựng sẵn mà các máy quét virus có sẵn chữ ký, và tệp thực thi mang một tài nguyên phiên bản đúng nghĩa.

Nếu máy quét của bạn vẫn đánh dấu, hãy cho phép thư mục đó trong phần mềm diệt virus và báo cáo báo động nhầm cho Microsoft — đó mới là thứ rốt cuộc xử lý được cho tất cả mọi người, không riêng bạn.

Ứng dụng dò hỏi nhà cung cấp rồi nói rõ lý do bằng lời dễ hiểu thay vì quăng ra một lỗi trơ: tài khoản hết hạn, chạm giới hạn kết nối, không có luồng, không tới được máy chủ, v.v.

Nếu các kênh khác phát được thì vấn đề nằm ở kênh đó. Nếu không kênh nào phát được, hãy xem Cài đặt → Danh sách phát — bảng tài khoản hiện ngày hết hạn và số kết nối được phép.

Tài khoản của bạn cho một số luồng cùng lúc và tất cả đang bận. Theo thứ tự khả năng:

1. Xem đa kênh đang mở — mỗi ô là một kết nối.
2. Đang ghi hình một kênh khác.
3. Thiết bị khác hoặc người khác đang dùng tài khoản.
4. Một phiên trước chưa hết hạn bên nhà cung cấp; chờ một phút thường là xong.

Ghi chính kênh bạn đang xem thì không tính là kết nối thứ hai.

Trên Wayland, GNOME và KDE lấy biểu tượng của cửa sổ từ một mục desktop khớp với nó và bỏ qua thứ mà chương trình tự đặt. AppImage không có mục như vậy cho tới khi có thứ gì đó cài nó vào.

1. Ứng dụng đề nghị thêm một mục ngay lần chạy đầu. Hãy đồng ý — rồi khởi động lại ứng dụng, vì cửa sổ đang mở vẫn giữ biểu tượng lúc nó mở ra.
2. Nếu bạn đã từ chối, chính công tắc đó nằm ở Cài đặt → Phát lại.
3. Nếu biểu tượng vẫn không hiện, một bộ đệm biểu tượng cũ đang che nó. GTK đọc tệp đó thay vì quét thư mục:

rm ~/.local/share/icons/hicolor/icon-theme.cache

Cài từ .deb thì mục đó đã có sẵn và không điều nào ở trên áp dụng.

Tùy chọn ấy khởi chạy một mpv hoặc vlc riêng của hệ thống, nên một trong hai phải được cài — trình phát tích hợp không cần gì thêm và không dính dáng gì.

sudo apt install mpv vlc        # Debian/Ubuntu
sudo dnf install mpv vlc        # Fedora
sudo pacman -S mpv vlc          # Arch