Справка

Три формата, и все самодостаточные — Python, Qt, libmpv и ffmpeg лежат внутри загружаемого файла, так что рядом ничего ставить не нужно.

AppImage — берите его, если сомневаетесь. Работает на любом дистрибутиве:

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

.deb на Debian или Ubuntu:

sudo apt install ./dopeiptv_*_amd64.deb

Flatpak:

flatpak install --user dopeIPTV-*.flatpak

У всех трёх есть сборки arm64 — для Raspberry Pi или ARM-сервера.

Откройте .dmg и перетащите dopeIPTV в «Программы». Нужен macOS 15 или новее, приложение работает на Apple Silicon — 1.2.10 была последней версией со сборкой для Intel.

Первый запуск будет отклонён, потому что приложение не нотаризовано Apple. Щёлкните по нему правой кнопкой, выберите Открыть, затем ещё раз Открыть в диалоге. Если это не помогло, смотрите «macOS сообщает, что приложение нельзя открыть» ниже.

Установщика нет. Распакуйте dopeIPTV-*-windows-x64.zip куда угодно — папки пользователя достаточно, права администратора не нужны — и запустите лежащий внутри dopeiptv.exe.

Есть родная сборка arm64 для ноутбуков на Snapdragon; сборка x64 там тоже работает, но через эмуляцию и потому медленнее.

Ярлык в меню «Пуск» или на рабочем столе: Настройки → Интерфейс → Обслуживание → Создать ярлык. Файл README.txt в архиве перечисляет всё, что нужно удалить, если хотите убрать приложение без следов.

При первом запуске у вас спросят три вещи из вашей учётной записи Xtream Codes:

• Сервер — адрес с портом, вида http://example.com:8080. Не полная ссылка на плейлист, а только хост.
• Имя пользователя и Пароль — те, что выдал провайдер.

Они сохраняются. Чтобы позже добавить ещё одну учётную запись или изменить эту: Настройки → Плейлисты. Плейлисты можно переключать на ходу, а избранное и история хранятся отдельно для каждого.

Можно. При добавлении плейлиста выберите M3U и вставьте адрес, который дал провайдер.

Учётная запись Xtream раскрывает приложение полнее — архив передач, срок действия учётной записи, собственная телепрограмма провайдера — потому что всё это приходит из API, которого у списка M3U нет. Список M3U воспроизводится и может получить собственный адрес XMLTV для программы, что закрывает большую часть разницы.

Да. Мастер начальной настройки предлагает демоканалы: несколько свободных публичных тестовых потоков от Mux, Apple и Bitmovin, чтобы вы увидели приложение в работе, не вводя ничего. Это официальные тестовые потоки, а не чей-то телесервис, и перейти на настоящий плейлист можно в любой момент.

Дважды щёлкните в средней колонке или нажмите ▶ Воспроизвести на панели справа. Выбор другого канала подменяет поток на месте, а не разбирает плеер и собирает заново — поэтому переключение каналов происходит быстро.

Кнопки Назад и Вперёд на панели плеера идут по тому списку, в котором вы находитесь: каналы, серии сериала, записи или история.

Для фильмов, серий, записей и архива — всего, у чего известна длительность:

• Наведите указатель на картинку — снизу выедет полоса перемотки с прошедшим и общим временем и кнопками −10 с / +30 с.
• Щёлкните по видео один раз и пользуйтесь стрелками: нажатие перескакивает на десять секунд, удержание перематывает непрерывно.

Прямой эфир перематывать нельзя, и полоса там намеренно не показывается. Чтобы двигаться внутри эфирного канала, нужен таймшифт — смотрите ниже.

Дважды щёлкните по картинке или нажмите F. Esc выходит — и явная кнопка Выйти из полного экрана на плавающей панели тоже, она там именно затем, чтобы никому не приходилось знать про Esc.

Панель управления и указатель прячутся после нескольких секунд покоя и возвращаются от малейшего движения.

