📖 Прочти меня

Foxarr — семейный медиа-центр. Один аккаунт (Jellyfin) для всей семьи: смотрите кино, сериалы и музыку на любом устройстве — телевизоре, телефоне, планшете или компьютере.

Главная страница — что означают кнопки

• Kino — это Jellyfin: готовый каталог фильмов и сериалов, который уже есть на сервере. Отсюда смотрите то, что уже скачано. На телефоне удобнее всего смотреть через официальное приложение Jellyfin для Android: Google Play — Jellyfin (настройте сервер как kino.foxarr.de и войдите своим аккаунтом).
• Cat — это каталог и запросы: поиск по базе (кино, сериалы, «Лучшее на трекерах») и возможность запросить то, чего ещё нет.
• Music Foxarr — музыкальный раздел: коллекция музыки в Kino + радио-потоки с EPG (текущая песня как «телепрограмма»). в разработке — скоро.
• TV Foxarr — телевидение: личные IPTV-плейлисты. Берём полный список каналов (спорт, новости, кино, детские), а каждый отмечает только то, что нужно ему, и получает свою ссылку для любого плеера. в разработке — скоро.

Откуда берётся контент

Каталог Cat работает так: постеры, описания и рейтинги приходят из TMDB (мировой базы кино). А сам файл каталог ищет через собственный агрегатор поиска по трекерам:

• агрегатор проверяет сразу несколько русскоязычных трекеров (RuTracker, RuTor, NoNaMe и другие);
• выбирает лучшую раздачу — с максимальным числом сидов (пиров);
• скачивает её, перекодирует в совместимый формат и кладёт на сервер — фильм появляется в Kino.

Как пользоваться каталогом (Cat)

1. Откройте Cat, введите название в поиске или выберите из «Лучшего».
2. Откройте карточку фильма или сериала.
3. Нажмите «Запросить» — и каталог сам всё сделает.
4. Когда фильм будет готов — он появится в Kino (Jellyfin), а в списке запросов статус сменится на «Готово».

Для сериалов можно запросить весь сериал целиком или только нужный сезон — спросит при запросе.

«Лучшее» (Топ-10) — что это

Вкладка «Лучшее» в каталоге — это топ самых популярных фильмов и сериалов прямо сейчас. На каждой карточке видно всё сразу:

• постер, название и рейтинг;
• 👥 сиды — сколько людей сейчас раздают файл (чем больше, тем быстрее скачается);
• ⬇️ размер — сколько весит файл;
• 🏷 трекер — откуда будет качаться (RuTracker и другие).

Как это работает: каждую ночь в 4:00 наш скрипт берёт актуальный топ популярности из TMDB, для каждого фильма и сериала ищет лучшую раздачу через наш агрегатор трекеров и сохраняет результат в кэш. Так что «Лучшее» всегда свежее — это не старый список, а то, что реально популярно и качается прямо сейчас.

Понравился фильм из «Лучшего»? Нажмите «Запросить» — и он скачается тем же путём: трекер → загрузка → перекодировка → Kino.

«Мои запросы» — что это

Это список всего, что вы запросили через каталог, с текущим статусом:

• Запрошено / Качается — раздача скачивается, показывается процент и скорость;
• Конвертируется / Копируется — файл перекодируется в совместимый формат и переезжает на сервер;
• Готово — можно смотреть в Kino;
• Недоступно — подходящей раздачи не нашлось;
• Отменено — запрос отменён.

У каждой записи есть кнопки История (что происходило с запросом) и Удалить (убрать запись из списка — файлы в Kino не трогаются).

«Мои торренты» — что это

Это ручное управление загрузками, если стандартный поиск не нашёл то, что нужно. Здесь видно все загруженные торренты: статус, процент, скорость. Можно отменить загрузку, переключить кодирование (иногда полезно для старых файлов) и удалить запись из списка.

«Добавить торрент» — как это работает

Вы даёте каталогу магнет-ссылку или .torrent-файл, и дальше всё автоматически:

1. Торрент попадает в загрузчик (Transmission);
2. После скачивания файл перекодируется в формат, который гарантированно играет везде (H.264/AAC);
3. Файл переносится на медиа-сервер и появляется в Kino;
4. В списке «Мои торренты» вы видите весь процесс и его историю.

Добавить торрент можно прямо в каталоге (кнопка «Добавить торрент»). Если раздача без сидов — она будет ждать пиров, статус это покажет.

Хотите скачать файл себе на компьютер? Никаких проблем: добавьте торрент-файл (или магнет-ссылку), сервер скачает его за вас, а когда загрузка завершится — вы сможете свободно скачать готовый файл к себе на компьютер из раздела «Мои торренты». Сервер качает быстрее и надёжнее — можно просто оставить загрузку и вернуться позже.

Варианты запроса — кратко

• Раздача найдена на трекерах → скачается, перекодируется, появится в Kino (обычно несколько часов);
• Раздачи нет нигде → статус «Недоступно», можно попробовать позже или добавить торрент вручную;
• Уже в Kino → можно смотреть сразу, запрос не нужен.

Техническая часть (для интересующихся)

Весь сервис живёт на виртуальном сервере в Европе (Linux) и собирается из проверенных open-source компонентов:

• Kino — это Jellyfin: открытый медиасервер (фильмы, сериалы, музыка). Он отдаёт контент на телевизоры, телефоны, планшеты и компьютеры — в браузере или через приложение;
• Cat — наш собственный каталог: фронтенд на React, бэкенд на FastAPI (Python), база данных SQLite;
• Данные о фильмах (постеры, описания, рейтинги) — из открытой базы TMDB;
• Поиск раздач — Prowlarr: наш агрегатор, который умеет искать сразу по нескольким трекерам (RuTracker, RuTor, NoNaMe, Kinozal и другим);
• Загрузка — Transmission: BitTorrent-клиент, качает торренты на сервер;
• Перекодировка — FFmpeg: файлы перекодируются в формат H.264/AAC, который гарантированно играет на любом устройстве, даже на старых телевизорах;
• Доставка на сервер — автоматическая синхронизация скачанных файлов в библиотеку Kino;
• Автоматизация — планировщик заданий: ночной кэш «Лучшего», проверки и обработка очереди запросов работают сами, без участия человека;
• Telegram-бот — для уведомлений и ручного управления загрузками.

Все компоненты запущены в изолированных контейнерах (Docker), за веб-доступом стоит обратный прокси (Nginx) с шифрованием (HTTPS).

Изюминка foxarr — это не просто набор готовых сервисов. Сердце системы — Cat, написанный нами с нуля: свой фронтенд (React), свой бэкенд (FastAPI) и свой конвейер. Один клик «Запросить» запускает целую цепочку: агрегатор ищет раздачу сразу на нескольких трекерах, выбирает лучшую по сидам, скачивает, перекодирует под совместимость с любым телевизором и сам доставляет фильм в Kino. Человеку ничего не нужно настраивать — всё решается автоматически.

Исходники и проекты — в нашем GitHub:

• GitHub foxarr — github.com/schumann24

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