---
icon: material/check-network
hide: [toc]
---

# :material-check-network: IPTV Checker (iptvc)

Это простая программа для проверки IPTV плейлистов, входящая в состав проекта m3u.su.

Поддерживает проверку как локальных файлов `*.m3u`/`*.m3u8`, так и удалённых плейлистов по прямым ссылкам, с возможностью кеширования результатов и его вывода в различных форматах.

> Программа не предназначена для хранения, воспроизведения или распространения пиратского контента.

Программа не имеет графического интерфейса и работает в терминале.

<div class="grid cards" markdown>
- [:material-flag-checkered: Быстрый старт](quickstart.md)

    ---
    Коротко о главном, если не терпится

- [:octicons-terminal-24: Доступные команды](commands/index.md)

    ---
    Как правильно с ней работать

- [:simple-dotenv: Переменные окружения](env.md)

    ---
    Параметры конфигурации программы
</div>

## :material-cog-sync-outline: Как работает iptvc

Принцип её работы очень простой:

1. Получить плейлист по ссылке.
2. Полученный плейлист распарсить:  
   обрабатывается полученный текст в формате [m3u](../formats/m3u.md), из него вычленется информация о каналах и их группировке.
3. Каждый найденный канал проверить:  
   получить информацию по ссылке и принять решение — работает ли канал (технически) или нет.
4. Если необходимо, каждому каналу [присвоить теги](../formats/channels.md#доступные-теги) согласно [правилам](../formats/channels.md).
5. Если необходимо, закешировать результаты проверок.

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

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

Подробности см. в разделе [Команда `check`](../iptvc/commands/check.md).