Да — вынесите плеер в отдельное окно и перетащите его куда хотите.

По умолчанию окно без рамки: тащите за любое место картинки. Правая кнопка даёт «поверх всех окон», заголовок или выход. Esc тоже возвращает окно обратно. Главное окно всё это время продолжает работать.

Кнопка ⚙ на панели плеера — она есть и в управлении полным экраном — содержит всё, что касается текущего потока:

• Звуковая дорожка и дорожка субтитров
• Задержка звука, когда звук расходится с картинкой
• Соотношение сторон (16:9, 4:3, растянуть и так далее)
• Размер сетевого буфера
• Stats for nerds: кодеки, разрешение, частота кадров, аппаратное декодирование, синхронизация A/V, потерянные кадры, кеш и скорость сети — вживую поверх картинки

Выбранная дорожка запоминается, а в сериале переходит на следующую серию. Если нужно задать предпочтение сразу для всех потоков, смотрите Настройки ниже.

• Пробел — пауза и продолжение
• F — полный экран, Esc для выхода
• ← / → — десять секунд, удерживайте для непрерывной перемотки
• M — выключить звук

Они работают одинаково в главном окне, в полном экране и в вынесенном окне.

Да — для фильмов, серий, записей и ваших локальных файлов. При повторном запуске оно спросит, продолжить с этого места или начать сначала.

Позиции у самого начала или конца намеренно игнорируются, чтобы не предлагать продолжить то, что вы только начали или на самом деле досмотрели.

От вашего провайдера. Каждый эфирный канал в списке показывает, что идёт сейчас, вместе с полосой прогресса, а панель подробностей — что будет дальше.

Программа кешируется на диск для каждого плейлиста, поэтому появляется на экране сразу при запуске — свежая копия скачивается в фоне и заменяет её. Если скачивание не удалось, остаётся кешированная программа, а не пустое место.

Есть. Кнопка Программа на боковой панели открывает сетку передач с поиском по всем каналам и прокручиваемой шкалой времени. Поиск находит передачу по названию сразу по всем каналам.

На канале с архивом двойной щелчок по уже прошедшей передаче включает её из архива.

Задайте этому плейлисту собственную программу вместо провайдерской:

1. Настройки → Плейлисты
2. Выделите плейлист и откройте его на редактирование
3. Впишите адрес XMLTV в поле собственной программы

Он заменяет то, что присылает провайдер. Приложение сопоставляет ваши каналы с этой программой сначала по идентификатору EPG, затем по названию канала, поэтому программа из другого источника обычно всё равно ложится правильно.

Некоторые провайдеры публикуют время, не совпадающее с тем, что они на самом деле выдают в эфир. В Настройки → Воспроизведение есть две отдельные поправки:

• Сдвиг EPG сдвигает всё время, которое показывает программа.
• Сдвиг повтора сдвигает точку, с которой начинают играть архив и таймшифт, не трогая расписание.

Они разделены, потому что провайдеры ошибаются в одном независимо от другого.

Некоторые провайдеры хранят запись каждого канала за несколько дней. Там, где ваш это делает, у канала в списке появляется метка ⏪, а панель подробностей сообщает, на сколько дней в глубину идёт архив.

Если у канала метки нет, провайдер для него архив не предоставляет. Это его настройка, и ничто в приложении её не включит.

Нажмите кнопку ⏪ в плеере — она есть и в управлении полным экраном — либо щёлкните по каналу правой кнопкой и выберите Таймшифт. Затем выберите с начала.

Играет кусок архива, поэтому он перематывается как фильм: и полоса, и стрелки внутри него работают.

Можно. Меню таймшифта перечисляет прошедшие передачи по дням — дважды щёлкните по нужной. Ещё можно отходить назад фиксированными шагами, и эти шаги подстраиваются под реальную глубину архива вашего провайдера: от тридцати минут до недели.

