Przewodnik po nazewnictwie Kodi: Filmy, seriale, anime, muzyka i pliki NFO (2026)

Podstawy nazewnictwa w Kodi

Trzy koncepcje dotyczące skanowania w Kodi na tyle różnią się od Plexa i Jellyfin, że zasługują na osobne wyjaśnienie. Pomiń tę sekcję, a ciągle będziesz napotykać te same trzy problemy: zły scraper dla Twojej biblioteki, źle skonfigurowany typ zawartości i nieoczekiwane pliki NFO nadpisujące Twoje dane.

Scrapery, nie agenty

Tam, gdzie Plex ma „agenty”, a Jellyfin „dostawców metadanych”, Kodi ma „scrapery” — utrzymywane przez społeczność dodatki, które wysyłają zapytania do określonych baz danych. Domyślne to scraper The Movie Database dla filmów, scraper The Movie Database lub scraper The TVDB dla seriali oraz Universal Album Scraper dla muzyki. Anime jest dużym wyjątkiem: Kodi nie ma wbudowanego scrapera do anime, więc użytkownicy instalują dodatki społeczności, takie jak Hama (ten sam, który jest używany w Plex) do integracji z AniDB. Wybór scrapera odbywa się dla każdego źródła, a nie dla całej biblioteki. Otwórz źródło wideo Kodi w przeglądarce plików, edytuj je i wybierz „Ustaw zawartość”, aby przypisać scraper. To samo źródło może być skanowane przez różne dodatki na różnych urządzeniach Kodi w tej samej sieci — co jest jednym z powodów, dla których tak często słyszy się „moje Kodi działa, ale u kolegi już nie”.

Źródła biblioteki i typy zawartości

Biblioteka Kodi jest budowana ze „źródeł”, które dodajesz ręcznie — folderów, udziałów sieciowych lub zdalnych ścieżek. Gdy dodajesz źródło, informujesz Kodi, jaki rodzaj zawartości ono zawiera (Filmy, Seriale, Teledyski, Muzyka, Brak) i którego scrapera użyć dla tej zawartości. Mieszanie typów zawartości w jednym źródle jest częstą przyczyną niedopasowanych plików: folder zawierający zarówno filmy, jak i seriale może być skanowany tylko jako jedno albo drugie. Rozwiązaniem jest podzielenie mieszanej zawartości na osobne foldery najwyższego poziomu, z których każdy będzie osobnym źródłem z własnym typem zawartości. Jest to bardziej sztywne niż wykrywanie bibliotek w Plexie dla każdego folderu, ale bardziej przewidywalne, gdy już zdecydujesz się na daną strukturę.

Cztery zasady, które zapobiegają 90% błędów

Cztery zasady, które zapobiegają zdecydowanej większości błędów skanowania w Kodi: Zasada 1 — Jeden typ zawartości na źródło. Nie mieszaj filmów i seriali w jednym folderze, który Kodi skanuje jako „Filmy”. Zasada 2 — Ustaw typ zawartości i scraper PRZED pierwszym skanowaniem. Zmiana ich później wymaga „Odświeżenia”, a czasem całkowitego wyczyszczenia bazy danych, aby usunąć stare, błędne dopasowania. Zasada 3 — Używaj formatu sXXeYY dla odcinków seriali, z małymi literami i zerami wiodącymi. Kodi akceptuje więcej wariantów niż Plex, ale przewidywalne wzorce pozwalają uniknąć problematycznych przypadków scrapera. Zasada 4 — Gdy scraper wielokrotnie zawodzi przy konkretnym pliku, umieść obok niego plik NFO. Pliki NFO całkowicie zastępują scrapery — to wyjście awaryjne w Kodi.

Need it from zero? przewodnik krok po kroku.

Nazywanie filmów dla Kodi

Kodi akceptuje dwa prawidłowe układy dla filmów — folder na film i płaski. Schemat z folderami jest zalecany z tych samych powodów co w Plex i Jellyfin (dodatki, plakaty, pliki NFO), a także ze względu na jedną funkcję specyficzną dla Kodi: filmy wieloczęściowe (stacked), które Kodi obsługuje natywnie, w przeciwieństwie do Plex i Jellyfin.

Zalecany układ folderów

Zalecany układ folderów:

Movies/
├── Blade Runner (1982)/
│   ├── Blade Runner (1982).mkv
│   ├── Blade Runner (1982).en.srt
│   ├── movie.nfo
│   ├── poster.jpg
│   └── fanart.jpg
├── Dune (2021)/
│   └── Dune (2021).mkv
└── The Matrix (1999)/
    └── The Matrix (1999).mkv

