Если установленный в Kodi аддон перестал обновляться или выдал ошибку «зависимость не найдена», первым делом проверьте источник, из которого он был установлен: чаще всего причина в неработающем репозитории.
Репозиторий — это удалённое хранилище, в котором разработчики публикуют дополнения (аддоны) для медиацентра Kodi. Без репозитория программа умеет работать только с локальными файлами: фильмами, музыкой и фотографиями на диске. Именно репозитории открывают доступ к онлайн-кинотеатрам, IPTV-плейлистам, скинам, субтитрам и десяткам других расширений. Разберёмся, как устроена эта система, как безопасно устанавливать источники и что делать, если аддон отказывается работать.
Что такое репозиторий и зачем он нужен
Технически репозиторий — это веб-сервер с определённой структурой каталогов, где лежат zip-архивы аддонов и индексный файл с их описанием. Когда вы добавляете репозиторий в Kodi, программа периодически обращается к этому серверу и проверяет наличие обновлений.
Такой подход удобнее ручной установки по трём причинам:
- 🔄 Автоматические обновления — аддон обновляется сам, как только разработчик выкладывает новую версию.
- 📦 Разрешение зависимостей — если аддону нужны вспомогательные модули, Kodi подтянет их из того же репозитория.
- 🗂️ Каталогизация — все доступные дополнения видны в одном списке с описаниями и версиями.
Важно понимать разницу: аддон — это само расширение, а репозиторий — «магазин», из которого оно устанавливается. Удаление репозитория не удалит уже установленные аддоны, но они перестанут обновляться.
Официальный и сторонние репозитории
В каждую сборку Kodi уже встроен официальный репозиторий — он доступен сразу после установки программы через раздел Установить из репозитория. Все дополнения там проходят модерацию, поэтому риск подхватить вредоносный код минимален.
Сторонние репозитории поддерживаются независимыми разработчиками и командами энтузиастов. Их доступность и содержимое меняются: проекты закрываются, переезжают на новые адреса, теряют поддержку. Поэтому любой «список рабочих репозиториев» быстро устаревает — конкретный адрес стоит искать на официальной странице нужного аддона или в его сообществе, а не в подборках неизвестной давности.
Как установить репозиторий в Kodi
Установка стороннего репозитория состоит из двух этапов: добавления источника и установки zip-файла. Порядок действий в актуальных версиях Kodi примерно одинаков на Windows, Android и других платформах, хотя названия пунктов могут немного отличаться в зависимости от версии и языка интерфейса.
Настройки → Файловый менеджер → Добавить источник → указать URL
Настройки → Дополнения → Установить из zip-файла → выбрать источник
Сначала откройте файловый менеджер в настройках и добавьте новый источник, указав адрес репозитория и понятное имя. Затем в разделе дополнений выберите установку из zip-файла и найдите добавленный источник. После установки архива репозиторий появится в списке, и из него можно ставить аддоны через Установить из репозитория.
☑️ Перед установкой стороннего репозитория
⚠️ Внимание: установка из неизвестных источников отключена по умолчанию не случайно. Включайте её только для проверенных репозиториев и по возможности отключайте обратно после установки — это снизит риск случайной установки вредоносных дополнений.
Сравнение способов установки аддонов
Аддон в Kodi можно поставить тремя способами. У каждого есть свои плюсы и ограничения:
| Способ | Обновления | Зависимости | Кому подходит |
|---|---|---|---|
| Официальный репозиторий | Автоматически | Ставятся сами | Всем пользователям |
| Сторонний репозиторий | Автоматически | Ставятся сами | Тем, кому нужен конкретный аддон |
| Zip-файл аддона напрямую | Только вручную | Возможны ошибки | Для разовой установки |
Как видно из таблицы, установка одиночного zip-файла — худший вариант для постоянного использования: аддон, установленный напрямую из архива, не получает обновлений и может перестать работать после смены API онлайн-сервиса. Поэтому, если разработчик предлагает репозиторий, предпочтительнее ставить именно его.
Типичные ошибки и их решения
Самая частая жалоба — сообщение «не удалось подключиться к репозиторию» при установке. Возможных причин несколько, и проверять их стоит по порядку.
Сначала убедитесь, что адрес источника введён без опечаток и сервер действительно доступен: откройте тот же URL в браузере на любом устройстве. Если страница не открывается и там — проблема на стороне сервера или в блокировке провайдером, а не в Kodi.
- 🌐 Ошибка сети — проверьте, не блокирует ли адрес роутер, антивирус или провайдер.
- 🔢 Несовместимость версий — аддон, собранный под старую версию Kodi, может не ставиться на новую; ищите обновлённую сборку.
- 🧩 Конфликт зависимостей — попробуйте обновить сам Kodi и переустановить репозиторий.
- 🗑️ Битый кэш — очистите кэш пакетов через настройки дополнений или удалите и заново добавьте источник.
Если ничего не помогает, полезно заглянуть в журнал: Kodi пишет подробный лог, где видно, на каком именно этапе происходит сбой. Путь к файлу лога зависит от платформы — уточните его в официальной документации для вашей ОС.
Где искать лог Kodi
Расположение файла kodi.log различается: на Windows — в папке AppData профиля пользователя, на Android — во внутреннем хранилище в каталоге данных приложения, на Linux — в скрытой папке .kodi домашнего каталога. Точный путь для вашей платформы смотрите в официальной вики Kodi.
Безопасность при работе со сторонними источниками
Аддоны — это исполняемый код, который получает доступ к сети и файловой системе устройства. Недобросовестный репозиторий теоретически может распространять вредоносные дополнения, поэтому к выбору источников стоит относиться так же внимательно, как к установке программ на компьютер.
⚠️ Внимание: часть сторонних аддонов предоставляет доступ к контенту, распространяемому без лицензии. Использование таких дополнений может нарушать законодательство вашей страны — перед установкой проверяйте правовой статус сервиса, к которому обращается аддон.
Разумные меры предосторожности: ставьте репозитории только по ссылкам с официальных страниц проектов, не устанавливайте «сборки» (builds) от неизвестных авторов — они перезаписывают настройки и могут содержать десятки непроверенных аддонов, — и периодически удаляйте источники, которыми больше не пользуетесь.
Обновление и удаление репозиториев
Отдельно обновлять репозиторий вручную обычно не требуется — Kodi сам проверяет свежие версии при запуске и в фоне. Если проверку нужно форсировать, откройте список установленных репозиториев и выберите в контекстном меню пункт проверки обновлений.
Удаление выполняется в два шага. Сначала удалите сам репозиторий через раздел Мои дополнения → Репозитории, затем при желании уберите его адрес из файлового менеджера. Установленные из него аддоны останутся в системе, но перестанут получать обновления — если аддон больше не нужен, удалите и его.
Часто задаваемые вопросы
Можно ли использовать Kodi без сторонних репозиториев?
Да. Официальный репозиторий встроен в программу и содержит сотни проверенных аддонов: клиенты популярных сервисов, скраперы, скины, погодные провайдеры. Сторонние источники нужны только если требуемого дополнения там нет.
Почему репозиторий вчера работал, а сегодня нет?
Сторонние проекты часто меняют адреса или закрываются. Проверьте официальную страницу аддона — возможно, репозиторий переехал на новый URL, и источник нужно добавить заново с актуальным адресом.
Удалится ли аддон, если удалить репозиторий?
Нет, уже установленные дополнения останутся и продолжат работать. Но они лишатся автоматических обновлений, поэтому со временем могут перестать функционировать из-за изменений на стороне онлайн-сервисов.
Безопасно ли включать «Неизвестные источники»?
Сама по себе опция лишь снимает ограничение на установку zip-файлов. Риск появляется при установке непроверенных репозиториев, поэтому добавляйте только источники с официальных страниц проектов и отключайте опцию после завершения установки.
Совместимы ли аддоны между разными версиями Kodi?
Не всегда. Крупные релизы Kodi иногда меняют программные интерфейсы, и старые аддоны могут отказаться устанавливаться. Ищите версию дополнения, собранную именно под ваш релиз программы, — обычно разработчик указывает совместимость в описании.