# TorFilm: как поставить и как пользоваться

Приложение для Android 10 и новее: телефон и приставка/телевизор Android TV.
Каталог кино, сериалов и аниме рутрекера, поиск, карточка с постером,
описанием и рейтингом, просмотр прямо в приложении (свой торрент-поток,
без скачивания целиком). Работает без регистрации и без входа на рутрекер.

## Установка на телефон (5 минут)

1. Откройте на телефоне в браузере адрес **https://tor.buildcorez.ru/** и в разделе
   **TorFilm** нажмите **«Скачать TorFilm»**.
2. Откройте скачанный файл из уведомления или из папки «Загрузки».
3. Если телефон спросит, разрешите браузеру устанавливать приложения — это
   одноразовое разрешение.
4. Появится окно **Google Play Защита** с кнопкой «Проверить приложение».
   Нажмите **«Подробнее»**, затем **«Установить без проверки»**. Приложение не
   из магазина, поэтому Play Защита его не знает. Отправлять в Google ничего
   не нужно.
5. Нажмите «Установить». Откройте TorFilm и нажмите **«Загрузить каталог»**:
   каталог кино заметно больше книжного (десятки мегабайт), дальше он
   обновляется сам раз в сутки небольшими разницами.

## Установка на Android TV и приставки

На телевизоре и приставке браузера обычно нет или он неудобен, поэтому APK
переносят одним из двух способов:

* **Файловый менеджер.** Если на приставке уже есть файловый менеджер
  с собственным браузером (например, «Проводник» или X-plore) — откройте в
  нём адрес **https://tor.buildcorez.ru/**, скачайте TorFilm и установите так же,
  как на телефоне (шаги 3–5 выше, только пультом вместо пальца).
* **Downloader.** Если браузера нет — поставьте из Google Play Store или
  Amazon Appstore бесплатное приложение **Downloader** (жёлтая иконка), в
  нём введите адрес **https://tor.buildcorez.ru/torfilm/** — это прямая ссылка на
  файл `app-film.json`, показывающий, что скачивать. Проще: введите точный
  адрес APK, который покажет главная страница на телефоне или ПК рядом с
  кнопкой «Скачать TorFilm» (адрес вида `https://tor.buildcorez.ru/torfilm/app-film-…apk`).
  Downloader сам предложит установить скачанный файл, экран Play Защиты —
  тот же, что на телефоне.
* После установки TorFilm появится в общем ряду приложений лаунчера
  Android TV (у него свой баннер), можно закрепить на главном экране.

Обновления приложение находит само и предлагает кнопкой на главном экране;
Play Защита будет спрашивать при каждом обновлении, ответ тот же: «Подробнее»
→ «Установить без проверки».

## Пульт и навигация на ТВ

Все экраны TorFilm проходятся пультом: стрелки влево/вправо/вверх/вниз
двигают фокус по сетке карточек и спискам, центральная кнопка («OK»,
«Select») открывает то, что в фокусе, «Назад» возвращает на предыдущий
экран. Отдельного режима для пульта включать не нужно — приложение само
определяет, что сенсорного экрана нет.

## Как пользоваться

**Главный экран.** Строка поиска сверху, под ней чипы разделов: Фильмы,
Сериалы, Мультфильмы, Аниме, Документальное. Пока поиск пуст — сетка
карточек с новыми поступлениями; на полке раздела (открывается чипом или
поиском) можно переключить порядок: «Новые», «Популярные», «По рейтингу».
Если что-то смотрели — над сеткой строка **«Продолжить просмотр»**.

**Поиск.** Введите название, оригинальное название или имя режиссёра/актёра
— «матрица», «Нолан», «Christopher Nolan». Результаты подгружаются по
прокрутке.

**Карточка фильма.** Постер, русское и оригинальное название, год, страна,
жанр, режиссёр и актёры (нажатие на имя открывает фильмографию — полку
персоны), рейтинг TMDB, ссылки на Кинопоиск и IMDb (открывают браузер),
описание, список раздач с качеством, разрешением, переводом, субтитрами,
размером и числом сидов.

**Кнопка «Смотреть».** Крупная кнопка наверху карточки сама выбирает
раздачу: сначала с достаточным числом сидов (5 и больше), среди них — по
качеству из настроек (по умолчанию 1080p), затем больше сидов, затем меньше
размер. Кнопка «Смотреть» у конкретной раздачи в списке ниже выбирает именно
её. Раздача с 1–3 сидами может стартовать медленно или не стартовать вовсе —
чем больше сидов, тем быстрее начнётся показ.

**Просмотр.** Видео начинает идти до того, как файл скачан целиком — первые
секунды после нажатия «Смотреть» уходят на загрузку начала файла. Кнопки
выбора звуковой дорожки и субтитров (встроенные в файл или отдельным
файлом в раздаче) находятся на экране просмотра. Позиция запоминается:
следующий раз тот же фильм откроется с места, где остановились
(«Продолжить просмотр» на главном).

**Библиотека.** Список того, что скачано или лежит в кэше на диске, общее
занятое место и лимит. Долгое нажатие или кнопка «Удалить» у записи убирает
файлы с диска.

**Настройки (⚙).** Качество по умолчанию для кнопки «Смотреть» (1080p, 720p
или любое), лимит кэша на диске (5, 10, 20 или 40 ГБ, по умолчанию 10 —
когда занято больше, старые записи удаляются автоматически, вытесняя
давно не смотренное), обновление каталога по любой сети или только по Wi-Fi
(по умолчанию только Wi-Fi — каталог кино весит заметно больше книжного).

## Если что-то не так

* **Не запускается просмотр или тормозит.** Посмотрите число сидов у
  раздачи в карточке: 1–3 сида дают медленный или прерывистый поток, для
  уверенного старта нужно 5 и больше. Попробуйте другую раздачу того же
  фильма с бо́льшим числом сидов, пусть и меньшим качеством.
* **Кончилось место.** Уменьшите лимит кэша в настройках или удалите старые
  записи в библиотеке вручную.
* **Каталог не обновляется.** Обновление идёт раз в сутки, при отсутствии
  Wi-Fi — только если в настройках включено обновление по любой сети.
* **Останавливается при выключенном экране (телефон).** Разрешите
  приложению работать в фоне: Xiaomi/Poco — «Автозапуск» и «Без ограничений»
  в батарее; Samsung — убрать из «Переводить в спящий режим»; на приставках
  Android TV такого ограничения обычно нет.

## Что приложение отправляет на сервер

При обращении за каталогом и обновлениями приложение передаёт случайный
номер установки, версию приложения и версию Android — так считается число
установок и живых пользователей, отдельно от TorBook. Номер не связан с
телефоном, приставкой и аккаунтами. Что вы смотрите и ищете, на сервер не
уходит.