Nazwa pliku jest taka sama jak nazwa folderu. Pliki z grafikami używają lokalnych nazw Kodi: poster.jpg, fanart.jpg, clearart.png, landscape.jpg. Napisy są zgodne z konwencją Tytuł (Rok).en.srt, .fr.srt itd. — Kodi odczytuje kod języka z przyrostka oddzielonego kropką.

Przyrostek (Rok) nie jest opcjonalny

Rok w nawiasach jest nie do pominięcia z tych samych powodów co w Plex i Jellyfin: TheMovieDB zwraca dopasowania o tym samym tytule posortowane według popularności, a Kodi po cichu wybierze niewłaściwy. Format: Title (YYYY). Nawiasy kwadratowe [YYYY], kropki Title.YYYY i sam rok działają w niektórych scraperach, ale w innych nie — nawiasy okrągłe są uniwersalne. Dla filmów całkowicie nieobecnych w TMDB (rzadkie filmy artystyczne, wydania regionalne), plik NFO z ręcznie wprowadzonym ID z TMDB jest jedynym niezawodnym rozwiązaniem. Zobacz sekcję o NFO poniżej.

Filmy wieloczęściowe (stacked) (tylko w Kodi)

Kodi ma natywne wsparcie dla filmów wieloczęściowych przechowywanych jako osobne pliki — funkcja z ery ripowania DVD, która wciąż jest przydatna w przypadku bardzo długich filmów (LotR Extended, Once Upon a Time in America) podzielonych na kilka płyt. Użyj wzorców przyrostków cd1 / cd2 / partN / dvdN:

Movies/
└── Lord of the Rings - The Fellowship of the Ring (2001)/
    ├── Lord of the Rings - The Fellowship of the Ring (2001) - cd1.mkv
    └── Lord of the Rings - The Fellowship of the Ring (2001) - cd2.mkv

Kodi odtwarza je po kolei jako jeden film i scrapuje jako pojedynczy wpis w bibliotece. Wzorzec dopasowania nie uwzględnia wielkości liter i akceptuje oznaczenia takie jak cd, part, dvd, pt i kilka innych — ale cd1/cd2 jest najbezpieczniejszą i najlepiej udokumentowaną opcją.

Wiele wersji tego samego filmu

Kodi nie ma funkcji scalania wielu wersji, którą oferują Plex i Jellyfin — nie możesz przechowywać wersji 1080p i 4K pod jednym wpisem w bibliotece, tak aby Kodi wybrało odpowiednią dla klienta. Każdy plik staje się osobnym wpisem w bibliotece. Są dwa obejścia: Opcja 1 — Trzymaj jedną wersję filmu w bibliotece Kodi, a pozostałe wersje przechowuj poza scrapowanym źródłem. Przełączaj źródło biblioteki ręcznie, gdy chcesz użyć innej jakości. Opcja 2 — Podziel na dwie biblioteki (Movies-1080p, Movies-4K) z dwoma źródłami. Użyj profili Kodi lub skrótów skórki, aby się między nimi przełączać. Więcej pracy, ale pozwala to na współistnienie wszystkich wersji w tej samej instalacji Kodi. Jeśli obsługa wielu wersji jest kluczowa dla twojego sposobu pracy, jest to jedyny obszar, w którym Plex i Jellyfin są obiektywnie lepsze.

Zestawy i kolekcje filmów

Kodi obsługuje zestawy filmów (czasem nazywane „kolekcjami”) — Gwiezdne Wojny, Marvel Cinematic Universe, Władca Pierścieni — grupując filmy w jeden węzeł kolekcji, który można przeglądać. Zestawy są wypełniane automatycznie na podstawie danych o kolekcjach z TMDB dla filmów, które do nich należą. Zmiana nazwy nie jest wymagana; Kodi odczytuje ID kolekcji ze scrapowanych metadanych TMDB. Dla własnych zestawów (twoich własnych grup, których nie ma na TMDB), użyj pliku NFO na poziomie filmu ze znacznikiem <set> wskazującym na własną nazwę zestawu.

Cztery błędy, które powodują większość problemów ze scrapowaniem

1. Typ zawartości źródła ustawiony na „Brak” lub zły typ. Bez określonego typu zawartości Kodi w ogóle nie skanuje go jako filmów. 2. Brak roku lub rok w nawiasach kwadratowych. „Inception 2010.mkv” dopasowuje się przez przypadek; „Inception [2010].mkv” powoduje błąd scrapera TMDB. 3. Plik filmowy w głównym folderze źródła, bez własnego folderu. Działa to przy dopasowywaniu, ale psuje okładki, pliki NFO i funkcję dzielonych części. 4. Nieaktualne wpisy z poprzedniego, błędnego scrapowania. Nawet po poprawieniu nazw Kodi pokazuje stare, błędne dopasowanie. Rozwiązanie: menu kontekstowe biblioteki → „Wyczyść bibliotekę” → a następnie ponowne skanowanie.

