Ошибка «Не удалось установить зависимость» при добавлении плагина в Kodi почти всегда означает одно из трёх: устаревший репозиторий, несовместимость дополнения с текущей версией медиацентра или отключённая установка из неизвестных источников. Проверить это можно за пару минут через раздел Система → Дополнения, и в большинстве ситуаций проблема решается без переустановки программы.
Плагины (в терминологии Kodi — дополнения или addons) расширяют функциональность медиацентра: добавляют источники видео и музыки, скрапперы метаданных, погодные сервисы, скины и утилиты обслуживания. Ниже разберём, откуда их брать, как устанавливать разными способами и что делать, когда дополнение отказывается работать.
Что такое плагины Kodi и какие они бывают
Дополнения для Kodi делятся на несколько категорий, и понимание этой классификации помогает быстрее находить нужное в меню. Основные типы:
- 🎬 Видеодополнения — источники фильмов, сериалов, IPTV и онлайн-трансляций;
- 🎵 Аудиодополнения — музыкальные сервисы, радио и подкасты;
- 🖼️ Скины и интерфейс — внешний вид медиацентра и раскладки меню;
- 🛠️ Программы и сервисы — утилиты очистки кэша, менеджеры библиотек, фоновые службы;
- 📚 Скрапперы — модули получения метаданных (постеры, описания, рейтинги) для локальной медиатеки.
Каждый плагин зависит от версии ядра Kodi. Дополнение, написанное под старую ветку (например, Kodi 18 Leia), может не заработать на актуальных сборках из-за перехода платформы на новую версию интерпретатора Python. Это одна из самых частых причин «невидимых» или неработающих плагинов.
Официальный репозиторий: самый безопасный способ
Официальный репозиторий встроен в Kodi по умолчанию и не требует никакой дополнительной настройки. Чтобы установить плагин из него, откройте Дополнения → Установить из репозитория → Kodi Add-on repository, выберите категорию и нужное дополнение, затем нажмите Установить. Система сама подтянет все зависимости.
Преимущество этого пути — проверенные версии и автоматические обновления. Недостаток очевиден: ассортимент ограничен, и многих популярных дополнений там нет. Для них придётся подключать сторонние источники, о чём ниже.
Включение установки из неизвестных источников
Сторонние репозитории и ZIP-файлы Kodi блокирует по умолчанию — это защитная мера. Чтобы разрешить установку, перейдите в Настройки → Система → Дополнения и активируйте переключатель Неизвестные источники. Программа покажет предупреждение о рисках — подтвердите действие.
⚠️ Внимание: сторонние плагины не проходят проверку командой Kodi. Устанавливайте дополнения только из источников, которым доверяете, и не давайте плагинам доступ к данным аккаунтов без необходимости. Вредоносные дополнения — реальный риск, а не теория.
После включения опции перезапускать Kodi не требуется — настройка применяется сразу. Если переключатель неактивен или сбрасывается, проверьте, не используется ли ограниченный профиль пользователя или сборка с жёстко заданными политиками.
Установка плагина из ZIP-файла и стороннего репозитория
Ручная установка нужна, когда дополнение распространяется архивом или когда сначала требуется добавить сам репозиторий. Порядок действий для репозитория:
☑️ Установка стороннего репозитория в Kodi
Источник добавляется через Настройки → Файловый менеджер → Добавить источник, где указывается URL, предоставленный автором репозитория. Затем в разделе дополнений выбирается Установить из ZIP-файла — и там появится добавленный источник с архивом репозитория.
Для одиночного плагина всё проще: скачанный ZIP кладётся в доступную папку (или на USB-накопитель для ТВ-приставки), после чего выбирается через тот же пункт Установить из ZIP-файла. Не распаковывайте архив вручную — Kodi устанавливает дополнения именно из целого ZIP, распакованная папка не распознаётся установщиком.
Типичные ошибки и их решения
Разберём сбои, с которыми пользователи сталкиваются чаще всего. Диагностику стоит начинать с журнала: лог Kodi доступен через Настройки → Система → Ведение журнала, а сам файл kodi.log лежит в папке данных программы (путь зависит от ОС).
| Ошибка | Вероятная причина | Что проверить |
|---|---|---|
| «Не удалось установить зависимость» | Устаревший репозиторий или несовместимость версий | Обновить репозиторий, сверить версию плагина с версией Kodi |
| Плагин установлен, но не запускается | Конфликт с другим дополнением или битый кэш | Очистить кэш плагина, отключить похожие дополнения |
| Репозиторий пустой | Недоступен URL источника или сменился адрес | Проверить адрес источника в файловом менеджере |
| Ошибка скрипта при запуске | Несовместимость с версией Python в текущей сборке | Найти обновлённую версию плагина под вашу ветку Kodi |
| Плагин пропал после обновления | Автообновление отключило несовместимое дополнение | Раздел «Мои дополнения» → проверить статус «Отключено» |
⚠️ Внимание: очистка данных дополнения через Мои дополнения → [плагин] → Очистить данные удалит его настройки и авторизации. Перед этим запишите токены и логины, если плагин работает с внешними сервисами.
Обновление и обслуживание дополнений
По умолчанию Kodi обновляет плагины автоматически, но этот механизм работает только для дополнений из подключённых репозиториев. Плагины, установленные из одиночного ZIP без репозитория, обновляться не будут — за новыми версиями придётся следить самостоятельно.
Проверить обновления вручную можно через Дополнения → Мои дополнения → Все: в контекстном меню плагина есть пункт Обновить. Там же видно, откуда дополнение установлено — полезно при диагностике конфликтов версий.
Как полностью сбросить настройки проблемного плагина
Откройте «Мои дополнения», найдите плагин, нажмите на него и выберите «Настроить». Если сброса там нет — используйте «Очистить данные» в информационной панели дополнения. В крайнем случае удалите папку плагина из каталога userdata/addon_data (путь зависит от ОС) при закрытом Kodi, затем запустите программу заново.
Безопасность и легальность
Сам по себе Kodi — легальный открытый медиацентр. Однако часть сторонних плагинов предоставляет доступ к контенту, распространяемому без лицензии. Ответственность за использование таких источников лежит на пользователе, а правила различаются в зависимости от страны.
С точки зрения безопасности устройства правила простые: минимум репозиториев (каждый лишний источник — потенциальный вектор доставки вредоносного кода через обновления), регулярное удаление неиспользуемых дополнений и отказ от «суперсборок» неизвестного происхождения. Готовые сборки часто содержат десятки плагинов, за актуальностью и чистотой которых никто не следит.
Часто задаваемые вопросы
Почему плагин не появляется в меню после установки?
Проверьте правильный раздел: видеодополнения отображаются в Дополнения → Видеодополнения, программы — в разделе «Программы». Также убедитесь, что дополнение включено в Мои дополнения — после обновлений Kodi несовместимые плагины автоматически отключаются.
Можно ли перенести плагины на другое устройство?
Да, но с оговорками. Копирование папок addons и userdata переносит дополнения и их настройки, однако пути к библиотекам и некоторые зависимости могут отличаться между ОС. Надёжнее установить плагины заново из тех же репозиториев и перенести только конфигурацию.
Что делать, если Kodi зависает при запуске после установки плагина?
Запустите программу и сразу отключите проблемное дополнение через Мои дополнения. Если Kodi не загружается совсем, переименуйте папку плагина в каталоге addons при закрытой программе — при следующем старте дополнение не подхватится.
Нужен ли VPN для плагинов Kodi?
Для работы самих дополнений VPN не требуется — это вопрос доступа к конкретным источникам контента и локальных ограничений сети. На техническую установку и обновление плагинов VPN не влияет, хотя медленное соединение через туннель может вызывать таймауты при загрузке зависимостей.
Как узнать, какая версия Kodi установлена?
Версия отображается на главном экране при запуске и в разделе Настройки → Информация о системе. Этот номер нужен в первую очередь при проверке совместимости любого нового плагина.