Когда на телевизоре в гостиной фильм остановлен на 40-й минуте, а планшет в спальне показывает ту же картину как «не просмотренную», проблема почти всегда одна — каждое устройство с Kodi хранит собственную локальную базу данных, и прогресс просмотра между ними не синхронизируется. Решается это созданием общей медиатеки: все клиенты начинают работать с единым источником данных, и статус «просмотрено», метки остановки и коллекции становятся одинаковыми везде.
Существует два рабочих подхода: централизованная база на сервере MySQL/MariaDB и встроенный механизм UPnP, при котором одно устройство выступает «мастером» и раздаёт свою библиотеку остальным. Ниже разберём оба варианта, их ограничения и типичные ошибки настройки.
Как Kodi хранит медиатеку и почему возникает проблема
По умолчанию Kodi создаёт локальные базы данных в профиле пользователя: отдельно для видео (MyVideos с номером версии в имени файла) и отдельно для музыки. В этих базах хранятся не только списки фильмов и сериалов, но и дата добавления, количество воспроизведений, точка остановки и пользовательские коллекции.
Если у вас два и более устройства — например, приставка на Android TV и компьютер — каждая копия сканирует источники самостоятельно. Результат предсказуем: разные статусы просмотра, дубли при повторном сканировании и отсутствие единой точки остановки. Общая медиатека устраняет это, вынося базу данных за пределы отдельного устройства.
Способ 1: общая библиотека через UPnP
Самый простой вариант, не требующий установки дополнительного ПО. Одно устройство с Kodi включается как UPnP-сервер, а остальные подключаются к нему как к источнику. Активируется это в настройках: Настройки → Службы → UPnP/DLNA, где нужно включить пункты публикации библиотеки и обновлений.
На клиентских устройствах библиотека сервера добавляется через Видео → Файлы → Добавить видео → Обзор → UPnP-устройства. После этого клиенты видят разделы «Фильмы», «Сериалы» и «Клипы» так, как они организованы на сервере, включая статусы просмотра.
- 📺 Не требует установки стороннего сервера баз данных
- 🔄 Статусы просмотра синхронизируются через серверное устройство
- ⚡ Быстрая настройка — буквально несколько пунктов меню
- 🔌 Серверное устройство должно быть включено, иначе библиотека недоступна
⚠️ Внимание: главный недостаток UPnP — зависимость от «мастер»-устройства. Если приставка-сервер выключена или ушла в сон, остальные клиенты потеряют доступ к библиотеке. Для круглосуточной работы такой вариант подходит плохо.
Способ 2: централизованная база MySQL/MariaDB
Более надёжная архитектура — вынести базу данных на отдельный сервер с MariaDB или MySQL. Им может быть домашний NAS, постоянно включённый компьютер или мини-ПК. Все клиенты Kodi подключаются к этой базе по сети и работают с ней как с единым хранилищем.
Подключение настраивается через файл advancedsettings.xml, который размещается в папке userdata профиля Kodi. Путь к этой папке зависит от платформы: на Windows это каталог в %APPDATA%\Kodi\userdata, на Android — внутри служебной директории приложения, на Linux — ~/.kodi/userdata. Точное расположение для вашей платформы стоит сверить с официальной вики Kodi, так как оно может меняться между версиями.
<advancedsettings>
<videodatabase>
<type>mysql</type>
<host>192.168.1.10</host>
<port>3306</port>
<user>kodi</user>
<pass>kodi</pass>
</videodatabase>
<musicdatabase>
<type>mysql</type>
<host>192.168.1.10</host>
<port>3306</port>
<user>kodi</user>
<pass>kodi</pass>
</musicdatabase>
</advancedsettings>
На стороне сервера необходимо создать пользователя базы данных с правами на создание и изменение баз — Kodi при первом подключении сам создаст нужные базы и таблицы, если у учётной записи есть соответствующие привилегии. Сами базы вручную создавать не требуется.
☑️ Подготовка сервера MariaDB/MySQL для Kodi
Сравнение подходов
Выбор между UPnP и MySQL зависит от того, сколько у вас устройств, работают ли они круглосуточно и насколько важна независимость клиентов друг от друга.
| Критерий | UPnP | MySQL/MariaDB |
|---|---|---|
| Сложность настройки | Минимальная | Средняя, требует сервера БД |
| Зависимость от мастер-устройства | Да, сервер должен быть включён | Нет, база живёт отдельно |
| Синхронизация прогресса | Да | Да |
| Подходит для NAS | Только если на NAS установлен Kodi | Да, классический сценарий |
| Обновление библиотеки | На серверном устройстве | С любого клиента |
Общие источники файлов: важное условие
Общая база данных решает только половину задачи. Второе обязательное условие — одинаковые пути к медиафайлам на всех клиентах. В базе хранятся сетевые пути вида smb://server/movies/..., и если одно устройство добавило источник как локальную папку, а другое — как сетевую, записи не совпадут.
Поэтому ещё до настройки общей базы приведите источники к единому виду: используйте SMB- или NFS-шары с одинаковой структурой путей. Смешивание локальных и сетевых путей — самая частая причина ситуации, когда «база общая, а половина фильмов не воспроизводится».
⚠️ Внимание: не добавляйте один и тот же контент дважды — как локальную папку и как сетевой ресурс. В общей базе это создаст дубли, и статусы просмотра разойдутся между копиями записей.
Типичные ошибки и их диагностика
Если после настройки клиент не видит базу, проверяйте по порядку. Сначала — сетевую доступность сервера: пингуется ли хост, открыт ли порт. Затем — лог Kodi: ошибки подключения к базе фиксируются в kodi.log с указанием причины, будь то неверный пароль, отказ в доступе или недоступный хост.
- 🔑 Ошибка доступа — проверьте права пользователя БД и разрешённые хосты подключения
- 🌐 Тайм-аут подключения — брандмауэр сервера блокирует порт или MySQL слушает только localhost
- 📁 Пустая библиотека — клиенты используют разные пути к источникам
- 🐌 Медленная работа — слабый сервер БД или перегруженная сеть, особенно по Wi-Fi
Ещё один нюанс — версии Kodi. Номер базы данных меняется между крупными релизами, и клиенты на разных версиях могут создать в MySQL несколько параллельных баз, не видя записей друг друга. Держите версии Kodi на всех устройствах одинаковыми.
Почему в MySQL появилось несколько баз MyVideos
Kodi добавляет номер схемы к имени базы (например, MyVideos119, MyVideos121). При обновлении major-версии клиент создаёт новую базу и может импортировать данные из старой. Если устройства обновлялись в разное время, они окажутся на разных схемах. Решение — выровнять версии Kodi и при необходимости удалить устаревшие базы после резервного копирования.
Резервное копирование и обслуживание
Централизованная база — это и единая точка отказа. Повреждение MySQL-базы затронет сразу все устройства, поэтому регулярный экспорт обязателен. Встроенный механизм экспорта библиотеки в Kodi (Настройки → Медиа → Библиотека → Экспорт) сохраняет метаданные и статусы просмотра в файлы, из которых библиотеку можно восстановить.
Дополнительно имеет смысл настроить резервное копирование самой базы данных средствами сервера — например, штатным mysqldump по расписанию. Это стандартная практика для любых баз данных, и медиатека Kodi здесь не исключение.
Часто задаваемые вопросы
Можно ли объединить медиатеку без MySQL и без постоянно включённого сервера?
Да, через UPnP, но серверное устройство с Kodi должно быть включено в момент использования клиентов. Полностью автономной синхронизации «по расписанию» без общего сервера штатными средствами Kodi не предусмотрено.
Почему после настройки MySQL фильмы есть в списке, но не воспроизводятся?
Наиболее вероятная причина — несовпадение путей к файлам. Проверьте, что источники добавлены как сетевые ресурсы (SMB/NFS) с одинаковыми путями на всех устройствах, а не как локальные папки.
Нужно ли вручную создавать базы данных в MySQL?
Нет. Достаточно создать пользователя с правами на создание баз — Kodi при первом запуске с настроенным advancedsettings.xml создаст необходимые базы и таблицы автоматически.
Почему на одном устройстве библиотека видна, а на другом — пусто?
Чаще всего устройства работают на разных версиях Kodi и используют разные схемы базы данных. Выровняйте версии на всех клиентах и проверьте, что оба смотрят в одну и ту же базу на сервере.
Синхронизируется ли прогресс просмотра в реальном времени?
Точка остановки записывается в общую базу при паузе или завершении воспроизведения. После этого другой клиент может продолжить просмотр с того же места. Мгновенной синхронизации «кадр в кадр» между одновременно играющими устройствами нет.