Pełne przykłady

Movies/
├── The Matrix (1999)/
│   ├── The Matrix (1999).mkv
│   ├── movie.nfo
│   └── fanart.jpg
├── Lord of the Rings - The Fellowship of the Ring (2001)/
│   ├── Lord of the Rings - The Fellowship of the Ring (2001) - cd1.mkv
│   └── Lord of the Rings - The Fellowship of the Ring (2001) - cd2.mkv
├── Dune (2021)/
│   └── Dune (2021).mkv
└── 1917 (2019)/
    └── 1917 (2019).mkv

Compare to Odpowiedniki dla Plex.

Nazywanie seriali dla Kodi

Seriale to obszar, w którym elastyczność Kodi pomaga najbardziej — akceptowanych jest wiele prawidłowych wzorców nazw plików, a scraper jest wyrozumiały dla drobnych odchyleń. Kompromis jest taki: gdy coś się nie dopasuje, przyczyna rzadko jest oczywista. Ta sekcja omawia bezpieczne wzorce i przypadki, w których Kodi różni się od Plex/Jellyfin.

Struktura folderów

Standardowy, dwupoziomowy układ: folder serialu, a w nim podfoldery sezonów.

TV Shows/
├── Breaking Bad (2008)/
│   ├── tvshow.nfo
│   ├── poster.jpg
│   ├── Season 01/
│   │   ├── Breaking Bad - s01e01 - Pilot.mkv
│   │   └── Breaking Bad - s01e02 - Cat's in the Bag.mkv
│   └── Season 02/
│       └── Breaking Bad - s02e01.mkv
└── The Office (2005)/
    └── Season 03/
        └── The Office - s03e12.mkv

Nazwa folderu serialu: "Title (Year)". Rok pozwala odróżnić remaki — The Office UK 2001 vs US 2005, House of Cards UK 1990 vs US 2013. Folder sezonu: "Season XX" z dwucyfrowym numerem uzupełnionym zerem, lub "Season 0" (albo "Season 00") dla odcinków specjalnych. Kodi akceptuje zarówno "Season 0", jak i "Season 00"; wybierz jedną opcję i trzymaj się jej. W przeciwieństwie do konwencji Plexa z folderem "Specials", Kodi NIE rozpoznaje dosłownej nazwy folderu "Specials". Użyj nazwy Season 0 lub Season 00.

Format nazwy pliku odcinka

Zalecany przez Kodi schemat nazwy pliku odcinka: Show Name - sXXeYY - Episode Title.ext Małe litery, dwucyfrowe numery uzupełnione zerem, opcjonalny tytuł odcinka dla czytelności. Kodi akceptuje wielkie litery (SXXEYY), Show.S01E01, Show 1x01, Show 101 i kilka innych wariantów — ale forma z małymi literami i myślnikami jest najbardziej niezawodna dla różnych scraperów. Tytuł odcinka w nazwie pliku służy tylko czytelności dla człowieka — scraper Kodi zastępuje go kanonicznym tytułem z TheTVDB lub TheMovieDB. Jeśli tytuł podany przez scraper jest błędny, edytuj go w interfejsie Kodi (prawy przycisk myszy na odcinku → "Informacje" → "Edytuj") lub za pomocą pliku NFO (co omówimy później).

Odcinki specjalne w Season 0

Odcinki specjalne, OVA, odcinki pilotażowe, materiały zza kulis i dodatki umieszczaj w folderze "Season 0" (lub "Season 00" — Kodi traktuje oba tak samo). Wewnątrz użyj numeracji sekwencyjnej: Show - s00e01.mkv, Show - s00e02.mkv. Kolejność numeracji powinna odpowiadać liście odcinków specjalnych dla danego serialu w TheTVDB. Społeczność TheTVDB porządkuje je w określonej kolejności (często opartej na dacie emisji); Kodi oczekuje, że będziesz jej przestrzegać. Jeśli twoje odcinki specjalne wydają się być pomieszane w interfejsie Kodi, sprawdź zakładkę z odcinkami specjalnymi dla serialu w TheTVDB i odpowiednio zmień kolejność numerów s00eYY.

Pliki z wieloma odcinkami

Dla podwójnych odcinków w jednym pliku:

