wip7

2026-07-13 12:30:05 +08:00
parent 7d61aadc5d
commit f25e128299
2023 changed files with 9042 additions and 922 deletions
@@ -0,0 +1,85 @@
+---
+icon: material/flag-checkered
+tags: ["iptvc"]
+---
+
+# :material-flag-checkered: Быстрый старт
+
+Для простоты представим, что программа скачана и распакована в любую директорию и вы находитесь в ней.
+
+Используйте тот способ запуска, который выбрали на шаге [установки](install.md).
+
+Ниже представлены лишь частые примеры запуска программы с разными аргументами под разные случаи.
+
+## Проверить плейлист по прямой ссылке
+
+```
+./iptvc check -u https://example.com/pls.m3u
+./iptvc check --url https://example.com/pls.m3u
+```
+
+## Проверить файл плейлиста с диска
+
+```
+./iptvc check -f /home/user/pls.m3u
+./iptvc check --file /home/user/pls.m3u
+```
+
+## Проверить плейлист по короткому коду из [`playlists.ini`](../common/formats/playlists.md)
+
+```
+./iptvc check -c X
+./iptvc check --code X
+```
+
+Файл `playlists.ini` должен лежать рядом с `iptvc`.
+
+Если файл лежит в другой директории, то можно явно указать путь к нему:
+
+```
+./iptvc check --ini /home/user/playlists.ini --code X
+```
+
+Если ini-файл не будет найден, программа предупредит об этом.
+
+## Присвоить каналам тематические теги
+
+Для этого рядом с `iptvc` должен лежать файл [channels.json](../common/formats/channels.md).
+
+Если файл лежит в другой директории, то можно указать её явно:
+
+```
+./iptvc check --tags /home/user/channels.json
+```
+
+Если json-файл не будет найден, то программа предупредит о том, что теги не будут присвоены, и продолжит работу.
+
+## Проверить несколько плейлистов одновременно
+
+Для этого можно комбинировать все аргументы, перечисленные выше, с учётом особенностей их работы:
+
+```shell
+./iptvc check \
+    --ini /home/user/p.ini \ #(1)!
+    --tags /home/user/c.json \  #(2)!
+    --code Y \  #(3)!
+    --file /home/user/tv.m3u \  #(4)!
+    --url https://example.com/pls1.m3u \  #(5)!
+    -u https://example.com/pls2.m3u  #(6)!
+```
+
+1. Из этого файла будет взят список плейлистов
+2. Из этого файла будут взяты правила для присвоения тегов каналам
+3. Из ini-списка будет проверен только плейлист с кодом `Y`
+4. Это отдельный файл плейлиста на диске, который будет проверен в дополнение к основному списку
+5. Плейлист на каком-то удалённом сервере, который будет загружен и проверен вместе с прошлыми двумя
+6. Ещё один по ссылке, просто через короткий вариант аргумента `--url`
+
+Символ `\` нужен только для наглядного разделения аргументов на несколько строк.
+Всё это можно писать в одну строку.
+
+Переданные плейлисты будут обработаны в следующем порядке:
+
+1. локальные файлы (`-f|--file`);
+2. по ссылкам (`-u|--url`);
+3. по кодам из ini-файла (`-i|--ini`, `-c|--code`).