[{"_1":2,"_152":-5,"_153":-5},"loaderData",{"_3":4,"_13":14,"_20":21,"_131":132},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","routes/_layout.r.$namespace.$reponame",{"_22":23,"_24":-5,"_25":11,"_26":11,"_27":28,"_29":30,"_31":-5,"_32":11,"_33":34,"_82":-5,"_83":84,"_124":-5,"_125":11,"_126":17,"_127":11,"_128":-5,"_129":130},"canonicalUrl","https://hub.docker.com/r/lifailon/kinozal-bot/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","lifailon","reponame","kinozal-bot","cloudBuildSource","isAutobuildsAvailable","repo",{"_35":36,"_37":38,"_40":41,"_42":43,"_44":11,"_45":46,"_47":48,"_49":50,"_52":30,"_27":28,"_53":54,"_55":39,"_56":57,"_58":59,"_60":61,"_62":-5,"_63":57,"_64":65,"_66":11,"_67":28,"_68":69,"_74":11,"_75":76,"_80":28,"_81":-5},"categories",[],"content_types",[39],"image","date_registered","2025-06-30T17:34:48.313353Z","description","Telegram bot for the Kinozal torrent tracker, remote control of the qBittorrent and Transmission.","is_private","last_updated","2025-06-30T17:34:48.377746Z","last_modified","2025-06-30T18:29:18.996763Z","media_types",[51],"application/vnd.docker.container.image.v1+json","name","pull_count",710,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

\n \n Kinozal Bot & News\n \n

\n\n

\n $\"GitHub$ \n $\"GitHub$ \n $\"Docker$ \n $\"GitHub$ \n

\n\nTelegram бот, который позволяет автоматизировать процесс доставки контента до вашего телевизора, используя только телефон.\n\nС помощью бота вы получите удобный и привычный интерфейс для взаимодействия с торрент трекером [Кинозал](https://kinozal.tv) и базой данных [TMDB](https://www.themoviedb.org) для отслеживания даты выхода серий, сезонов и поиска актеров для каждой серии, а также возможность управлять торрент клиентом [qBittorrent](https://github.com/qbittorrent/qBittorrent) или [Transmission](https://github.com/transmission/transmission) на вашем компьютере, находясь удаленно от дома, а главное, все это доступно из единого интерфейса и без установки клиентского приложения на конечные устройства. В отличии от других приложений, предназначенных для удаленного управления торрент клиентами, вам не нужно находиться в той же локальной сети или использовать VPN.\n\nЗапустить бота возможно как службу **systemd** или в контейнере 🐳 **Docker** (рекомендуется). Вы можете настроить и управлять торрент клиентом независимо от настройки или работоспособности трекера *Кинозал*, или наоборот, использовать только интерфейс *Кинозал* для поиска раздач и выгрузки торрент файлов в Telegram.\n\nНа базе бота реализован новостной канала [Kinozal-News](https://t.me/kinozal_news), который генерирует посты на основе новых публикаций в торрент трекере *Кинозал* (современная альтернатива **RSS**). Каждый пост содержит краткую информацию о раздаче (год выхода, страна производства, рейтинг, качество и перевод), а также `#хештеги` по жанру для фильтрации контента на канале и кнопки с ссылками описания фильма или сериала в базах данных о кинематографе [Кинопоиск](https://www.kinopoisk.ru) и [IMDb](https://www.imdb.com), бесплатный онлайн просмотр через плееры ▶️ [Kinobox](https://kinobox.tv) и 🧲 [магнитные ссылки](https://en.wikipedia.org/wiki/Magnet_URI_scheme) для прямой загрузки содержимого раздачи в вашем торрент клиенте по умолчанию (применимо как для bittorrent-клиентов на телефоне, так и Windows или Linux).\n\nПрисоединяйтесь к каналу, что бы не пропускать новые публикации в трекере:\n\n[![Telegram](https://img.shields.io/badge/Kinozal_News-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/kinozal_news)\n\nНа канале присутствует фильтрация всех публикаций по рейтингу (**7.0** и выше), году выхода (**2024** и новее), региону и времени, а также на основе предыдущих публикаций (по названию и их размеру) для исключения дублирующихся раздач.\n\nИли используйте публичную RSS ленту новостей из проекта [TorAPI](https://github.com/Lifailon/TorAPI/blob/main/README_RU.md) с поддержкой фильтрации:\n\n[![Kinozal RSS Feed](https://img.shields.io/badge/kinozal_rss_feed-F88900?style=for-the-badge&logo=rss&logoColor=white)](https://torapi.vercel.app/api/get/rss/kinozal?category=0&year=0&format=0) [![Swagger Settings](https://img.shields.io/badge/-Настройка_RSS-%23Clojure?style=for-the-badge&logo=swagger&logoColor=white)](https://app.swaggerhub.com/apis-docs/Lifailon/TorAPI/0.5.2#/RSS/get_api_get_rss_kinozal)\n\nДля пользователей бота реализован сценарий публичного запуска зеркала на платформе **Vercel**:\n\n[![Kinozal-Proxy](https://img.shields.io/badge/Kinozal_Proxy-%23000000.svg?style=for-the-badge&logo=vercel&logoColor=white)](https://github.com/Lifailon/Kinozal-Proxy)\n\n---\n\n## 💁‍♂️ Как это работает\n\nНапример, пока вы едите домой с работы, у вас появляется возможность подобрать фильм или сериал в обширной базе Кинозал прямиком с вашего телефона, или, найти что-то новое на канале [Kinozal-News](https://t.me/kinozal_news), после чего сразу загрузить выбранное на ваш компьютер и автоматически или через бот синхронизировать данные с [Plex Media Server](https://www.plex.tv/ru/media-server-downloads). По приходу домой, вам остается только открыть приложение Plex на вашем телевизоре и начать просмотр 📺🍿.\n\nТакой подход также применим для передачи управления по подбору контента другому члену семьи (🐒), это особенно актуально, если у вас один компьютер, который может быть занят или к нему нет прямого доступа. Разобраться в интерфейсе бота проще, чем использовать все сервисы по отдельности, и главное, куда быстрее.\n\n## 📚 Stack\n\n- [Telegram REST api](https://core.telegram.org/bots/api)\n- [qBittorrent WebUI api](https://github.com/qbittorrent/qBittorrent/wiki/WebUI-API-(qBittorrent-4.1))\n- [Transmission RPC api](https://github.com/transmission/transmission/blob/main/docs/rpc-spec.md)\n- [Plex Media Server api](https://github.com/plexinc) (не содержит официальной документации)\n- [TMDB api](https://developer.themoviedb.org/reference/intro/getting-started)\n\n**Зависимости:**\n\n- [jqlang](https://github.com/jqlang/jq) для обработки данных в формате *json*\n- Доступ в Кинозал и *TMDB* (*опционально*, ознакомьтесь со всеми возможными вариантами получения доступа в [настройках](#️-настройка))\n\nСерверная часть написана на чистом [Bash](https://ru.wikipedia.org/wiki/Bash) и использует стандартный набор Unix-утилит.\n\nБот протестирован и работает в виртуальной среде *Hyper-V* на системе *Ubuntu Server 20.04* и новее (возможен запуск в системе Windows через интерпретатор [Git Bash](https://git-scm.com/downloads/win)) для удаленного управления приложениями, установленные в домашней системе Windows или Linux*. Хранение торрент-файлов происходит в системе, на которой запущен бот.\n\n> \\* Проверка удаленного управления приложениями на системе Linux не произодилась. Так как весь стек приложений является кросс-платформенным и имеет единую схему для удаленного взаимодействия через `API`, все должно (и будет) работать точно также.\n\n## 🍿 Реализовано\n\n- ✅ Интерфейс для взаимодействия с торрент трекером **[Кинозал](https://kinozal.tv)**. Поиск раздач с фильтрацией по году выхода и формату разрешения (*HD/FullDH/4K*), подробная информации о каждой раздачи, содержимое раздачи, загрузка торрент файлов, поиск актеров и получение его фильмографии.\n- ✅ Централизованное управление загруженными торрент файлами (*.torrent*) на сервере, с возможностью выгрузки в Telegram.\n- ✅ Интерфейс удаленного управления торрент клиентом [qBittorrent](https://github.com/qbittorrent/qBittorrent). Добавление раздач на загрузку из торрент файла, [инфо хеш](https://en.wikipedia.org/wiki/Magnet_URI_scheme) (передается в каждой публикации новостного канала и при поиске раздач в боте) а также через url торрент файла, получение подробной информации о загрузке (скорость загрузки, статус, пиры, сиды и т.д.), пауза и возобновление загрузки, проверка на целостность, принудительно анонсировать, переключение лимитов скорости, управление приоритетом отдельных файлов, удаление торрента и содержимого раздачи из системы.\n- ✅ Интерфейс управления торрент клиентом [Transmission](https://github.com/transmission/transmission). Добавление раздач на загрузку из торрент файла, инфо хеш или url, получение подробной информации о загрузке, пауза и возобновление загрузки, управление приоритетом отдельных файлов, удаление торрента и содержимого раздачи.\n- ✅ Синхронизация контента с [Plex Media Server](https://www.plex.tv), а также просмотр содержимого директорий и дочерних файлов.\n- ✅ Получение дополнительной информации о фильме и сериале из [The Movie Database](https://www.themoviedb.org/?language=ru) (TMDB). Список актеров и сезонов для каждого сериала, список серий в каждом сезоне, дата выхода сезонов и серий, а также получение подробной информации о каждой серии и список приглашенных актеров.\n\nДобавление торрента по 🧲 *hash*-сумме и 🌐 *url*-адресу торрент файла (без загрузки самого файла) возможно из любого источника (торрент трекера). По мимо загрузки, это также дает возможность сформировать и сохранить торрент файл на сервере с полученными метаданными через торрент клиент qBittorrent или Transmission, который можно выгрузкой в Telegram, для дальнейшей загрузки через ваш торрент клиент на телефоне.\n\n---\n\n## 🐳 Контейнер\n\nЗапуск в контейнере является альтернативой настройки службы `systemd`. Обработка ответов происходит заметно быстрее (сравнительно с локальным запуском на малопроизводительных системах), по этому такой способ является **рекомендуемым**.\n\n- Перейдите в директорию со скриптом и **настроенным** файлом конфигурации:\n\n```shell\ncd ~/kinozal-bot\n```\n\n- Создайте [dockerfile](https://github.com/Lifailon/Kinozal-Bot/blob/rsa/dockerfile) с содержимым:\n\n```dockerfile\nFROM alpine:latest\nWORKDIR /kinozal-bot\nRUN apk add --no-cache bash coreutils curl grep sed gawk jq tzdata\nENV TZ=Etc/GMT-3\nRUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone\nCOPY kinozal-bot.sh .\nRUN chmod +x kinozal-bot.sh\nENTRYPOINT [\"bash\", \"-c\", \"./kinozal-bot.sh start bot docker\"]\n```\n\n### Docker\n\nСоберите образ и запустите контейнер в Docker:\n\n```shell\ndocker build -t kinozal-bot .\ndocker run -d \\\n --name kinozal-bot \\\n --restart=unless-stopped \\\n --label com.centurylinklabs.watchtower.enable=false \\\n -v ./torrents:/kinozal-bot/torrents \\\n -v ./kinozal-bot.conf:/kinozal-bot/kinozal-bot.conf \\\n kinozal-bot\n```\n\nИли загрузите образ из [Docker Hub](https://hub.docker.com/r/lifailon/kinozal-bot):\n\n> Образ собран на системе с архитектурой `aarch64` в режиме `all`.\n\n```shell\ndocker run -d \\\n --name kinozal-bot \\\n --restart=unless-stopped \\\n -v ./torrents:/kinozal-bot/torrents \\\n -v ./kinozal-bot.conf:/kinozal-bot/kinozal-bot.conf \\\n lifailon/kinozal-bot:latest\n```\n\nРазмер образа составляет 9 MiB. Режим `unless-stopped` отвечает за перезапуск контейнера в случае перезагрузки системы или другого сбоя, за исключением ручной остановки.\n\nПри запуске контейнера используется механизм **bind mount** (`-v` `путь в системе`**:**`путь в контейнере`), это удобно для хранения конфигурации (не сохраняя ее в образе) и синхронизации торрент файлов (`.torrent`) с хостовой системой, тем самым при запуске бота в контейнере или локальной системе будет доступ к одному и томуже составу торрент файлов, а после удаления контейнера и образа файлы будут сохранены в системе.\n### Мониторинг\n\nВы можете управлять запуском контейнара с помощью команд:\n\n```shell\ndocker kinozal-bot\n```\n\nДля просмотра журналов контейнера используется команда: `docker logs kinozal-bot`.\n\nЧто бы не вызывать каждый раз команду `logs` для просмотра логов контейнера или других журналов, установите терминальный пользовательский интерфейс [lazyjournal](https://github.com/Lifailon/lazyjournal) для быстрого мониторинга и фильтрации логов контейнеров *Docker* и *Podman*, юнитов `systemd` или лог-файлов в системе.\n\nДля мониторинга журналов контейнеров через веб-интерфейс, используйте [Dozzle](https://github.com/amir20/dozzle).\n\nКоманда для быстрого удаления контейнера и образа:\n\n```shell\ndocker stop kinozal-bot && docker rm kinozal-bot && docker rmi kinozal-bot && docker rmi alpine || docker rmi lifailon/kinozal-bot:latest\n```","has_starred","hub_user","immutable_tags_settings",{"_70":11,"_71":72},"enabled","rules",[73],".*","is_automated","permissions",{"_77":17,"_78":11,"_79":11},"read","write","admin","user","storage_size","orgData","recentTags",[85],{"_86":39,"_87":88,"_89":90,"_91":92,"_93":94,"_95":96,"_45":113,"_114":88,"_115":28,"_116":51,"_52":117,"_118":119,"_120":103,"_121":113,"_122":61,"_123":17},"content_type","creator",23112928,"digest","sha256:f2832736cb4e5638b160ebb5ff46f4d422e08764c32e53c10e2c3df16a690072","full_size",9498094,"id",926014602,"images",[97],{"_98":99,"_89":90,"_100":101,"_102":103,"_104":105,"_106":107,"_108":101,"_109":-5,"_110":92,"_58":61,"_111":112},"architecture","arm64","features","","last_pulled","2026-09-15T06:41:20.576964088Z","last_pushed","2025-06-30T17:34:47.045451273Z","os","linux","os_features","os_version","size","variant","v8","2025-06-30T17:34:47.307816Z","last_updater","last_updater_username","media_type","latest","repository",27878547,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_33":133,"_140":141,"_129":150,"_151":11},{"_35":134,"_37":135,"_40":41,"_42":43,"_44":11,"_45":46,"_47":48,"_49":136,"_52":30,"_27":28,"_53":54,"_55":39,"_56":57,"_58":59,"_60":61,"_62":-5,"_63":57,"_64":65,"_66":11,"_67":28,"_68":137,"_74":11,"_75":139,"_80":28,"_81":-5},[],[39],[51],{"_70":11,"_71":138},[73],{"_77":17,"_78":11,"_79":11},"tags",{"_142":59,"_143":-5,"_144":-5,"_145":146},"count","next","previous","results",[147],{"_86":39,"_87":88,"_89":90,"_91":92,"_93":94,"_95":148,"_45":113,"_114":88,"_115":28,"_116":51,"_52":117,"_118":119,"_120":103,"_121":113,"_122":61,"_123":17},[149],{"_98":99,"_89":90,"_100":101,"_102":103,"_104":105,"_106":107,"_108":101,"_109":-5,"_110":92,"_58":61,"_111":112},[],"canDeleteTags","actionData","errors"]

lifailon/kinozal-bot

Tags for lifailon/kinozal-bot