Breaking Bad - s05e15-e16 - Granite State + Felina.mkv

Kodi tworzy pojedynczy element do odtworzenia, który w metadanych jest przypisany do obu odcinków. Forma z zakresem (e15-e16) jest czytelniejsza; alternatywna forma (s05e15-s05e16) również działa. Obie formy można rozszerzyć na potrójne lub poczwórne odcinki (e15-e16-e17), chociaż w praktyce jest to rzadkie.

Programy codzienne (oparte na dacie)

Programy codzienne (talk-show, wiadomości) bez tradycyjnych numerów sezonu/odcinka używają formatu daty RRRR-MM-DD:

The Daily Show (1996)/
└── Season 29/
    └── The Daily Show - 2024-03-15.mkv

Scraper TheTVDB w Kodi dopasowuje datę do indeksu dat programów codziennych. Upewnij się, że źródło używa scrapera TheTVDB, a nie TheMovieDB — TheMovieDB ma ograniczone wsparcie dla programów codziennych.

Pełne przykłady

TV Shows/
├── Breaking Bad (2008)/
│   ├── tvshow.nfo
│   ├── Season 01/
│   │   ├── Breaking Bad - s01e01 - Pilot.mkv
│   │   └── Breaking Bad - s01e02 - Cat's in the Bag.mkv
│   ├── Season 05/
│   │   └── Breaking Bad - s05e15-e16 - Granite State + Felina.mkv
│   └── Season 00/
│       └── Breaking Bad - s00e01 - No Half Measures.mkv
├── Chernobyl (2019)/
│   └── Season 01/
│       └── Chernobyl - s01e01 - 1:23:45.mkv
└── The Daily Show (1996)/
    └── Season 29/
        └── The Daily Show - 2024-03-15.mkv

Compare to Odpowiedniki dla Jellyfin.

Nazywanie anime dla Kodi (ze scraperem Hama)

Kodi nie ma wbudowanego scrapera do anime — domyślne dodatki TheMovieDB i TheTVDB traktują anime jak zwykłe seriale, co sprawdza się w przypadku nowoczesnych sezonowych shonenów, ale zawodzi przy seriach z numeracją bezwzględną (One Piece, Detective Conan, Bleach). Rozwiązaniem jest Hama, ten sam scraper społecznościowy, którego używa się w Plexie do bibliotek anime. Jednorazowa instalacja odblokowuje integrację z AniDB dla wszystkich twoich źródeł anime w Kodi.

Konfiguracja Hama (10 minut, jednorazowo)

Konfiguracja Hama w Kodi zajmuje około 10 minut: 1. Pobierz Hama z github.com/ZeroQI/Hama.bundle (paczkę dla Plexa można używać w Kodi dzięki dodatkowi-wrapperowi Hama dla Kodi). Alternatywa: zainstaluj „Hama” z oficjalnego repozytorium dodatków Kodi, jeśli jest dostępny w twojej wersji Kodi. 2. W Kodi: Ustawienia → Dodatki → Zainstaluj z repozytorium → Dostawcy informacji → Seriale TV → zainstaluj Hama (i Hama.bundle, jeśli jest na liście osobno). 3. Utwórz dedykowane źródło dla anime. Dodaj źródło wideo wskazujące na twój folder z anime, ustaw typ zawartości na „Seriale TV” i wybierz „Hama” jako scraper zamiast TheMovieDB lub TheTVDB. 4. Hama domyślnie używa AniDB jako głównej bazy danych. Możesz zmienić kolejność priorytetów w ustawieniach scrapera — AniDB na pierwszym miejscu jest zalecane dla seriali z numeracją bezwzględną; TVDB na pierwszym miejscu dla seriali, dla których chcesz metadane z angielskim dubbingiem. 5. Uruchom skanowanie (scrape) na źródle. Pierwsze skanowanie jest powolne (Hama odpytuje wiele baz danych) — bądź cierpliwy. Kolejne skanowania są znacznie szybsze.

Bezwzględna numeracja odcinków

Dla serii z numeracją bezwzględną, jak One Piece (odcinek 1064), użyj sezonu 01 z numerami odcinków uzupełnionymi do 4 cyfr:

Anime/
└── One Piece [anidbid-69]/
    └── Season 01/
        ├── One Piece - s01e0001.mkv
        ├── One Piece - s01e0002.mkv
        └── One Piece - s01e1064.mkv