Некоторые провайдеры принимают запрос к архиву и молча отдают прямой эфир. Приложение это проверяет и сообщает, вместо того чтобы дать вам думать, будто вы смотрите вчерашнее.

Два пути:

• Кнопка REC в плеере — для того, что вы смотрите сейчас.
• Правая кнопка на любом канале → Записать — для канала, который вы не смотрите.

Если длительность не выбрана, запись идёт, пока вы её не остановите. Запись можно смотреть, пока она ещё пишется.

И то, и другое. Меню REC предлагает 30 минут, 1, 2 или 4 часа, а запланированная запись принимает время начала и время окончания.

Запланированные задания переживают перезапуск приложения, но в момент срабатывания приложение должно быть запущено — это программа, а не фоновая служба. Записи → Активные и запланированные показывает, что стоит в очереди.

Нет, если вы записываете тот канал, который смотрите: запись ответвляется от собственного потока плеера, поэтому ничего не стоит дополнительно и работает на обычных учётных записях, разрешающих лишь один поток одновременно.

А вот запись другого канала или запланированное задание, стартующее позже, открывает собственное подключение к провайдеру.

Одна деталь про запись из плеера: она закрывается в момент остановки, поэтому остановка воспроизведения, переход на другой канал или ошибка потока её завершают.

Можно, на двух уровнях. Настройки → Запись принимает ограничение размера, действующее для всех записей — число плюс МБ, ГБ или ТБ. А в меню REC плеера есть быстрое ограничение только для текущего сеанса, от 250 МБ до 10 ГБ.

Там, где вы укажете в Настройки → Запись. Раздел Записи на боковой панели их просматривает, а подпапки служат категориями: создавайте папки, переименовывайте, перемещайте между ними и выделяйте по нескольку, чтобы удалить разом.

Отдельное окно, показывающее 2, 4, 6 или 9 эфирных каналов одновременно в сетке, каждый — самостоятельный поток. Они могут быть из разных плейлистов и даже из разных учётных записей.

Открывается с боковой панели; размер сетки — в Настройки → Мультиэкран. Двойной щелчок по ячейке разворачивает её.

Щёлкните по ячейке, чтобы отдать ей звук — красная рамка отмечает ту, которую вы слышите.

Правая кнопка на любой ячейке даёт: выключить звук, звуковую дорожку и субтитры, переместить или поменять местами с другой, либо убрать. У канала с архивом внутри его ячейки появляется собственная шкала архива, так что один канал можно отматывать назад, пока остальные идут в прямом эфире.

Потому что так и есть — по одному на ячейку. Большинство IPTV-аккаунтов разрешают всего один-два одновременных потока, поэтому сетку из девяти окон большинство провайдеров попросту отклонит.

Приложение говорит об этом один раз, до того как вы узнаете это по стене неудачных потоков. Если вы видите «достигнут предел подключений», обычно причина именно в этом.

Правая кнопка на канале, фильме или серии → Транслировать на Chromecast…, затем выберите устройство. Эфирные каналы отправляются как HLS — именно этого ждёт приёмник Cast.

Трансляция останавливает локальное воспроизведение — вместе они были бы вторым подключением к провайдеру. Полоса над плеером называет устройство и то, что на нём идёт, и содержит кнопку остановки. Запуск чего-либо в приложении тоже завершает трансляцию и возвращает воспроизведение.

Некоторые каналы — это обычное видео H.264 со звуком Dolby Digital Plus. У Chromecast, который не Ultra и не Google TV, декодера для него нет, и он отклоняет поток, не объясняя причины.

Приложение перекодирует такие случаи на этом компьютере и отдаёт результат в вашей же сети: видео переписывается без изменений — заново кодируется только звук, это недорого — и происходит это лишь после того, как устройство действительно отказалось от потока. Канал, который ваше устройство тянет, всегда получает оригинальный поток провайдера, нетронутым.

Для этого нужен ffmpeg, и он есть внутри каждой упакованной сборки.

