tvg-id, group-title i tvg-logo w M3U: co oznaczają

Jeśli zastanawiasz się, co oznacza tvg-id w M3U, zacznij od rozdzielenia trzech pól: tvg-id, group-title i tvg-logo. Opisują kanał, ale pełnią różne role. tvg-id może pomóc dopasować pozycję do danych programu, group-title podaje nazwę grupy, a tvg-logo wskazuje adres grafiki. Są to metadane obok adresu strumienia — same nie tworzą kanału ani nie gwarantują, że przewodnik lub logo pojawią się w każdym odtwarzaczu.

Przykładowy wpis ma zwykle linię opisową #EXTINF, a po niej adres strumienia. Atrybuty mogą występować w różnej kolejności. Poniższy przykład jest fikcyjny i pokazuje tylko strukturę:

#EXTINF:-1 tvg-id="kanal-przyklad.pl" group-title="Informacje" tvg-logo="https://example.invalid/logo.png",Kanał Przykład
https://example.invalid/strumien

Gdzie znajdują się te pola

W typowej playliście M3U każda pozycja składa się z wiersza #EXTINF, który zawiera informacje o elemencie, oraz kolejnego wiersza z adresem źródła. Część przed przecinkiem może zawierać atrybuty, a tekst po przecinku jest nazwą widoczną w playliście. Dokładne formatowanie zależy od tego, jak dostawca wygenerował plik.

Warto oddzielić trzy rzeczy: nazwę kanału, jego metadane i adres strumienia. Nazwa pomaga rozpoznać pozycję. Atrybuty opisują ją dodatkowymi etykietami. URL wskazuje źródło odtwarzania. Zmiana jednego z tych elementów nie musi naprawić pozostałych.

tvg-id: identyfikator używany przy danych programu

tvg-id to identyfikator tekstowy przypisany pozycji playlisty. Często jest używany do skojarzenia kanału z wpisem w przewodniku XMLTV. Feed XMLTV może mieć kanały opisane własnymi identyfikatorami; im lepiej identyfikator z playlisty odpowiada identyfikatorowi w przewodniku, tym łatwiej systemowi powiązać program z właściwą pozycją.

Nie wystarczy jednak, że oba identyfikatory „wyglądają podobnie”. Ważna jest zgodność danych dostarczonych przez źródło. Różne nazwy regionalne, odmiany kanału lub zmiana po stronie dostawcy mogą sprawić, że przewodnik nie pasuje mimo poprawnego odtwarzania. Z kolei brak tvg-id nie oznacza automatycznie, że kanał nie zadziała — zależy to od możliwości playera i od tego, czy dostępny jest inny sposób dopasowania.

Jeśli kanał działa, ale przewodnik jest pusty albo pokazuje program innej stacji, rozdziel diagnozę playbacku od dopasowania EPG. Więcej wyjaśnia artykuł o mapowaniu kanałów XMLTV.

group-title: nazwa grupy kanałów

group-title opisuje grupę, do której dostawca przypisał pozycję, na przykład „Sport”, „Wiadomości” albo „Dokumentalne”. To kategoria w obrębie playlisty, a nie osobne źródło ani część adresu kanału. Pozwala uporządkować długą listę na mniejsze zestawy.

Nazwy grup ustala dostawca. Mogą być po polsku, angielsku, skrócone albo zapisane różnie dla podobnych kategorii. Pusta lub nieoczekiwana grupa może więc wynikać z metadanych playlisty, a nie z błędu odtwarzania. Nie zmieniaj URL-a strumienia tylko dlatego, że etykieta grupy wygląda nietypowo.

tvg-logo: adres grafiki kanału

tvg-logo wskazuje URL grafiki przypisanej do pozycji. To referencja do obrazu, a nie zawartość samego logo. Jeśli adres jest nieaktualny, niedostępny albo nieprawidłowy, grafika może się nie pojawić, nawet gdy kanał działa. Różne odtwarzacze mogą też inaczej obsługiwać brakujące lub błędne obrazy.

Logo nie wpływa na dostępność strumienia ani na program w EPG. Dlatego jeśli nie widzisz grafiki, ale odtwarzanie działa, sprawdź najpierw, czy dostawca nadal podaje aktualny URL. Nie myl braku logo z niedziałającym kanałem.

Krótka ściąga

Pole

Do czego służy

Czego samo nie gwarantuje

tvg-id

Identyfikuje kanał przy dopasowaniu danych programu

Że każdy feed XMLTV będzie pasował

group-title

Opisuje kategorię pozycji playlisty

Że kanał odtworzy się poprawnie

tvg-logo

Podaje adres grafiki kanału

Że obraz będzie dostępny lub poprawny

To rozróżnienie ułatwia diagnozę. Jeśli zawodzi wyłącznie przewodnik, przeczytaj także poradnik o problemach z XMLTV EPG. Jeśli potrzebujesz dodać osobne źródło guide, sprawdź stronę XMLTV EPG playera.

Jak bezpiecznie sprawdzić wpis M3U

Jeśli dostawca udostępnia plik, otwieraj go lokalnie w zaufanym edytorze tekstu. Nie wklejaj pełnej playlisty do publicznego analizatora online — adresy mogą zawierać dane dostępowe. Do porównania wystarczy odczytać kilka pól w wierszu #EXTINF, bez ujawniania prawdziwego URL-a innym osobom.

Sprawdź, czy tvg-id jest obecny, czy group-title ma sensowną wartość i czy URL tvg-logo wygląda na kompletny. Następnie porównaj identyfikator z dokumentacją lub przykładem XMLTV od dostawcy. Nie dopisuj własnych wartości w całej playliście, jeśli nie wiesz, jak player je wykorzystuje — zachowaj kopię oryginału i poproś o prawidłowe metadane.

Trzy częste pomyłki przy czytaniu playlisty

Pierwsza pomyłka to traktowanie tvg-id jak adresu kanału. Identyfikator jest etykietą, a nie URL-em do streamu. Druga to oczekiwanie, że group-title utworzy program telewizyjny — opisuje kategorię, ale nie zawiera harmonogramu. Trzecia to mylenie tvg-logo z obowiązkowym plikiem graficznym: pole może wskazywać na nieaktualny albo niedostępny adres. W każdym przypadku źródło może odtwarzać się normalnie, mimo że metadane są niepełne. Warto więc sprawdzać elementy osobno: najpierw kanał, potem grupę, grafikę i przewodnik.

DaddyTV obsługuje źródła M3U, a XMLTV może być dodane jako warstwa przewodnika. Konkretne zachowanie metadanych zależy jednak od zawartości playlisty, feedu EPG i odtwarzacza. Z tego powodu najpierw ustal, która warstwa nie działa, zamiast zakładać, że wszystkie pola są wymienne.

Jeśli chcesz dodać własną playlistę do aplikacji, sprawdź stronę M3U Player DaddyTV. Ten poradnik wyjaśnia znaczenie pól w pliku; instrukcja konfiguracji opisuje osobno samo dodanie źródła.

Co zapamiętać

tvg-id opisuje identyfikator kanału, group-title jego kategorię, a tvg-logo adres grafiki. Wszystkie trzy pola są przydatne, ale nie zastępują adresu strumienia ani kompletnego feedu XMLTV. Jeśli obraz działa, a guide nie, skup się na dopasowaniu ID i źródle przewodnika. Jeśli nie działa sam kanał, sprawdź jego źródło osobno.