Kodi: домашний медиацентр на Linux

Kodi превращает компьютер или мини-ПК с Linux в полноценный медиацентр: библиотека фильмов и сериалов с постерами и описаниями, музыка, фотографии, субтитры, воспроизведение 4K и управление с телефона. Всё хранится локально, интернет нужен только для получения метаданных и обложек. Разберём установку, настройку библиотеки, аппаратное ускорение, удалённое управление и типичные ошибки.

Что такое Kodi и как он устроен

Kodi — свободный медиаплеер с собственным интерфейсом, рассчитанный на экран телевизора и управление пультом. Он не хранит видео у себя: вы указываете каталоги на диске, сетевом хранилище или медиасервере, а Kodi индексирует файлы и подтягивает описания из открытых баз.

Интерфейс строится из скинов, функциональность расширяется аддонами. Используйте собственные файлы и легальные сервисы: сторонние репозитории с непроверенными аддонами часто содержат вредоносные скрипты и ломают обновления.

Данные пользователя лежат в профиле: у нативной установки это ~/.kodi, у Flatpak — ~/.var/app/tv.kodi.Kodi/data. Внутри база library.db, настройки, кеш обложек и логи. Именно эту папку резервируют перед переустановкой.

Установка

Универсальный способ — Flatpak: версия обновляется независимо от дистрибутива, а зависимости изолированы. В Debian и Ubuntu Kodi есть в репозитории, но пакет может отставать на несколько выпусков.

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install flathub tv.kodi.Kodi
flatpak run tv.kodi.Kodi
sudo apt install kodi
kodi --version

Для Flatpak при первом запуске скачивается runtime, это занимает пару минут. Проверьте, что видеодрайвер и PipeWire работают: звук в Kodi идёт через системный сервер, а не напрямую в ALSA.

pactl info
vainfo
flatpak run tv.kodi.Kodi --debug

Команда vainfo показывает поддержку аппаратного декодирования. Если вывод пуст или содержит ошибку, установите пакет mesa-va-drivers для AMD и Intel и перезайдите в графический сеанс.

Первичная настройка

В разделе Settings → Interface выберите язык, шрифт и регион. Для телевизора удобен масштаб интерфейса 1.0–1.2 и скин Estuary: он идёт из коробки и потребляет меньше ресурсов, чем тяжёлые темы.

Звук настраивается в Settings → System → Audio. Для стереоколонок достаточно выбрать устройство PipeWire и схему 2.0. Если есть ресивер, включите passthrough для AC3, E-AC3 и DTS — тогда декодированием займётся внешнее устройство.

Экран и частота кадров: включите «Adjust display refresh rate», чтобы Kodi переключал телевизор на 24 Гц для фильмов. На некоторых драйверах это вызывает чёрный экран на пару секунд — это нормально, но проверьте, что кабель и порт поддерживают нужный режим.

Библиотека фильмов и сериалов

Создайте отдельные каталоги и придерживайтесь схемы именования: для фильма «Название (год).mkv», для серии «Сериал/Сезон 01/Сериал S01E01.mkv». Тогда скрапер TMDB или TVDB распознает файлы без ручной правки.

mkdir -p ~/media/movies ~/media/series
ls ~/media/movies
find ~/media/series -maxdepth 2 -type d

В интерфейсе: Videos → Files → Add videos → Browse. Укажите источник, затем в контекстном меню выберите «Set content» и тип содержимого — Movies или TV shows. Скрапер и язык описаний задаются там же; для русских описаний выберите ru в настройках скрапера.

Сетевые каталоги подключаются через NFS или SMB. Для SMB укажите путь smb://server/share и учётные данные. Если библиотека большая, первый импорт может идти десятки минут — не закрывайте Kodi и не выключайте сеть.

Ускорение видео и 4K

В Settings → Player → Videos включите аппаратное декодирование. На Intel и AMD используется VA-API, на NVIDIA — VDPAU или NVDEC. Проверьте загрузку процессора при 4K: если она близка к 100 %, ускорение не работает.

intel_gpu_top
nvidia-smi
top -p $(pgrep -f kodi | head -1)

Для 4K HDR нужен подходящий HDMI-порт уровня 2.0 и выше, исправный кабель и поддержка HDR в драйвере. Kodi не на всех конфигурациях корректно тонирует HDR в SDR, поэтому на старом телевизоре проверьте конкретный файл заранее.

Пульт и удалённое управление

Официальное приложение Kore для Android и Kodi Remote для iOS управляет Kodi по локальной сети. Включите Settings → Services → Control → Allow remote control via HTTP, задайте порт 8080 и пароль. Не открывайте этот порт в интернет.

Тот же интерфейс доступен по JSON-RPC, поэтому воспроизведение можно запускать из скриптов.

curl -s -u kodi:secret http://127.0.0.1:8080/jsonrpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"Player.PlayPause","params":{"playerid":1}}'
kodi-send --action="Up"
kodi-send --action="Stop"

Утилита kodi-send входит в набор kodi-eventclients и отправляет события так же, как пульт. Для HDMI-CEC откройте Settings → System → Input → Peripherals и включите CEC Adapter — тогда телевизор сможет управлять Kodi своим пультом.

Автозапуск и режим медиацентра

Проще всего добавить Kodi в автозагрузку рабочего стола. Для минималистичного режима без панели задач используют отдельный сеанс или скрипт kodi-standalone, который запускает изолированный X-сервер.

mkdir -p ~/.config/autostart
cp /usr/share/applications/kodi.desktop ~/.config/autostart/
systemctl --user enable --now pipewire
journalctl --user -u wireplumber -n 50

Для Flatpak нужный файл лежит в ~/.local/share/flatpak/exports/share/applications и называется tv.kodi.Kodi.desktop. Проверьте, что в команде запуска указан именно он, иначе автозапуск откроет пустой сеанс.

Если Kodi запускается на сервере без монитора, убедитесь, что есть активный видеовыход и пользовательский сеанс. Запуск из systemd от root без графической сессии не сработает.

Диагностика и резервная копия

Главный источник информации — kodi.log. Запуск с флагом —debug добавляет подробности, а в интерфейсе логирование включается в Settings → System → Logging. Ошибки скрапера, звука и воспроизведения видны именно там.

tail -f ~/.kodi/temp/kodi.log
grep -i error ~/.kodi/temp/kodi.log | tail -20
tar -czf kodi-backup.tar.gz ~/.kodi

Резервную копию делайте при закрытом Kodi, иначе база может остаться в незавершённой транзакции. Для Flatpak путь другой: ~/.var/app/tv.kodi.Kodi/data. Восстановление — распаковка архива на место при выключенном приложении.

Чек-лист

• Kodi установлен из Flatpak или репозитория и запускается без ошибок.
• Звук идёт через PipeWire, passthrough настроен под ресивер.
• Источники видео добавлены, тип содержимого и скрапер выбраны.
• Аппаратное декодирование проверено на 4K-файле.
• HTTP-управление защищено паролем и не выходит в интернет.
• Профиль ~/.kodi сохранён в резервной копии.

Итог

Kodi — зрелый медиацентр, который не требует подписки и облака. Достаточно установить пакет, правильно назвать файлы, выбрать скрапер и проверить ускорение видео. Основные проблемы обычно связаны не с самим Kodi, а с драйверами, звуком и правами на сетевые каталоги. Начните с малой библиотеки, убедитесь, что метаданные и звук в порядке, и только потом добавляйте остальную коллекцию.