Настройки → Trakt. Вы заводите приложение на trakt.tv, вставляете два выданных ключа и подтверждаете доступ в открывшемся браузере.

После этого просмотренное отправляется в Trakt, а список к просмотру и историю можно листать прямо в приложении. Ваши локальные файлы тоже отмечаются — если TMDB смог опознать файл.

Можно. Локальные файлы на боковой панели просматривают папки, добавленные в Настройки → Локальные файлы.

Сетевая шара, уже подключённая вашей системой, появляется сама — монтирование SMB через gvfs на Linux, шара в /Volumes на macOS, подключённый диск на Windows. Для приложения это обычные пути, так что внутри него нет своего SMB-клиента, которому было бы чем сломаться.

И то, и другое — переключатель в средней колонке.

• Папки показывают дерево ровно таким, каким оно лежит на диске.
• Библиотека читает имена файлов и строит из них сериалы с сезонами и сериями, а фильмы кладёт в «Фильмы» — в том же виде, что и разделы провайдера.

Из TMDB — для всего, что удаётся сопоставить по названию и году. То, что сопоставить не вышло, получает кадр из самого видео, а музыка берёт обложку из тегов файла или из картинки обложки в папке.

Файл без года и без релизного тега в имени никогда не угадывается. Так задумано: неправильный постер хуже, чем миниатюра. Переименуйте файл, добавив год, если хотите, чтобы он опознался.

Играет. Альбомы стоят вместе, исполнитель, альбом и название берутся из тегов, и есть очередь воспроизведения: добавить трек, поставить в очередь целую папку или включить что-то следующим. По окончании трека оно само переходит к следующему.

Есть также визуализация и десятиполосный эквалайзер.

Он перемещён, переименован, или его сетевая шара не подключена. История говорит, что именно, и предлагает удалить запись, а не молча ломается.

Если это шара — подключите её и попробуйте снова, запись заработает как прежде.

Настройки → Интерфейс. Интерфейс переведён на 27 языков и переключается сразу, без перезапуска. Арабский, персидский, иврит и урду зеркалят всю раскладку.

На той же вкладке пять цветовых тем и семь акцентных цветов, применяются на лету.

Настройки → Воспроизведение задают, что должно происходить без вашего участия каждый раз:

• Предпочитаемый язык звука
• Субтитры включены или нет, с первым и вторым предпочитаемым языком
• Соотношение сторон и сетевой буфер по умолчанию
• За сколько появляется карточка «Следующая серия» — выключено или от одной до десяти минут

Меню ⚙ в плеере по-прежнему перекрывает любой из этих параметров для текущего потока.

Да. PIN-код защищает заблокированные категории и заблокированные группы избранного. Заблокированная группа не показывает даже состав каналов, пока код не введён — она прячет содержимое, а не только воспроизведение.

Код хранится с солью и в виде хеша, а не открытым текстом.

Щёлкните правой кнопкой по любому каналу, фильму или сериалу, чтобы переименовать или скрыть. Получается, по сути, ваш собственный отредактированный плейлист, сохраняемый отдельно для каждого плейлиста, а Восстановить каналы по умолчанию… возвращает всё ровно к тому, что присылает провайдер.

Целые категории можно скрыть, переименовать или заблокировать из их контекстного меню. Каналы скрытой категории исключаются и из «Всех» тоже.

Добавьте сколько угодно плейлистов в Настройки → Плейлисты и переключайтесь между ними на ходу. У каждого своё избранное, своя история, свои скрытые каналы и переименования.

У каждого может быть и собственный адрес XMLTV, и собственное расписание обновления — никогда, при запуске, каждые 2, 6 или 12 часов, ежедневно или еженедельно.

Лог превращает «не работает» в то, что можно починить, а учётные данные из него маскируются автоматически — поэтому его можно спокойно приложить к обращению.

