Если при попытке установить дополнение Kodi выдаёт ошибку «Could not connect to repository» или список дополнений пуст, причина почти всегда кроется в неработающем адресе репозитория или в отключённой настройке неизвестных источников. Проверить это можно за пару минут: откройте Настройки → Система → Дополнения и убедитесь, что переключатель Непроверенные источники (Unknown sources) включён, а затем проверьте сам URL источника в файловом менеджере.
Репозиторий (repository) в экосистеме Kodi — это сервер, на котором хранятся дополнения (add-ons): видеоплагины, скины, скрапперы, сервисные утилиты. Без подключённого репозитория медиацентр ограничен лишь базовыми функциями. В этой статье разберём, как устроены репозитории, как их добавлять, обновлять и что делать при типовых ошибках.
Что такое репозиторий дополнений Kodi
Репозиторий — это по сути каталог с индексным файлом, в котором перечислены доступные дополнения, их версии и зависимости. Kodi периодически обращается к этому индексу, проверяет обновления и предлагает установить новые версии уже добавленных плагинов. Таким образом, репозиторий выполняет роль магазина приложений внутри медиацентра.
Из коробки в Kodi уже подключён официальный репозиторий Kodi Add-on Repository. Он содержит дополнения, прошедшие проверку командой проекта: они не нарушают правила и, как правило, стабильно работают. Всё, что находится за пределами официального каталога, относится к сторонним (third-party) репозиториям — их нужно добавлять вручную.
Важно понимать разницу: дополнение — это сам плагин, а репозиторий — место, откуда он устанавливается и обновляется. Удалив репозиторий, вы не удалите уже установленные дополнения, но перестанете получать для них обновления.
Как включить установку из неизвестных источников
По умолчанию Kodi блокирует установку сторонних репозиториев — это мера безопасности. Чтобы добавить внешний источник, необходимо сначала разрешить его в настройках. Путь может незначительно отличаться в зависимости от версии Kodi и используемого скина, но общая логика одинакова.
- 🔧 Откройте
Настройки(значок шестерёнки на главном экране). - ⚙️ Перейдите в раздел
Система(System). - 📂 Выберите вкладку
Дополнения(Add-ons) в левом меню. - ✅ Активируйте переключатель
Непроверенные источники(Unknown sources) и подтвердите действие в диалоге предупреждения.
⚠️ Внимание: включение непроверенных источников снимает встроенную защиту Kodi. Устанавливайте репозитории только из источников, которым доверяете: сторонние дополнения выполняют код на вашем устройстве и теоретически могут содержать вредоносные компоненты. После установки нужных дополнений опцию можно снова отключить — уже установленные плагины продолжат работать.
Добавление репозитория через URL
Самый распространённый способ — добавить источник по адресу, а затем установить из него репозиторий. Вам понадобится точный URL, который публикует разработчик репозитория. Действуйте по шагам.
Сначала откройте Настройки → Файловый менеджер → Добавить источник. В поле пути выберите <Нет> и введите адрес репозитория в точности так, как он указан разработчиком, включая http:// или https://. Задайте понятное имя источника — оно будет отображаться в списке. Опечатка в одном символе приведёт к тому, что источник окажется пустым или недоступным.
Затем вернитесь в главное меню и пройдите по пути Дополнения → Установить из ZIP-файла (значок открытой коробки вверху). Выберите добавленный источник и внутри него файл вида repository.xxx.zip. Через несколько секунд появится уведомление об установке репозитория. После этого сам репозиторий становится доступен через пункт Установить из репозитория.
☑️ Проверка перед добавлением репозитория
Установка репозитория из ZIP-файла напрямую
Альтернативный метод — скачать ZIP-архив репозитория на устройство и установить его локально, без добавления источника по URL. Это удобно, когда сайт разработчика не предоставляет постоянный адрес, а только файл для скачивания.
Сохраните файл repository.xxx.zip в любую папку на устройстве (например, в Загрузки). Затем в Kodi откройте Дополнения → Установить из ZIP-файла, перейдите в папку с файлом и выберите его. Результат тот же: репозиторий появится в списке установленных.
У этого способа есть нюанс. Если репозиторий установлен из локального файла, а не по сетевому адресу, механизм автоматического обновления самого репозитория может работать иначе — всё зависит от того, прописан ли внутри репозитория адрес для самообновления. На практике большинство актуальных репозиториев обновляются корректно в обоих случаях, но при проблемах стоит переустановить репозиторий через URL-источник.
Типичные ошибки и их решения
Чаще всего пользователи сталкиваются с небольшим набором повторяющихся проблем. Ниже — таблица с симптомами и направлениями диагностики.
| Симптом | Возможная причина | Что проверить |
|---|---|---|
| «Could not connect to repository» | Недоступен сервер или неверный URL | Открыть адрес в браузере, проверить интернет |
| Источник добавлен, но пустой | Опечатка в адресе или некорректная структура | Сверить URL посимвольно, убрать лишний слеш |
| «Failed to install a dependency» | Не установилась зависимость дополнения | Обновить репозиторий, проверить совместимость версий |
| Репозиторий не появляется в списке | ZIP не содержит репозиторий или установка прервана | Повторить установку, проверить целостность файла |
| Дополнения не обновляются | Отключено автообновление или репозиторий удалён | Проверить настройки обновлений дополнений |
Отдельно стоит сказать про ошибку зависимостей «The dependency on ... could not be satisfied». Она означает, что дополнению требуется другой модуль (например, определённая версия скраппера или библиотеки), который не найден. Обычно помогает принудительное обновление репозитория: откройте список установленных репозиториев, вызовите контекстное меню нужного и выберите Проверить обновления. Если проблема сохраняется, возможно, дополнение несовместимо с вашей версией Kodi — тогда стоит поискать актуальную сборку плагина у разработчика.
Безопасность при работе со сторонними репозиториями
Сторонние репозитории не проходят проверку командой Kodi, поэтому ответственность за их содержимое лежит на пользователе. Минимальный набор правил поможет снизить риски.
- 🛡️ Добавляйте репозитории только с официальных страниц разработчиков, а не с перепостов и сомнительных агрегаторов ссылок.
- 🔍 Проверяйте, жив ли проект: давно не обновлявшийся репозиторий может быть заброшен или перехвачен.
- 🧹 Удаляйте репозитории, которыми больше не пользуетесь, — каждый лишний источник это потенциальная точка риска.
- 📦 Избегайте «сборок» (builds) от неизвестных авторов: они меняют десятки настроек и устанавливают множество дополнений сразу.
⚠️ Внимание: часть сторонних дополнений предоставляет доступ к контенту, распространение которого может нарушать авторские права в вашей стране. Ответственность за использование таких дополнений несёт пользователь. Перед установкой изучите, что именно делает плагин и откуда он берёт контент.
Если репозиторий внезапно сменил владельца или начал предлагать подозрительные обновления, безопаснее удалить его вместе со всеми установленными из него дополнениями. Обновления приходят автоматически, и скомпрометированный репозиторий может доставить вредоносный код на все устройства, где он подключён.
Как полностью удалить репозиторий и его дополнения
Сначала откройте Дополнения → Мои дополнения → Все и удалите плагины, установленные из этого репозитория. Затем в разделе «Репозитории дополнений» найдите сам репозиторий, откройте его и нажмите «Удалить». После этого зайдите в Файловый менеджер и удалите соответствующий источник. Такой порядок гарантирует, что не останется «осиротевших» дополнений без источника обновлений.
Обновление и обслуживание репозиториев
Kodi по умолчанию проверяет обновления дополнений автоматически, но сам список репозиториев имеет смысл периодически пересматривать вручную. Раз в несколько месяцев откройте Дополнения → Мои дополнения → Репозитории дополнений и оцените: какие источники реально используются, какие давно не обновлялись, какие вы добавили «на пробу» и забыли.
Если дополнение внезапно перестало работать, первым делом проверьте его репозиторий: возможно, сервер недоступен или проект переехал на новый адрес. В таком случае старый источник удаляется, добавляется новый URL, и репозиторий устанавливается заново — сами дополнения при этом обычно сохраняют настройки.
Часто задаваемые вопросы
Чем репозиторий отличается от дополнения?
Дополнение — это сам плагин, добавляющий функции (видео, музыку, скины, сервисы). Репозиторий — каталог, из которого дополнения устанавливаются и через который они получают обновления. Один репозиторий обычно содержит много дополнений.
Безопасно ли включать «Непроверенные источники»?
Сама по себе опция лишь снимает ограничение на установку. Риск появляется при добавлении недоверенных репозиториев. Включайте опцию только на время установки и добавляйте источники от проверенных разработчиков.
Почему репозиторий установился, но внутри пусто?
Возможные причины: сервер репозитория временно недоступен, в адресе источника опечатка, либо репозиторий несовместим с вашей версией Kodi. Проверьте URL в браузере и попробуйте обновить репозиторий через контекстное меню.
Нужно ли заново добавлять репозитории после обновления Kodi?
Как правило, нет: настройки и установленные дополнения сохраняются при обновлении. Однако часть сторонних дополнений может оказаться несовместимой с новой версией — их придётся обновить или заменить.
Можно ли использовать Kodi только с официальным репозиторием?
Да. Официальный репозиторий содержит сотни дополнений: медиаплееры, скрапперы, погоду, субтитры, скины и сервисные утилиты. Для многих задач этого каталога достаточно, и это самый безопасный вариант использования.