Getting Started RU

Быстрый старт

Установка

1. Скачайте последнюю сборку для вашей платформы: Releases
   • Windows: портативный .zip. Распакуйте в любую папку и запустите .exe, установщик не нужен
   • Linux: .tar.gz (экспериментально). Распакуйте и запустите файл
   • macOS: .dmg (экспериментально). Сборка без подписи, поэтому при первом запуске появится предупреждение Gatekeeper - откройте приложение через правый клик → Открыть. Как и на Linux, здесь нет браузера VGMaps и захвата скриншотов
   • Android: .apk
2. Установите и запустите приложение

Android: три способа установки

Сборки для Windows и Linux просто скачиваются. На Android есть выбор:

• APK напрямую - скачайте .apk из Releases и откройте. В первый раз Android попросит разрешить установку из браузера или файлового менеджера. Разрешите один раз.
• RuStore - установите из RuStore. Обновления приходят через магазин, как у любого другого приложения.
• Obtainium - если хотите обновления прямо с GitHub без магазина, используйте Obtainium. Нажмите Add App, вставьте https://github.com/hacan359/tonkatsu_box в поле источника и нажмите Add. Obtainium следит за Releases и ставит каждую новую версию сам. Android всё равно покажет окно установки для подтверждения, так что полностью тихого обновления без root нет.

Мастер настройки

При первом запуске откроется мастер настройки из 6 шагов.

Шаг 1 - Приветствие: Обзор приложения и его возможностей. Прочитайте и нажмите Далее.

Шаг 2 - Ваше имя: Введите имя - оно будет отображаться как автор на коллекциях, которые вы создаёте и экспортируете.

Шаг 3 - Язык: Выберите язык интерфейса (English, Русский, 中文, Español, Português (Brasil) или Français). Мастер мгновенно переключается на выбранный язык.

Шаг 4 - API ключи: Введите данные IGDB для поиска игр. Можно пропустить и настроить позже. Подробная инструкция →

Шаг 5 - Как это работает: Быстрый обзор коллекций, поиска и досок.

Шаг 6 - Готово!: Перейдите к настройкам или начните пользоваться.

💡 Мастер настройки можно запустить повторно из Настройки → Вводный тур.

Первые шаги

1. Найдите что-нибудь

Перейдите на вкладку Поиск. В первом сегменте панели фильтров выберите, что ищете (Фильмы, Сериалы, Игры, Аниме, Манга, Визуальные новеллы, Книги), и введите название. Отвечают сразу все источники этого типа; ряд Источники под панелью позволяет выключить лишние.

2. Добавьте в коллекцию

Нажмите на результат поиска → Добавить в коллекцию → выберите существующую коллекцию или создайте новую.

3. Просматривайте коллекцию

Перейдите на вкладку Коллекции. Откройте коллекцию - вы увидите сетку элементов с обложками.

4. Оценивайте и отслеживайте

Нажмите на элемент для открытия деталей. Установите статус (играю, завершено, брошено...), оцените от 1 до 10, добавьте заметки.

Что работает без API ключей?

Большая часть приложения работает без настройки API ключей:

• ✅ Создание коллекций и организация элементов
• ✅ Импорт готовых коллекций (.xcollx файлы)
• ✅ Оценки, статусы и заметки
• ✅ Визуальные доски (Canvas)
• ✅ Список желаний
• ✅ Экспорт и обмен коллекциями
• ✅ Поиск визуальных новелл, аниме, манги, книг и музыки (VNDB, AniList, Kitsu, MangaDex, MangaBaka, OpenLibrary, Fantlab, MusicBrainz - ключ не нужен)
• ✅ Поиск подкастов и отметки эпизодов (у Podcast Index есть встроенная пара ключей)
• ✅ Выбор темы в Настройки → Оформление → Тема (Тёмная или Сакура)

API ключи открывают поиск игр (IGDB) и фильмов/сериалов (TMDB, TheTVDB - у обоих есть встроенный ключ). Настроить API ключи →

Быстрый старт с готовыми коллекциями

Не хотите настраивать API ключи? Скачайте готовые коллекции с тысячами игр:

1. Перейдите на tonkatsu-collections
2. Скачайте любой .xcollx файл (например, snes-full-library.xcollx)
3. В приложении: Коллекции → Импорт → выберите файл
4. Готово - полная библиотека с обложками

Доступно: 23 ретро-платформы, 25 000+ игр. Плюс коллекции фильмов и аниме.

Горячие клавиши (десктоп)

На десктопе (Windows, Linux, macOS) можно управлять приложением полностью с клавиатуры:

Глобальные сочетания (работают везде):

Сочетание	Действие
Ctrl+1..6	Переключить на вкладку 1-6
Ctrl+Tab / Ctrl+Shift+Tab	Следующая / предыдущая вкладка
Escape / Alt+Left	Назад
Ctrl+F	Фокус на поиск
F5	Обновить текущий экран
F1	Показать горячие клавиши текущего экрана

Сочетания по экранам:

• Главная: Ctrl+N (создать коллекцию), Ctrl+I (импорт), Ctrl+Shift+V (переключить вид), Delete/F2 (на фокусированной карточке)
• Коллекция: Ctrl+N/E/I, Ctrl+B (доска), Ctrl+Shift+V (вид), Delete/Ctrl+M/F2 (на элементе)
• Детали: Alt+0..5 (рейтинг), Ctrl+B (доска), Ctrl+L (замок), Ctrl+M (переместить)
• Тир-листы: Ctrl+N (создать), Delete/F2 (на карточке)
• Вишлист: Ctrl+N (добавить), Ctrl+H (скрыть решённые), Ctrl+Shift+D (очистить решённые)

💡 Нажмите F1 на любом экране для шпаргалки по всем сочетаниям.

Поддержка геймпада

Tonkatsu Box поддерживает навигацию геймпадом на Windows, Linux, macOS и Android (отлично для хэндхелдов вроде Odin 2 или Steam Deck).

Маппинг кнопок:

Кнопка	Действие
LB / RB	Переключение основных вкладок
LT / RT	Переключение фильтров / под-вкладок
D-pad	Навигация по контенту
A	Подтвердить / открыть
B	Назад (аналог Escape)
Y	Контекстное меню (аналог правого клика)

Фокус автоматически переходит на первый элемент контента при переключении вкладок. Фокусируемые элементы показывают рамку в режиме геймпада.

Что дальше?

• Настроить API ключи для полного доступа к поиску
• Узнать о коллекциях - создание, сортировка, фильтры
• Импорт из Trakt.tv если есть история просмотров
• Визуальные доски для наглядной организации