Kodi Sync RU

Синхронизация с Kodi

Синхронизируйте библиотеку фильмов Kodi с Tonkatsu Box по локальной сети. Фильмы сопоставляются с базой TMDB, с отслеживанием статуса просмотра, оценок и метаданных.

С v0.28.0 экран Kodi полностью локализован на русский. Раньше заголовки секций («Connection / Sync / Debug»), поля формы («Host/Port/Username/Password») и статусы («Running / Stopped / Never») были только на английском.

Что синхронизируется

Данные Kodi	Tonkatsu Box
Фильмы из VideoLibrary	Фильмы, найденные в TMDB
TMDB ID / IMDB ID	Используются для сопоставления
Статус просмотра (просмотрен)	Статус «Завершено»
Частично просмотрен	Статус «В процессе»
Не просмотрен	Статус «Запланировано»
Оценка пользователя (1-10)	Сохраняется как оценка
Дата последнего просмотра	Сохраняется как дата последнего просмотра
Наборы фильмов (movie sets)	Опциональные подколлекции (напр. «Harry Potter Collection (kodi)»)
Метаданные	Сохраняются в комментарии

Требования

• Kodi с включённым удалённым управлением по сети. Оба устройства должны быть в одной Wi-Fi или LAN сети.
• Ключ TMDB. Нужен для сопоставления фильмов. Настройка TMDB ->

Как настроить Kodi

Включите удалённое управление в Kodi, чтобы Tonkatsu Box мог подключиться:

1. Откройте Kodi
2. Перейдите в Настройки > Службы > Управление
3. Включите «Разрешить удалённое управление по HTTP»
4. Запомните Порт (по умолчанию: 8080)
5. При желании задайте Имя пользователя и Пароль

Как узнать IP-адрес Kodi

Вам нужен локальный IP устройства, на котором работает Kodi. Оба устройства (Kodi и Tonkatsu Box) должны быть в одной Wi-Fi / LAN сети.

Способ 1 - Внутри Kodi:

1. Перейдите в Настройки > Информация о системе > Сеть
2. IP-адрес отображается на экране (напр. 192.168.1.105)

Способ 2 - На самом устройстве с Kodi:

• Windows: откройте командную строку → введите ipconfig → найдите IPv4-адрес в разделе Wi-Fi или Ethernet адаптера
• Linux: откройте терминал → введите ip a или hostname -I
• Android (Kodi на ТВ-приставке): Настройки > Сеть > Wi-Fi > нажмите на подключённую сеть → IP-адрес
• macOS: Системные настройки > Сеть → IP показан для активного подключения

Совет: IP обычно выглядит как 192.168.x.x или 10.0.x.x. Если подключаетесь с телефона - убедитесь, что он на том же Wi-Fi, что и Kodi, а не на мобильных данных.

Как настроить синхронизацию

1. В Tonkatsu Box: перейдите в Настройки > Интеграции > Kodi
2. Введите Хост - IP-адрес, который нашли выше (напр. 192.168.1.105)
3. Введите Порт (по умолчанию: 8080)
4. Введите Имя пользователя и Пароль (если заданы в Kodi)
5. Нажмите Проверить соединение для проверки подключения
6. Выберите целевую коллекцию:
   • Создать новую коллекцию - создаст новую коллекцию для фильмов Kodi
   • Использовать существующую - выбор из списка
7. Настройте параметры синхронизации:
   • Интервал синхронизации, как часто приложение проверяет Kodi.
   • Подколлекции, создавать ли отдельные подколлекции из наборов фильмов Kodi.
   • Импорт оценок, синхронизировать ли оценки из Kodi (шкала 1-10).
8. Включите переключатель синхронизации для запуска

Как работает синхронизация

Tonkatsu Box с заданным интервалом проверяет вашу библиотеку Kodi:

1. Читает список фильмов из Kodi.
2. Сопоставляет каждый фильм с TMDB по TMDB ID из данных Kodi.
3. Если TMDB ID не нашёлся, использует IMDB ID.
4. Найденные фильмы добавляет в выбранную коллекцию.
5. Обновляет статус просмотра, оценки, даты просмотра и комментарии.

Первая и последующие синхронизации

• Первая синхронизация заполняет целевую коллекцию всеми фильмами из Kodi
• Последующие синхронизации обновляют существующие элементы - статус просмотра, оценки, даты последнего просмотра и комментарии обновляются актуальными данными из Kodi

Подколлекции

Когда опция подколлекций включена:

• Наборы фильмов Kodi (напр. «Гарри Поттер», «Властелин колец») создаются как отдельные подколлекции
• Названия подколлекций включают суффикс «(kodi)» для отличия
• Фильмы из набора появляются как в основной коллекции, так и в своей подколлекции

Оценки

Когда опция импорта оценок включена:

• Пользовательские оценки Kodi (шкала 1-10) синхронизируются в Tonkatsu Box
• Оценки всегда перезаписываются - приоритет у последней оценки из Kodi
• Отключите эту опцию, если хотите управлять оценками вручную в Tonkatsu Box

Индикатор в шапке

Когда синхронизация с Kodi настроена и включена, в шапке приложения (только десктоп) появляется иконка Kodi - между полем поиска и шестерёнкой настроек.

• Цветная (голубой Kodi). Таймер синхронизации работает.
• Серая. Синхронизация остановлена.
• Пульсирующая. Прямо сейчас идёт обновление.
• Клик включает или останавливает таймер.
• Наведение показывает подсказку со статусом.

Это позволяет быстро видеть, активна ли синхронизация с Kodi, и приостанавливать/возобновлять её без открытия настроек.

Автоматическая остановка

Если целевая коллекция удалена из Tonkatsu Box, синхронизация с Kodi автоматически останавливается. Для возобновления выберите новую целевую коллекцию в настройках.

Советы

• Убедитесь, что Kodi и Tonkatsu Box находятся в одной локальной сети
• Используйте Проверить соединение перед включением синхронизации, чтобы заранее выявить проблемы конфигурации
• Целевую коллекцию можно сменить в любой момент - следующая синхронизация будет использовать новую коллекцию
• Подколлекции удобны для организации серий фильмов без ручной сортировки
• Если Kodi недоступен во время цикла синхронизации, служба повторит попытку на следующем интервале