Умный медиа-сервер для автоматического отслеживания, загрузки, организации и нарезки сериалов с торрент-трекеров и VK Video. Добавьте источник — приложение само проверяет новые серии, скачивает, переименовывает по шаблонам, нарезает видеокомпиляции на эпизоды и раскладывает в медиатеку (Plex / Jellyfin / Emby).
Это версия 2 — полное переписывание с нуля на модульно-шинной архитектуре (один asyncio-процесс, модули общаются через шину событий) и новом фронте на Vite + Vue 3. Старая монолитно-агентная версия заархивирована в теге
legacy/v1-final.
- Источники: торрент-трекеры Kinozal, RuTracker, Anilibria (API), Astar.bz, Anilibria.TV и VK Video. Для astar/anilibria_tv — браузерная доставка (пул Playwright/Firefox), для остальных — прямой HTTP/API.
- Движок правил: визуальный конструктор цепочек
ЕСЛИ … ТО …для извлечения сезона, эпизода, озвучки, качества из названий видео и файлов; профили правил переиспользуются между сериалами. - Конвейер торрентов: сверка с qBittorrent по инфохэшу (идентичность раздачи), пауза до конца переименования, раскладка файлов раздачи по сериям и дорожкам, восстановление после сбоев. БД — проекция qBittorrent (отказоустойчивость).
- VK Video: загрузка через
yt-dlp(две фазы: download → remux), атомарная публикация файла, усыновление уже лежащих на диске эпизодов без повторной загрузки. - Нарезка компиляций: автоматическое деление видео по главам через
ffmpeg(атомарно — битый кусок не принимается за готовый). - Интеграция TMDB: счётчик «скачано / всего», агрегирование числа серий по нескольким сезонам.
- Реактивный UI: статусы, прогресс, счётчики обновляются в реальном времени по SSE, без перезагрузки страницы.
Один asyncio-процесс. «Тупая» шина (core/bus.py, только publish/subscribe)
и модули (modules/*), общающиеся конвертами (event / command / query /
reply). Request/reply реализован поверх pub/sub в обвязке core/module.py —
сама шина о нём не знает.
┌──────────────────────── gateway (FastAPI) ────────────────────────┐
браузер ──┤ HTTP → query/command · событие шины → SSE (по таблице SSE_MAP) │
└───────────────────────────────┬───────────────────────────────────┘
шина (core/bus.py)
┌──────────┬──────────┬─────────┬────────┴────────┬──────────┬──────────┬──────────┐
catalog scan sources rules torrents downloads renaming unpack
(статусы) (оркестр.) (трекеры/ (движок (qBit- (yt-dlp) (формат (раскладка
расписание) VK API) правил) конвейер) имён) раздачи)
library metadata settings trackerauth
(медиатека)(TMDB) (настройки)(сессии трекеров)
Правила модулей: модуль импортирует только core/* (импорт из чужого
модуля запрещён); БД — приватная память модуля, каждая таблица принадлежит
ровно одному модулю, чужие данные — только query через шину; «шина — сигнал,
БД — истина» (задача персистится до публикации события, при старте модуль
добирает незавершённое). Контракт модуля — в докстринге его module.py.
Конвейер данных: scan находит релизы через sources, применяет rules
и регистрирует их в torrents (qBit) или ставит VK-загрузки в downloads.
Готовый файл проходит renaming → library. catalog
агрегирует вклады статусов и публикует свёрнутый статус серии. gateway
транслирует события шины в SSE и HTTP — в queries/commands.
| Слой | Технологии |
|---|---|
| Бэкенд | Python 3.12, FastAPI + Uvicorn, httpx, SQLite + Alembic |
| Фронтенд | Vite, Vue 3, TypeScript, PrimeVue (web/) |
| Внешнее | qBittorrent (WebUI API), yt-dlp, ffmpeg, Playwright (Firefox), TMDB |
Внешние источники. Китайские видеоисточники читает не сам трекер, а отдельный
необязательный процесс — поставщик («Чинес»), подключённый через «розетку» (HTTP:
манифест, лента событий, поиск названий, чтение линии названия потоком кадров, загрузка
серии). Источник сериала — линия названия; трекер видит названия, линии и ряды, а не приложения. Спецификация — contracts/provider_socket.md; адрес
поставщика и токен — окно «Расширения», вкладка «Чинес» (или ST_PROVIDER_URL,
ST_PROVIDER_TOKEN, пока в настройках адрес не сохранён); без адреса розетки нет, и
трекер работает со встроенными источниками.
Карта топиков шины — contracts/bus_topics.md; решения по контракту —
contracts/revision.md; находки/грабли — contracts/findings.md.
Требуется Python 3.12, Node 20, ffmpeg в PATH (yt-dlp ставится в .venv из requirements.txt); для astar/anilibria_tv —
Firefox для Playwright; для торрентов — доступный qBittorrent.
# 1. Бэкенд
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt -r requirements-dev.txt
.venv/bin/alembic upgrade head # миграции БД (app.db)
cp .env.example .env # вписать ST_QBIT_URL/USER/PASS
# 2. Фронтенд (собирается в web/dist, отдаётся бэкендом с корня /)
cd web && npm ci && npm run build && cd ..
# 3. Запуск (без ST_QBIT_URL модуль torrents не стартует)
.venv/bin/uvicorn run:app --host 0.0.0.0 --port 5000
# (для браузерной доставки astar/anilibria_tv)
.venv/bin/playwright install firefox
# (для прохождения антибот-челленджа rutracker)
.venv/bin/python -m camoufox fetchUI — http://<host>:5000/. Учётки трекеров, VK, TMDB вносятся через UI
(Настройки → авторизация) и хранятся в БД; секреты запуска (qBittorrent) — в
.env (вне git).
.venv/bin/python -m pytest -q # бэкенд
cd web && npm run test # фронтенд (vitest)Тесты не требуют внешних данных: сайты, плееры и трекеры проверяются на
синтетических ответах (tests/site_samples.py, tests/samples/). Пропускаются
только интеграция с живым qBittorrent (без ST_QBIT_URL), сверка с локальными
.torrent (без tests/fixtures/torrents). Поставщик внешних источников в тестах — модель его розетки по
спецификации (tests/provider_mock.py); к настоящему поставщику тесты не обращаются.
Открываются в работающем окне по якорю адреса вместо приложения. Рисуют настоящими компонентами на образцах: живые данные им не нужны, на сервер они ничего не пишут.
| Адрес | Что это | Исходник |
|---|---|---|
/#card-colors |
Подбор цветов на вкладке «Выход»: сезон из 18 серий (1–4 готовые, 5–18 неполные, часть стоит в компиляциях A–E) карточками и плитками; палитры — фон и полосы неполной серии, 16 цветов компиляций, толщина и фон их обводки; готовый блок токенов --partial-* и --compilation-* для web/src/styles/tokens.css |
web/src/tools/CardColors.vue |
/#gallery |
Галерея согласованных форм и объектов | web/src/Gallery.vue |
Смена цветов неполной серии: подобрать на /#card-colors → «Скопировать» →
заменить блок --partial-* в web/src/styles/tokens.css → cd web && npm run build.
Карточка и плитка берут цвета только из этих токенов, поэтому страница всегда
показывает то же, что окно.
Пошаговый прод-ранбук (зависимости, systemd, обновление, откат) —
docs/deployment.md. Текущее состояние и журнал работ —
docs/STATUS.md.
core/ шина, конверт, BaseModule, раннер, БД, логирование
modules/<имя>/ модуль: module.py (контракт) · repository.py (SQL) · профильные файлы
web/ новый фронт (Vite + Vue 3 + TS); сборка → web/dist (в .gitignore)
alembic/ миграции схемы БД
contracts/ карта топиков, решения ревизии, находки
docs/ STATUS, план деплоя, прочие документы
legacy_frontend/ архив старого фронта (отдаётся по /legacy как аварийный откат)
run.py сборка процесса (порядок старта модулей, env)