Запустите приложение из терминала с заданной переменной DOPEIPTV_LOG_FILE, и оно запишет лог туда, помимо вывода на экран.

Linux — AppImage

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

Linux — .deb или pipx

DOPEIPTV_LOG_FILE=/tmp/dopeiptv.log dopeiptv

macOS

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

Windows — PowerShell, в распакованной папке

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

Воспроизведите проблему, закройте приложение и приложите файл. Для намного большей подробности добавьте DOPEIPTV_LOG=debug перед той же командой.

Запустите его из терминала — в ответе выше дана точная команда для вашей системы — и прочитайте, что оно печатает. Чаще всего именно там и названа причина.

Упакованные сборки несут с собой всё необходимое. Если вы ставили из исходников через pipx, дополнительно нужны mpv и ffmpeg из вашего дистрибутива:

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

Встроенному плееру не достаётся поверхность для вывода видео.

1. Откройте ⚙ → Stats for nerds и посмотрите, приходят ли кадры вообще — это отделяет проблему с потоком от проблемы с выводом.
2. На Wayland попробуйте Настройки → Воспроизведение → Запускать через бэкенд X11 и перезапустите приложение.
3. Запустите из терминала и поищите строки, где упоминаются GL или mpv.

Оно ещё не нотаризовано Apple. Щёлкните по нему правой кнопкой и выберите Открыть, затем Открыть в диалоге — либо разрешите его в Системные настройки → Конфиденциальность и безопасность → Всё равно открыть.

Если macOS вместо этого пишет, что приложение «повреждено», это карантинный признак, поставленный при загрузке. Снимите его:

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

Ни одно из этих предупреждений не значит, что с приложением что-то не так — только то, что сборка не подписана, а для подписи нужен платный сертификат Apple.

SmartScreen не узнаёт издателя, потому что сборка не подписана — для этого нужен платный сертификат. Нажмите Подробнее, затем Выполнить в любом случае.

Ложное срабатывание. Две его причины устранены в 1.2.10: загрузчик теперь компилируется из исходников, а не берётся готовым — на такой у антивирусных движков есть сигнатуры, — и исполняемый файл несёт настоящий ресурс версии.

Если ваш движок всё равно его помечает, разрешите папку в антивирусе и сообщите о ложном срабатывании в Microsoft — именно это в итоге решает вопрос для всех, а не только для вас.

Приложение опрашивает провайдера и объясняет причину человеческим языком, а не показывает голую ошибку: срок действия учётной записи истёк, достигнут предел подключений, потока нет, сервер недоступен и так далее.

Если другие каналы играют — дело в этом канале. Если не играет ничего, посмотрите Настройки → Плейлисты: панель учётной записи показывает дату окончания и число разрешённых подключений.

Ваша учётная запись разрешает определённое число одновременных потоков, и все они заняты. По убыванию вероятности:

1. Открыт мультиэкран — каждая ячейка это подключение.
2. Идёт запись другого канала.
3. Учётной записью пользуется другое устройство или другой человек.
4. Прошлый сеанс ещё не истёк у провайдера; подождать минуту часто достаточно.

Запись канала, который вы смотрите, не считается вторым подключением.

На Wayland GNOME и KDE берут значок окна из подходящей записи рабочего стола и игнорируют то, что программа задаёт сама. У AppImage такой записи нет, пока её что-нибудь не установит.

1. Приложение предлагает добавить её при первом запуске. Согласитесь — и затем перезапустите приложение, потому что открытое окно сохраняет тот значок, с которым открылось.
2. Тот же переключатель есть в Настройки → Воспроизведение, если вы отказались.
3. Если значок всё равно не появляется, его закрывает устаревший кеш значков. GTK читает этот файл вместо папки:

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

При установке из .deb запись уже есть, и ничего из этого не относится к делу.

Этот пункт запускает отдельный mpv или vlc из вашей системы, поэтому один из них должен быть установлен — встроенному плееру ничего дополнительного не нужно, и его это не касается.

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