Sufiks [anidbid-X] w nazwie folderu zmusza Hama do bezpośredniego użycia wpisu z AniDB, pomijając niedokładne dopasowywanie tytułu. Znajdź ID na anidb.net, wyszukując serial — ID znajduje się w adresie URL. Uzupełnienie do 4 cyfr nie jest wymagane do dopasowania, ale utrzymuje porządek sortowania w systemie plików zgodny z kolejnością odtwarzania. Bez uzupełnienia plik e1064 sortuje się po e11 zamiast po e1063, co utrudnia przeglądanie folderu poza Kodi.

Podzielone sezony i arci

Nowoczesne anime podzielone na „części” (Attack on Titan Final Season Parts 1/2/3, arci z Demon Slayer) powodują takie same problemy ze scraperem jak w Plex i Jellyfin. Rozwiązanie: zdecyduj, która baza danych pasuje do twojego wyobrażenia o strukturze serialu, wymuś jej użycie za pomocą sufiksu ID w folderze i trzymaj się tego schematu dla wszystkich swoich anime.

Anime/
├── Attack on Titan [anidbid-9541]/
│   ├── Season 01/
│   ├── Season 02/
│   ├── Season 03/
│   └── Season 04/   ← Final Season Part 1
├── Attack on Titan - Final Season Part 2 [anidbid-15689]/
│   └── Season 01/   ← AniDB traktuje Part 2 jako osobny wpis
└── Demon Slayer (2019)/
    ├── Season 01/
    ├── Season 02/   ← Mugen Train + Entertainment District
    └── Season 03/

Pełne przykłady

Anime/
├── One Piece [anidbid-69]/
│   ├── Season 01/
│   │   ├── One Piece - s01e0001.mkv
│   │   └── One Piece - s01e1064.mkv
│   └── Season 00/
│       └── One Piece - s00e001 - Movie 14 Stampede.mkv
├── Attack on Titan [anidbid-9541]/
│   ├── Season 01/
│   └── Season 04/
└── Demon Slayer (2019)/
    └── Season 02/
        └── Demon Slayer - s02e01.mkv

Same scraper in Plex? Anime w Plex (HAMA to ten sam scraper).

Nazywanie muzyki dla Kodi

W Kodi muzyka jest oparta przede wszystkim na tagach, a w drugiej kolejności na folderach — dokładnie tak jak w Plex i Jellyfin. Scraper Universal Album Scraper (domyślny w Kodi 19+) odczytuje tagi ID3 i wysyła zapytania do MusicBrainz i TheAudioDB w celu pobrania okładek i metadanych. Najpierw popraw tagi, a dopiero potem martw się strukturą folderów.

Zalecany układ folderów

Zalecany układ:

Music/
├── Pink Floyd/
│   ├── The Dark Side of the Moon (1973)/
│   │   ├── 01 - Speak to Me.flac
│   │   └── 02 - Breathe.flac
│   └── Wish You Were Here (1975)/
│       └── 01 - Shine On You Crazy Diamond Pts. 1-5.flac
├── Various Artists/
│   └── Pulp Fiction Soundtrack (1994)/
│       ├── 01 - Misirlou - Dick Dale.flac
│       └── 02 - Royale with Cheese - John Travolta.flac
└── Tool/
    └── Lateralus (2001)/
        ├── Disc 01/
        │   └── 01 - The Grudge.flac
        └── Disc 02/
            └── 01 - Faaip de Oiad.flac

Zalecane jest umieszczenie roku wydania albumu w nazwie folderu. Albumy wielopłytowe używają podfolderów „Disc XX”. Kompilacje używają tagu wykonawcy albumu „Various Artists” (tag Album Artist = „Various Artists”, a indywidualny tag Artist pozostaje wykonawcą utworu).

Tagi ID3, których Kodi faktycznie używa

Wymagane tagi ID3 do poprawnego dopasowania w Kodi: Artist, Album, Title, Track Number. Zdecydowanie zalecane: Album Artist (inny niż Artist na kompilacjach), Year, Genre, Disc Number, ID z MusicBrainz. ID z MusicBrainz (Album ID i Recording ID, osadzone jako ramki TXXX w ID3v2.3 lub komentarze Vorbis) pozwalają scraperowi Universal Album Scraper w Kodi na dokładne dopasowanie, omijając niedokładne dopasowywanie po tytule. Użyj MusicBrainz Picard, aby zapisać te ID, a biblioteka Kodi stanie się niemal niezawodna. Tryb muzyczny w RenameFlow odczytuje dane z MusicBrainz i tworzy poprawne nazwy plików oraz strukturę folderów; nie zapisuje tagów ID3. Używaj go po zastosowaniu taggera takiego jak Picard, a nie jako jego zamiennik.

Pełne przykłady

