# TorBook: как поставить и как пользоваться

Приложение для Android 10 и новее. Каталог аудиокниг рутрекера, поиск по
названию, автору, чтецу и по смыслу, загрузка на телефон и плеер. Всё
работает без регистрации и без входа на рутрекер.

## Установка (5 минут)

1. Откройте на телефоне в браузере адрес **https://tor.buildcorez.ru/** и нажмите
   **«Скачать TorBook»**. Файл около 50 МБ.
2. Откройте скачанный файл из уведомления или из папки «Загрузки».
3. Если телефон спросит, разрешите браузеру устанавливать приложения. Это
   одноразовое разрешение для браузера.
4. Появится окно **Google Play Защита** с кнопкой «Проверить приложение».
   Нажмите **«Подробнее»**, затем **«Установить без проверки»**. Приложение не
   из магазина, поэтому Play Защита его не знает. Отправлять в Google ничего не
   нужно.
5. Нажмите «Установить». На Xiaomi система ещё раз спросит разрешение на
   установку, ответьте «Установить».
6. Откройте TorBook и нажмите **«Загрузить каталог»**. Это около 85 МБ один
   раз, дальше каталог обновляется сам раз в сутки по Wi-Fi небольшими
   разницами в 1–3 МБ.
7. Для голосового управления нажмите микрофон: приложение один раз предложит
   скачать модель распознавания, 46 МБ.

Обновления приложение находит само и показывает кнопку «Обновить TorBook»
на главном экране. Play Защита спросит при каждом обновлении, ответ тот же:
«Подробнее», «Установить без проверки».

## Чтобы работало в фоне

Телефон должен разрешить приложению работать при погашенном экране, иначе
загрузка и воспроизведение останавливаются.

* **Xiaomi, Poco (MIUI, HyperOS):** Настройки, Приложения, TorBook: включить
  **«Автозапуск»**, в разделе «Батарея» выбрать **«Без ограничений»**.
* **Samsung (One UI):** Настройки, Батарея, Ограничения в фоновом режиме:
  добавить TorBook в **«Приложения без ограничений»** и убрать его из списка
  «Переводить в спящий режим».
* **Huawei, Honor:** Настройки, Батарея, Запуск приложений: TorBook,
  выключить «Автоматически», включить все три пункта вручную.
* **Остальные:** Настройки, Приложения, TorBook, Батарея: «Без ограничений».

## Как пользоваться

**Поиск.** Введите или скажите что угодно: «Стругацкие», «Пикник на обочине»,
«читает Князев», «книга про сталкера и зону», «что-нибудь про выживание на
Марсе». Служебные слова не мешают, «вархаммер» и «сталкер» находят Warhammer
и S.T.A.L.K.E.R. Над списком появляются чипы: авторы и чтецы, циклы и серии
(«Цикл: Вселенная Метро 2033 · 57»), нажатие открывает полку. Показываются
первые 200 найденных, при прокрутке до конца подгружаются остальные.

**Жанры.** Пока строка поиска пуста, над списком ряд разделов: Фантастика,
Детективы, Любовные, Классика, Детская и другие. Внутри раздела порядок
«Новые», «Популярные», «По рейтингу», у фантастики ещё ряд поджанров
(космоопера, тёмное фэнтези, попаданцы).

**Полки.** Полка автора или чтеца открывается с чипа над результатами, из
карточки (имя автора, имя чтеца у раздачи) и из библиотеки (нажатие на
строку «автор · читает …»). На полке порядок: по сериям, новые, по
рейтингу. Полка цикла показывает и книги, которых в каталоге нет, серым.
Всё синее в приложении можно нажать.

**Карточка книги.** Вверху рейтинг Fantlab и цикл («книга 3 из 11»), жанры,
фраза о книге и темы, ниже аннотация и раздачи с числом сидов и битрейтом. Кнопка **«Скачать и слушать»**
ставит загрузку и через 10–30 секунд начинает играть. Раздача с 1–3 сидами
может качаться медленно. Нажатие на строку с годом и битрейтом открывает
тему раздачи на рутрекере в браузере (там комментарии слушателей), ссылка
«Отзывы и оценки на Fantlab» ведёт на страницу книги с отзывами.

**Плеер.** Список глав в естественном порядке (прологи перед первой главой),
стрелками ▲▼ порядок можно поправить. Перемотка на 30 секунд, скорость,
закладки, таймер сна. После паузы книга сама отматывается назад, чтобы
вспомнить, на чём отвлеклись: на 2 секунды после короткой паузы, на 10 после
паузы до десяти минут, на 30 после долгой; в настройках можно поставить
фиксированные 5, 10 или 15 секунд или выключить. Долгое нажатие на ▶ выбирает, что делать с
оповещениями: продолжать (по умолчанию), приглушать, пауза. Звонок всегда
ставит паузу и возвращает книгу после разговора.

**Библиотека.** Все скачанные книги с занятым местом. Долгое нажатие удаляет
книгу вместе с файлами, нажатие на строку автора ведёт к полкам и карточке.

**Настройки** (⚙ на главном экране): что делать с оповещениями во время
книги, автоматический таймер сна после заданного часа и его длительность,
скорость по умолчанию, обновление каталога и загрузки только по Wi-Fi или
по любой сети.

**Таймер сна.** «Спать через 30 минут» или «до конца главы»: последние пять
минут звук плавно затухает, потом пауза.

## Голосовые команды

Нажмите микрофон и говорите обычным голосом. Книга на время команды
замолкает. Если приложение не поняло, оно покажет, что услышало.

| Что сказать | Что произойдёт |
|---|---|
| пауза, стоп | пауза |
| играй, продолжай | воспроизведение |
| назад, вперёд | на 30 секунд |
| назад на минуту, вперёд на пять минут, назад на десять секунд | перемотка на указанное время |
| следующая глава, предыдущая глава, сначала главы | по главам |
| быстрее, медленнее, обычная скорость, скорость полтора, скорость два | скорость |
| спать через двадцать минут, спать через полчаса, спать через час | таймер сна |
| спать до конца главы, отмени таймер | таймер сна |
| громче, тише | громкость |
| закладка | закладка на текущем месте |
| что играет | название и глава |
| открой библиотеку, открой плеер | экраны |
| найди Пелевина, ищи книга про драконов, или просто фраза без команды | поиск |

Порядок слов не важен: «на пять минут вперёд» и «вперёд на пять минут» одно
и то же. Число минут любое: «спать через сорок пять минут».

## Что приложение отправляет на сервер

При обращении за каталогом и обновлениями приложение передаёт случайный
номер установки, версию приложения и версию Android. По ним считается,
сколько установок и сколько из них живых. Номер не связан с телефоном и
аккаунтами, личных данных нет. Что вы ищете и слушаете, на сервер не уходит.

## Если что-то не так

* **Не качается.** Посмотрите число сидов в карточке. Если включён VPN, часть
  пиров недоступна: через туннель нет входящих соединений, качают только те,
  кто сам принимает связь. Попробуйте другую раздачу той же книги.
* **Останавливается при погашенном экране.** См. раздел про фон выше.
* **Не слышит команды.** Говорите ближе к телефону, без музыки рядом. Если
  ответ «Не понял: …» показывает почти правильную фразу, скажите короче:
  «вперёд», «назад», «пауза».
* **Каталог не обновляется.** Обновление идёт по Wi-Fi раз в сутки. Кнопка
  «Загрузить каталог» обновляет сразу, через мобильную сеть тоже.
