Skip to content

API Keys Setup RU

hcan359 edited this page Mar 30, 2026 · 17 revisions

Настройка API ключей

Tonkatsu Box использует бесплатные API для получения данных об играх и фильмах. Все ключи бесплатны и настраиваются за несколько минут.

IGDB — для игр (рекомендуется)

IGDB принадлежит Twitch (Amazon), поэтому нужен аккаунт разработчика Twitch.

Пошаговая инструкция

  1. Перейдите на dev.twitch.tv/console и войдите (или создайте бесплатный аккаунт Twitch)
  1. Нажмите Register Your Application
  2. Заполните форму:
    • Name: что угодно (например, "my-tonkatsu")
    • OAuth Redirect URLs: http://localhost
    • Category: Application Integration
  3. Нажмите Create
  4. Откройте созданное приложение → скопируйте Client ID
  5. Нажмите New Secret → скопируйте Client Secret
  1. В Tonkatsu Box: перейдите в Настройки → API ключи
  2. Вставьте Client ID и Client Secret в секцию IGDB
  3. Нажмите Проверить подключение

✅ Готово! Теперь у вас доступ к 250 000+ игр на 220 платформах.

Решение проблем

  • «Ошибка подключения»: Проверьте что скопировали оба значения без лишних пробелов
  • «Не подключено»: Токен мог истечь — нажмите «Проверить подключение» ещё раз
  • Twitch просит 2FA: Возможно нужно включить двухфакторную аутентификацию в настройках Twitch

TMDB — для фильмов, сериалов и аниме (рекомендуется)

  1. Перейдите на themoviedb.org и создайте бесплатный аккаунт
  2. В профиле TMDB: Settings → API
  3. Нажмите Request an API Key → выберите Developer
  4. Заполните форму (любые данные — для личного использования)
  5. Скопируйте API Key (v3 auth)
  6. В Tonkatsu Box: Настройки → API ключи → секция TMDB → вставьте ключ

✅ Готово! Теперь доступен поиск фильмов, сериалов и аниме.

💡 Приложение имеет встроенный ключ TMDB для базового использования. Свой ключ рекомендуется при частом поиске.

Язык контента

После настройки TMDB можно выбрать язык описаний фильмов и сериалов:

Настройки → Язык контента → English или Русский

Это влияет на язык названий, описаний и жанров из TMDB.

SteamGridDB — для арта игр на досках (опционально)

  1. Перейдите на steamgriddb.com и создайте бесплатный аккаунт
  2. Перейдите в Preferences → API
  3. Скопируйте ваш API Key
  4. В Tonkatsu Box: Настройки → API ключи → секция SteamGridDB → вставьте

✅ Готово! Теперь можно добавлять качественный игровой арт на визуальные доски.

💡 Приложение имеет встроенный ключ SteamGridDB. Свой ключ опционален.

Без ключа

Эти источники работают без API ключей:

Источник Что предоставляет
VNDB Визуальные новеллы — поиск, теги, рейтинги
AniList Манга — поиск, жанры/формат, прогресс чтения (с v0.18.0)
Готовые коллекции .xcollx файлы с полными библиотеками — полностью оффлайн

Сводная таблица

Источник Для чего Нужен ключ? Время настройки
IGDB Игры (250K+ тайтлов) Да (бесплатный токен Twitch) ~2 мин
TMDB Фильмы, сериалы, аниме Да (бесплатный) или встроенный ~3 мин
SteamGridDB Арт игр для досок Опционально (есть встроенный) ~1 мин
VNDB Визуальные новеллы Нет —
AniList Манга (с v0.18.0) Нет —

🏠 Home


🇬🇧 English


🇷🇺 Русский


🇨🇳 中文


💬 Discord

Clone this wiki locally