Music/
└── Pink Floyd/
    ├── The Dark Side of the Moon (1973)/
    │   ├── 01 - Speak to Me.flac
    │   └── 10 - Eclipse.flac
    └── The Wall (1979)/
        ├── Disc 01/
        │   └── 01 - In the Flesh?.flac
        └── Disc 02/
            └── 01 - Hey You.flac

Pliki NFO — system zastępowania metadanych w Kodi

Pliki NFO to największa różnica w nazewnictwie między Kodi a Plex/Jellyfin. Plik NFO to mały plik XML, który umieszczasz obok pliku wideo, a Kodi odczytuje go ZAMIAST wysyłać zapytania do scraperów online. Są opcjonalne, ale niezwykle przydatne: pozwalają zastąpić błędne dopasowania scrapera, dokumentować własne kolekcje i „przypinać” metadane, które mogłyby się zmienić wraz ze zmianami w bazach danych online. Plex nie ma niczego podobnego; Jellyfin oferuje częściowe wsparcie poprzez lokalne obrazy i minimalny XML. System NFO w Kodi to najbardziej dojrzała implementacja w jakimkolwiek otwartym centrum multimedialnym.

Kiedy tworzyć pliki NFO (a kiedy nie)

Nie potrzebujesz plików NFO do wszystkiego — scrapery poprawnie obsługują 90% dopasowań. Cztery scenariusze, w których pliki NFO są warte zachodu: 1. Scraper wybiera zły film/serial, a opcja „Edytuj” w interfejsie Kodi nie zapisuje zmian (częste w przypadku seriali z wieloma remake'ami). 2. Film lub serial nie istnieje w TMDB/TVDB (wydania regionalne, fanowskie edycje, niszowe treści). 3. Chcesz stworzyć własne grupy kolekcji, wykraczające poza to, co oferuje TMDB (na przykład własny zestaw „Najlepsze Sci-Fi lat 90.”). 4. Przechowujesz metadane, których nie możesz stracić — bibliotekę Kodi można odbudować wyłącznie na podstawie plików NFO, jeśli baza danych ulegnie uszkodzeniu. Dla bibliotek poniżej 200 pozycji pliki NFO to zazwyczaj przerost formy nad treścią. Dla bibliotek powyżej 1000 pozycji, w których poświęciłeś czas na poprawianie metadanych, są one ubezpieczeniem.

movie.nfo — najbardziej przydatny plik NFO

Format NFO dla filmów. Umieść plik obok filmu pod nazwą movie.nfo (lub Title (Year).nfo pasującą do nazwy pliku wideo — obie opcje działają, ale movie.nfo jest standardem):

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<movie>
  <title>Blade Runner</title>
  <originaltitle>Blade Runner</originaltitle>
  <year>1982</year>
  <plot>A blade runner must pursue and terminate four replicants...</plot>
  <runtime>117</runtime>
  <mpaa>R</mpaa>
  <genre>Science Fiction</genre>
  <genre>Thriller</genre>
  <director>Ridley Scott</director>
  <actor>
    <name>Harrison Ford</name>
    <role>Rick Deckard</role>
  </actor>
  <uniqueid type="tmdb" default="true">78</uniqueid>
  <uniqueid type="imdb">tt0083658</uniqueid>
  <set>
    <name>Blade Runner Collection</name>
  </set>
</movie>

Pole <uniqueid type="tmdb"> zmusza Kodi do użycia konkretnego wpisu z TMDB zamiast niedokładnego dopasowywania tytułu. To najbardziej użyteczny tag — jeśli masz wpisać tylko jedną rzecz w swoich plikach NFO, wpisz właśnie to.

tvshow.nfo — nadpisania na poziomie serialu

Pliki NFO dla seriali umieszcza się w głównym folderze serialu pod nazwą tvshow.nfo. Format jest podobny do movie.nfo, ale z polami na poziomie serialu:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tvshow>
  <title>Breaking Bad</title>
  <year>2008</year>
  <plot>A high school chemistry teacher diagnosed with cancer...</plot>
  <genre>Crime</genre>
  <genre>Drama</genre>
  <uniqueid type="tvdb" default="true">81189</uniqueid>
  <uniqueid type="tmdb">1396</uniqueid>
  <uniqueid type="imdb">tt0903747</uniqueid>
  <status>Ended</status>
  <studio>AMC</studio>
</tvshow>

<uniqueid type="tvdb"> to najbardziej niezawodna blokada dla seriali, ponieważ TheTVDB jest domyślnym scraperem TV w Kodi dla większości użytkowników.

NFO dla pojedynczych odcinków (rzadko potrzebne)

Pliki NFO dla pojedynczych odcinków są rzadko potrzebne — NFO na poziomie serialu i metadane odcinków pobrane przez scraper wystarczają w większości przypadków. Używaj ich tylko wtedy, gdy konkretny odcinek jest źle dopasowany, a odświeżenie serialu nie pomaga. Format: umieść plik Show - s01e01.nfo obok pliku wideo:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<episodedetails>
  <title>Pilot</title>
  <season>1</season>
  <episode>1</episode>
  <aired>2008-01-20</aired>
  <plot>Walter White, a struggling high school chemistry teacher...</plot>
  <uniqueid type="tvdb" default="true">349232</uniqueid>
</episodedetails>

Zaawansowane tagi metadanych

Oprócz podstawowych tagów <title>, <year> i <plot>, Kodi rozumie bogaty zestaw pól metadanych, które pozwalają dostosować wygląd elementów w bibliotece. Najbardziej przydatne dla zaawansowanych użytkowników: <originaltitle> — tytuł w oryginalnym języku, wyświetlany na stronach informacyjnych obok tytułu lokalnego. Kluczowy dla zagranicznych filmów, gdzie tytuł od lokalnego dystrybutora znacznie różni się od oryginału (pomyśl o Spirited Away vs Sen to Chihiro no Kamikakushi). <sorttitle> — nadpisuje domyślne sortowanie. Użyj go, aby wymusić sortowanie „The Matrix” pod „M” zamiast „T” lub aby grupować sequele razem, niezależnie od ich kanonicznych tytułów. Przykład: sortowanie wszystkich filmów Mission: Impossible jako „Mission Impossible 01”, „Mission Impossible 02” itd. <tagline> — krótki slogan marketingowy wyświetlany pod tytułem (pomyśl o „W kosmosie nikt nie usłyszy twojego krzyku”). Dodaje profesjonalnego wyglądu stronom informacyjnym w twojej bibliotece. <status> dla seriali — „Continuing”, „Ended” lub „Returning Series”. Pozwala skórce Kodi wyświetlać odpowiednie wskaźniki na kartach seriali. <premiered> — oficjalna data pierwszej emisji. Przydatne dla seriali antologicznych lub anime, gdzie data ze scrapera jest błędna. bloki <fileinfo> — wstępnie zbuforowane metadane pliku (kodek, rozdzielczość, ścieżki językowe audio). Przydatne, jeśli tworzysz pliki NFO programowo i chcesz pominąć analizę mediów podczas pierwszego skanowania przez Kodi.

Wiele źródeł ocen obok siebie

Kodi 19+ obsługuje jednoczesne wyświetlanie wielu źródeł ocen. Dodaj blok <ratings> z dowolną liczbą źródeł:

<ratings>
  <rating name="imdb" max="10" default="true">
    <value>8.1</value>
    <votes>826543</votes>
  </rating>
  <rating name="themoviedb" max="10">
    <value>8.2</value>
    <votes>9876</votes>
  </rating>
  <rating name="rottentomatoes" max="100">
    <value>89</value>
    <votes>410</votes>
  </rating>
</ratings>

Domyślne skórki Kodi wyświetlają ocenę „default” w widocznym miejscu i pozwalają przełączać się między pozostałymi w oknie informacyjnym. Dla bibliotek, w których starannie dobrałeś zaufane źródła, jest to znaczące ułatwienie w porównaniu z pojedynczą oceną pochodzącą ze scrapera.

Pliki NFO dla muzyki (artysta, album, utwór)

Muzyka ma własny format NFO z trzema poziomami — artysta, album i utwór. Plik NFO na poziomie artysty umieszcza się w głównym folderze artysty pod nazwą artist.nfo:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<artist>
  <name>Pink Floyd</name>
  <disambiguation>British rock band</disambiguation>
  <formed>1965</formed>
  <disbanded>2014</disbanded>
  <genre>Progressive Rock</genre>
  <musicBrainzArtistID>83d91898-7763-47d7-b03b-b92132375c47</musicBrainzArtistID>
</artist>

Identyfikator MusicBrainz Artist ID pozwala bibliotece muzycznej Kodi połączyć się z kanonicznym wpisem bez niedokładnego dopasowywania — jest to niezwykle przydatne w przypadku artystów o popularnych nazwiskach lub wielu wykonawców o tej samej nazwie. Plik NFO na poziomie albumu (album.nfo w folderze albumu) akceptuje podobne pola oraz <title>, <year>, <musicBrainzAlbumID>. Pliki NFO na poziomie utworu są rzadko używane; model muzyczny Kodi oparty na tagach obsługuje utwory za pomocą tagów ID3, a nie plików NFO.

Częste pułapki w plikach NFO

Cztery błędy, które w praktyce psują pliki NFO: 1. Nieprawidłowy XML — znaki &, < lub > bez escapowania wewnątrz tagów <plot> lub <title>. Rozwiązanie: otocz treść tagiem <![CDATA[...]]> lub escapuj znaki ręcznie (&amp;, &lt;, &gt;). 2. Złe kodowanie — pliki NFO MUSZĄ być w formacie UTF-8. Niektóre edytory tekstu w Windows domyślnie zapisują pliki w kodowaniu Windows-1252, co psuje znaki spoza ASCII (akcenty, cyrylica, znaki japońskie). Użyj edytora obsługującego UTF-8 (np. VS Code, Sublime Text, Notepad++). 3. Brak deklaracji XML — pierwsza linia <?xml version="1.0" encoding="UTF-8" standalone="yes"?> jest wymagana. Bez niej niektóre wersje Kodi po cichu pomijają plik. 4. Konflikt NFO ze zescrapowanymi metadanymi — jeśli zarówno plik NFO, jak i scraper dostarczają dane dla tego samego pola, Kodi domyślnie użyje danych z NFO. Zazwyczaj tego właśnie chcesz, ale czasem zaskakuje to użytkowników, którzy nie wiedzą, że ich plik NFO nadpisuje aktualizacje online. Aby wrócić do danych ze scrapera, usuń plik NFO i odśwież.

Jak pliki NFO są umieszczane obok Twoich mediów

Movies/
└── Blade Runner (1982)/
    ├── Blade Runner (1982).mkv
    ├── movie.nfo               ← zablokowane ID TMDB
    └── poster.jpg

TV Shows/
└── Breaking Bad (2008)/
    ├── tvshow.nfo              ← zablokowane ID TVDB
    ├── Season 01/
    │   ├── Breaking Bad - s01e01 - Pilot.mkv
    │   └── Breaking Bad - s01e01.nfo   ← nadpisanie dla odcinka (rzadkie)
    └── Season 02/

Don't want to hand-write NFOs? lub użyj kreatora NFO w Filebot.

Rozwiązywanie problemów z nazewnictwem w Kodi

Sześć typów błędów odpowiada za około 85% skarg dotyczących nazewnictwa w Kodi. Każdy z nich ma przewidywalną przyczynę i proste rozwiązanie.

Alternatywa w 60 sekund

Wszystko powyżej to metoda ręczna: zrozumienie scraperów, wpisywanie poprawnych nazw plików, tworzenie plików NFO dla opornych przypadków. Warto to zrobić raz dla nowej biblioteki. To męka w przypadku biblioteki z 2000 plików, odziedziczonej po latach nieustrukturyzowanych pobrań.

Metoda ręczna

Ręczna zmiana nazwy w bibliotece Kodi zajmuje od 30 do 60 sekund na element — sprawdzanie tytułu, formatowanie roku, poprawianie wzorca sXXeYY i tworzenie plików NFO dla kilku problematycznych przypadków. Biblioteka z 2000 plików to praca na cały weekend.

Metoda 60-sekundowa

RenameFlow zmienia nazwy w kilka sekund. Przeciągnij folder, a parser wykryje, czy to filmy, seriale czy anime, równolegle odpyta TMDB / TheTVDB / AniDB / MusicBrainz i pokaże podgląd zmiany nazw zgodny z Kodi. Zatwierdź, a zmiana nazw odbędzie się lokalnie na Twoim dysku przez File System Access API — bez wysyłania plików. Darmowe dla pierwszych 15 plików dziennie; jednorazowa opłata 49 EUR za nielimitowane użycie. Jeśli chodzi o generowanie plików NFO, RenameFlow nie tworzy ich bezpośrednio — ale generuje nazwy plików, które są czysto odczytywane przez domyślne scrapery Kodi, co eliminuje potrzebę posiadania plików NFO w 90% przypadków. Dla pozostałych 10% ręczne utworzenie pliku NFO to jednorazowy wysiłek.

See Cennik RenameFlow.

Nazewnictwo dla Kodi — często zadawane pytania

→ Zobacz wszystkie FAQ RenameFlow

Czytaj dalej

• → Przewodnik po nazewnictwie Plex (odpowiedniki)
• → Przewodnik po nazewnictwie Jellyfin
• → Zmiana nazw krok po kroku
• → Wszystkie FAQ RenameFlow

Official references: Nazewnictwo plików wideo w Kodi (oficjalna wiki) · Pliki NFO w Kodi (oficjalna wiki) · Scraper Hama na GitHub