Об этом проекте

ytdl-sub — это инструмент командной строки, который автоматизирует загрузку медиа через yt-dlp и подготавливает полученные файлы для популярных медиаплееров и серверов, включая Kodi, Jellyfin, Plex, Emby и современные музыкальные плееры. Согласно README, дополнительные плагины или внешние скраперы не требуются. Как это работает: подписки определяются в YAML-файлах. Каждая подписка импортирует пресеты, описывающие, как должны обрабатываться и выводиться медиафайлы. Проект поставляется со множеством готовых пресетов, чтобы пользователи могли начать загрузку без создания конфигурации с нуля. Одна команда, `ytdl-sub sub subscriptions.yaml`, обрабатывает файл. Типичные сценарии использования, показанные в README, включают обработку каналов YouTube как телесериалов, организацию музыкальных клипов и концертов, а также работу с дискографиями SoundCloud или Bandcamp. В README отмечается, что при обработке SoundCloud музыкальные теги записываются через API beets. Вывод организуется в каталоги, такие как tv_shows, music и music_videos, со сгенерированными миниатюрами, файлами метаданных .nfo, постерами и фонариками, подходящими для медиасерверов. Конфигурация гибкая: глобальные переопределения можно задать в разделе `__preset__`, а параметры можно передавать напрямую в Python API yt-dlp, например файл cookie. Пресеты могут задавать жанровые теги, возрастные рейтинги и использовать пресет "Only Recent" для ограничения загрузок по диапазону дат и количеству файлов. Поддерживаются пользовательские конфигурации, с пошаговым руководством и примерами конфигураций, ссылки на которые есть в README. Перечисленные варианты установки включают Docker Compose (Web-GUI, headless, проброс CPU/GPU), Docker CLI, Windows, Unraid, Linux, Linux ARM, PIP, локальную установку и локальную сборку Docker. Docker-образ Web-GUI описывается как объединяющий образ code-server от LinuxServer.io с предустановленным ytdl-sub и рекомендуется в README. Поддержка сообщества доступна через канал Discord, GitHub Issues для запросов функций и сообщений об ошибках, а также FAQ в документации. README также содержит ссылки на readthedocs для подробной информации обо всех полях конфигурации.