1. Czym jest Kodi i do czego służy?
Kodi to otwarto‑źródłowe centrum rozrywki (HTPC), licencja GPL, dostępne dla Linuksa, Windows, macOS, Android i innych systemów.
- 1. Czym jest Kodi i do czego służy?
- 2. Wymagania wstępne
- 3. Instalacja Kodi na popularnych dystrybucjach
- 4. Uruchamianie Kodi
- 5. Podstawowa konfiguracja Kodi po instalacji
- 6. Dodatki (add‑ons) – skąd je brać i jak instalować
- 7. Zaawansowana konfiguracja Kodi na Linuksie
- 8. Odinstalowanie Kodi i czyszczenie pozostałości
- 9. Najczęstsze błędy i problemy – diagnoza i rozwiązania
- 10. Dobre praktyki i wskazówki dla użytkowników
Na Linuksie Kodi świetnie sprawdza się jako:
- centrum multimediów podłączone do telewizora (HTPC),
- lekki odtwarzacz filmów i muzyki na desktopie,
- klient do strumieniowania treści z NAS, serwerów DLNA, FTP, SMB, itp.
Najważniejsze cechy:
- obsługa praktycznie wszystkich popularnych formatów wideo i audio,
- czytelny interfejs na telewizor (obsługa pilotem, klawiaturą, myszą),
- dodatki (add‑ons) – internetowe VOD, IPTV, napisy, skórki, narzędzia,
- biblioteka multimediów z okładkami, opisami, metadanymi,
- możliwość pracy w trybie pełnoekranowym jako „system do TV”.
2. Wymagania wstępne
2.1 Sprzęt
Minimalne wymagania zależą od jakości odtwarzanych treści. Dla typowego użytkownika:
- CPU: dwurdzeniowy procesor (Intel/AMD lub ARM w przypadku mini‑komputera),
- RAM: 2 GB lub więcej,
- GPU: z akceleracją sprzętową (Intel HD, nowsze AMD/NVIDIA, Raspberry Pi itp.),
- miejsce na dysku: od kilkuset MB (samo Kodi) + miejsce na multimedia.
2.2 Wybór dystrybucji Linuksa
Kodi dobrze działa m.in. na następujących dystrybucjach:
- Ubuntu i pochodne – prosta instalacja z PPA i repozytoriów;
- Debian – pakiety Kodi w stabilnych i testing, zwykle wersje konserwatywne;
- Arch Linux / Manjaro – świeże wydania z repozytoriów, ewentualnie AUR; wymagana dbałość o zgodność wersji;
- Fedora / RHEL / CentOS / Alma / Rocky – polecany Flatpak z Flathuba dla prostszej aktualizacji i zgodności;
- LibreELEC / OSMC – wyspecjalizowane systemy „tylko Kodi”; w tym poradniku skupiamy się na „zwykłych” dystrybucjach.
3. Instalacja Kodi na popularnych dystrybucjach
3.1 Ubuntu i pochodne (Linux Mint, Kubuntu itd.)
Na Ubuntu i Mint można wykorzystać oficjalne PPA Kodi Team lub skorzystać z wersji w repozytorium dystrybucji.
Wariant 1 – PPA (często nowsza wersja)
W terminalu wykonaj kolejno polecenia:
sudo apt install software-properties-common
sudo add-apt-repository ppa:team-xbmc/ppa
sudo apt update
sudo apt install kodi
Instrukcja:
software-properties-common– narzędzia do obsługi repozytoriów PPA.add-apt-repository– dodaje oficjalne repozytorium Kodi.apt update– aktualizuje listę pakietów.apt install kodi– instaluje Kodi i wymagane zależności.
Wariant 2 – bez PPA (tylko z repo dystrybucji)
Na wielu współczesnych Ubuntu/Mint wystarczy:
sudo apt update
sudo apt install kodi
Aby sprawdzić dostępną wersję Kodi, użyj:
apt policy kodi
Wersja z repozytorium dystrybucji bywa bezpieczniejsza (mniej konfliktów z bibliotekami), choć często jest starsza.
Instalacja konkretnej wersji (zaawansowane)
Jeśli dostępnych jest kilka wersji Kodi, można zainstalować konkretną:
apt policy kodi
sudo apt install kodi=NUMER_WERSJI
Przed eksperymentami sprawdź oficjalną dokumentację Kodi dla Linuksa.
3.2 Debian
Na Debianie Kodi można zainstalować bezpośrednio z repozytoriów:
sudo apt update
sudo apt install kodi
W wydaniu stable może to być nieco starsza wersja. Sprawdź apt policy kodi i porównaj z wersją na kodi.tv.
3.3 Fedora / RHEL / CentOS / Alma / Rocky
Jeżeli w repozytoriach dystrybucji nie ma satysfakcjonującej wersji Kodi lub chcesz uprościć utrzymanie, wygodnym rozwiązaniem jest Flatpak z Flathuba. Przykładowy skrypt dla CentOS 8 może przygotować HTPC: pobiera pakiety, instaluje Kodi jako Flatpak, tworzy użytkownika kodi i konfiguruje autostart. Po wykonaniu takiego skryptu Kodi może uruchamiać się automatycznie przy starcie systemu.
Aby uruchomić Kodi z Flatpaka ręcznie, użyj:
flatpak run tv.kodi.Kodi
Dla własnej konfiguracji HTPC warto przejrzeć i dostosować skrypt (np. automatyczne logowanie, dodatkowe usługi typu Plex Media Server).
3.4 Arch Linux / Manjaro
W Arch Linux pakiet znajduje się w repozytorium extra; na Manjaro najczęściej w oficjalnych repozytoriach dystrybucji.
Instalacja (Arch/Manjaro):
sudo pacman -Syu
sudo pacman -S kodi
Jeśli pojawią się problemy z niekompatybilnymi zależnościami (zwłaszcza na Manjaro), upewnij się, że używasz pakietu zgodnego z wersjami bibliotek w systemie lub wykonaj pełną aktualizację i ponowną instalację.
3.5 Raspberry Pi (Ubuntu, Debian, OSMC)
OSMC / LibreELEC – Kodi jest integralną częścią systemu, instalacja sprowadza się do nagrania obrazu na kartę microSD.
Ubuntu / Debian na Raspberry Pi – Kodi bywa dostępne w repozytoriach, ale zwróć uwagę na architekturę ARM i zgodność źródeł pakietów.
Nie dodawaj PPA team-xbmc przeznaczonego dla x86_64 na Raspberry Pi (ARM) – prowadzi to do błędów zależności i braku odpowiednich pakietów. Jeśli to zrobiłeś, usuń PPA i przywróć domyślny stan:
sudo apt-add-repository --remove ppa:team-xbmc/ppa
sudo apt update
sudo apt autoremove
sudo apt install kodi
4. Uruchamianie Kodi
Po instalacji Kodi pojawi się w menu aplikacji (GNOME, KDE, Xfce). Możesz też uruchomić je z terminala:
kodi
Przy pierwszym uruchomieniu interfejs jest zwykle po angielsku, a w katalogu użytkownika tworzony jest folder konfiguracyjny ~/.kodi/ (na OSMC: /home/osmc/.kodi).
5. Podstawowa konfiguracja Kodi po instalacji
5.1 Ustawienie języka polskiego
Po pierwszym starcie wykonaj:
- Wejdź w Settings (Ustawienia) – ikona zębatki.
- Wybierz Interface → Regional → Language i ustaw Polish (Polski).
- Kodi pobierze pakiet językowy i przełączy interfejs.
5.2 Ustawienia wyświetlania
W menu Ustawienia → System → Wyświetlacz (Display):
- ustaw rozdzielczość zgodną z monitorem/TV (np. 1920×1080, 3840×2160),
- wybierz częstotliwość odświeżania (50/60 Hz, najlepiej zgodnie z możliwościami TV),
- włącz automatyczne przełączanie częstotliwości na czas filmu dla płynniejszego ruchu.
Na Linuksie kluczowe jest wsparcie akceleracji wideo przez sterowniki GPU – w przeciwnym razie Kodi będzie przeciążać CPU.
5.3 Dodanie bibliotek multimediów
Filmy / Serial
Aby dodać źródło i zbudować bibliotekę:
- W Kodi przejdź do Filmy → Pliki → Dodaj źródło wideo.
- Wskaż lokalizację (dysk lokalny, NAS przez SMB/NFS, FTP, itp.).
- Ustaw typ zawartości: Filmy albo Programy TV.
- Wybierz scraper (np. TheMovieDB dla filmów).
- Po zapisaniu Kodi przeskanuje katalogi i utworzy bibliotekę z okładkami i opisami.
Analogicznie postępuj w menu Muzyka.
6. Dodatki (add‑ons) – skąd je brać i jak instalować
Kodi ma rozbudowany system dodatków. Z perspektywy „internetu” najważniejsze są:
- dodatki do serwisów VOD,
- wtyczki IPTV i radio internetowe,
- dodatki do napisów (subtitles).
6.1 Oficjalne repozytorium Kodi
Bezpiecznym źródłem są dodatki z oficjalnego repozytorium Kodi, dostępnego domyślnie po instalacji. Aby zainstalować dodatek:
- Przejdź do Dodatki (Add-ons) → ikonka otwartego pudełka (góra menu) → Zainstaluj z repozytorium.
- Wybierz Oficjalne repozytorium Kodi (nazwa zależna od wersji/instalacji).
- Przeglądaj kategorie: Wtyczki wideo, Napisy, Muzyka, Programy itp.
- Wybierz wtyczkę → Zainstaluj.
6.2 Dodatki z zewnętrznych repozytoriów
Kodi pozwala dodawać zewnętrzne repozytoria (ZIP/URL), ale korzystaj wyłącznie z legalnych i zaufanych źródeł; wiele nieoficjalnych wtyczek bywa niestabilnych, przestarzałych lub narusza warunki usług. Najbezpieczniej trzymać się oficjalnych repozytoriów i dodatków zgodnych z prawem.
7. Zaawansowana konfiguracja Kodi na Linuksie
7.1 Uruchamianie Kodi w trybie pełnoekranowym / HTPC
Jeśli komputer ma służyć jako centrum multimediów, skonfiguruj autostart Kodi po zalogowaniu (np. dodając kodi do programów startowych w środowisku graficznym) lub uruchamiaj Kodi od razu po starcie systemu na dedykowanym użytkowniku kodi w rozwiązaniach typu HTPC.
7.2 Reset ustawień Kodi w razie problemów
Linux desktop (Ubuntu/Mint itd.)
Kodi przechowuje pliki w katalogu użytkownika ~/.kodi/. Aby przywrócić domyślną konfigurację, zamknij Kodi i zmień nazwę katalogu konfiguracyjnego:
mv ~/.kodi ~/.kodi_backup
Po następnym uruchomieniu Kodi utworzy nowy, „czysty” zestaw ustawień. W razie potrzeby skopiuj z kopii wybrane pliki (np. biblioteki).
OSMC (Raspberry Pi)
Na OSMC ustawienia Kodi znajdują się w /home/osmc/.kodi/userdata/. Aby przywrócić domyślne ustawienia GUI, wykonaj:
cd /home/osmc/.kodi/userdata/
sudo mv guisettings.xml guisettings.xml_kopia
Po restarcie system utworzy nowy plik guisettings.xml.
8. Odinstalowanie Kodi i czyszczenie pozostałości
8.1 Ubuntu/Mint/Debian – usunięcie pakietu
W terminalu usuń Kodi poleceniami:
sudo apt update
sudo apt remove kodi*
sudo apt purge kodi*
remove usuwa pakiet i podstawowe pliki programu, a purge dodatkowo czyści pliki konfiguracyjne w /etc.
8.2 Usunięcie katalogu użytkownika
Kodi zostawia ustawienia i cache w katalogu ~/.kodi/. Aby go usunąć:
rm -r ~/.kodi/
Po tym Kodi i wszystkie jego lokalne dane zostaną wyczyszczone.
9. Najczęstsze błędy i problemy – diagnoza i rozwiązania
Ta część jest kluczowa: użytkownicy często nie radzą sobie z typowymi błędami po instalacji lub aktualizacji Kodi.
9.1 Błędy zależności przy instalacji (Ubuntu/Debian/Mint)
Objawy – podczas apt install kodi pojawiają się komunikaty o niemożliwych do spełnienia zależnościach, konfliktach bibliotek lub braku wersji dla danej architektury.
Najczęstsza przyczyna na Raspberry Pi / ARM – dodanie PPA team-xbmc dla x86_64 do systemu ARM (brak zgodnych pakietów, błędy zależności).
Rozwiązanie krok po kroku:
- Usuń nieprawidłowe PPA:
sudo apt-add-repository --remove ppa:team-xbmc/ppa - Zaktualizuj listę pakietów:
sudo apt update - Wyczyść zbędne pakiety:
sudo apt autoremove - Zainstaluj Kodi z repozytorium zgodnego z architekturą:
sudo apt install kodi
Dobrą praktyką jest instalowanie Kodi z repozytorium dystrybucji, a PPA używanie wyłącznie na klasycznym PC (x86_64) po sprawdzeniu zgodności.
9.2 Kodi nie uruchamia się / nagle przestaje działać
Objawy – brak reakcji po kliknięciu ikony, błąd przy starcie z terminala, uruchomienie i natychmiastowe zamknięcie.
Możliwe przyczyny:
- uszkodzony plik konfiguracyjny,
- zmienione uprawnienia w katalogu użytkownika,
- konflikt wersji Kodi z bibliotekami systemowymi (np. po aktualizacji w Manjaro).
Rozwiązania krok po kroku:
- Uruchom Kodi z terminala i obserwuj komunikaty
kodi - Zresetuj ustawienia użytkownika (sprawdza się przy wadliwej skórce lub dodatku)
mv ~/.kodi ~/.kodi_backup - Sprawdź właścicieli i prawa w
~/.kodi– pliki muszą należeć do aktualnego użytkownika i mieć prawa odczytu/zapisu. - Arch/Manjaro – wykonaj pełną aktualizację (
sudo pacman -Syu) i upewnij się, że pakiet Kodi jest zgodny z wersjami bibliotek.
9.3 Brak wtyczek systemowych (np. inputstream.adaptive)
Część usług VOD i strumieni adaptacyjnych wymaga wtyczek takich jak inputstream.adaptive. Brak lub niekompatybilna wersja może uniemożliwiać odtwarzanie treści.
Co zrobić:
- w menu Dodatki → Moje dodatki → Wejście strumienia sprawdź, czy
inputstream.adaptivejest dostępna i włączona, - jeśli brak – sprawdź, czy dystrybucja dostarcza osobny pakiet (np. kodi-inputstream-adaptive),
- w razie problemów rozważ nowsze Kodi (PPA, Flatpak, rolling release),
- upewnij się, że wersje wtyczek DRM/Widevine są zgodne z wersją Kodi i polityką dystrybucji.
9.4 Dodatki przestały działać po aktualizacji Kodi
Przykład: po aktualizacji do Kodi 21 (Omega) na Linux Mint 22 część dodatków przestała działać lub sypie błędami.
Przyczyny – zmiany w API między wersjami Kodi, dodatki nie zostały jeszcze dostosowane, zmiany w obsłudze DRM/inputstream.
Jak działać:
- Sprawdź dostępność nowszej wersji problematycznego dodatku i zaktualizuj go z repozytorium.
- Gdy kluczowy dodatek nie wspiera nowego Kodi, rozważ tymczasowy powrót do poprzedniej serii (jeśli dystrybucja to umożliwia).
- Monitoruj oficjalne forum/dokumentację Kodi oraz repozytoria dodatków – poprawki często pojawiają się szybko.
9.5 Problemy z dźwiękiem i obrazem (przycięcia, brak dźwięku)
Typowe scenariusze:
- brak dźwięku na HDMI,
- przycięcia obrazu przy wysokiej rozdzielczości,
- brak użycia akceleracji sprzętowej.
Ogólne zalecenia:
- sprawdź ustawienia w Ustawienia → System → Dźwięk i wybierz właściwe wyjście (HDMI/analog),
- zaktualizuj sterowniki graficzne i system – akceleracja bywa uzależniona od wersji Mesa/sterownika GPU,
- przetestuj włączenie/wyłączenie sprzętowej akceleracji wideo w ustawieniach Kodi.
10. Dobre praktyki i wskazówki dla użytkowników
Poniżej zestaw praktycznych porad dla użytkowników Kodi na Linuksie:
- korzystaj głównie z oficjalnych repozytoriów (Kodi i dystrybucji) – minimalizujesz problemy z zależnościami i bezpieczeństwem,
- sprawdzaj architekturę systemu (x86_64 vs ARM / Raspberry Pi) przed dodaniem zewnętrznych PPA,
- rób kopie zapasowe katalogu
~/.kodi/przed testami nowych skórek, dużymi zmianami konfiguracji lub aktualizacją do świeżej wersji, - unikaj „magicznych skryptów” i nieznanych repozytoriów dodatków – grożą niestabilnością i ryzykiem bezpieczeństwa,
- gdy Kodi przestanie działać, najpierw uruchom je z terminala i przeanalizuj błędy – zwykle wskazują konkretną zależność lub wadliwy dodatek,
- w systemach dedykowanych (CentOS HTPC, OSMC, LibreELEC) korzystaj z dokumentacji twórców obrazów i skryptów opisującej typowe scenariusze i znane błędy.
