Halka Açık IPTV Çalma Listeleri İçin XMLTV EPG Nedir ve Nasıl Bağlanır?

Medya akışlarıyla yeni tanışan pek çok kullanıcı, eline bir M3U çalma listesi dosyası geçtiğinde tüm kurulumun bittiğini düşünür. Oysa bu listeyi bir TV kutusunda ya da IPTV istemcisinde açtığınızda ekranda yalnızca çıplak kanal adlarından oluşan bir sütun belirir: Hangi kanalda hangi dizi veya haber bülteni var göremezsiniz, programın ne zaman biteceğini bilemezsiniz, akşam kuşağına bakamazsınız. Bu haliyle liste, soğuk bir adres defterinden farksızdır.

Oynatıcınızın geleneksel televizyonlardaki gibi rehberli bir arayüze kavuşması için EPG desteği şarttır. Bu yazıda EPG ile XMLTV ilişkisini, çalma listesiyle program rehberinin neden ayrı dosyalarda tutulduğunu, iki yapının hangi etiketler üzerinden eşleştiğini ve açık veri ekosistemindeki teknik sınırları ele alacağız.

Program Rehberi Olmadığında Çalma Listesi Yalnızca İsimlerden İbarettir

Sitemizde yer alan M3U metin yapısı incelemesi başlıklı yazımızı okuduysanız, standart bir M3U dosyasının temelde tek bir işleve sahip olduğunu bilirsiniz: Canlı yayın akış adreslerini ve temel tanımlayıcı etiketleri barındırmak.

Uyumlu bir program rehberi bulunmadığında oynatıcı yalnızca kanal adını ve bağlantı adresini okuyabilir. Uzaktan kumandayla açtığınız menü en fazla basit bir kanal seçiciye dönüşür. Ancak sisteme program bilgisi dahil edildiğinde oynatıcı iki boyutlu bir zaman çizelgesi çizebilir: Yatay eksende saatler, dikey eksende kanallar yer alır; her kutucukta ise yayın adı, başlangıç-bitiş saatleri ve kısa özet bulunur. Kullanıcıya televizyon yayın akışını sunan bu veri mekanizmasına EPG (Electronic Program Guide - Elektronik Program Rehberi) denir.

EPG ve XMLTV Nedir?

EPG, sunulan işlevin genel adıyken XMLTV, bu işlevi hayata geçirmek için kullanılan en yaygın açık veri formatıdır.

XML sözdizimine dayanan XMLTV, açık kaynaklı yazılımlar ile farklı işletim sistemleri arasında televizyon yayın akışı verilerini sorunsuz aktarmak için geliştirilmiştir. Standart bir XMLTV metni iki ana bileşenden oluşur:

1. Kanal Tanımı (channel düğümü): Kanalın benzersiz kimliğini (id), ekranda görünecek adını (display-name) ve logo adresini (icon) tanımlar.
2. Yayın Maddesi (programme düğümü): Somut yayın akışını saklar. Her kayıt bağlı olduğu kanalın kimliğini (channel), başlangıç zamanını (start), bitiş zamanını (stop), program başlığını (title) ve isteğe bağlı açıklama veya kategori bilgilerini içerir.

Modern IPTV istemcileri açılış sırasında bu XMLTV dosyasını indirip ayrıştırır. Zaman damgalarını cihazın yerel saat dilimine dönüştürür ve ekranda ızgara biçiminde düzenli bir elektronik program tablosu oluşturur.

Neden İki Ayrı Dosyaya Bölünmüştür?

Birçok kişi şu soruyu sorar: Madem kanal bilgisiyle yayın akışı birlikte kullanılıyor, neden program rehberi doğrudan çalma listesinin içine gömülmüyor da M3U ve XMLTV olarak iki bağımsız dosya halinde tutuluyor?

Bu tercihin temelinde iki dosya türünün güncelleme sıklığı ve veri boyutu arasındaki derin fark yatar:

• Yaşam Döngüsü Farkı: Televizyon kanallarının yayın adresleri nispeten sabittir. Sunucu taşınmadığı veya hat değişmediği sürece bir çalma listesi haftalarca, hatta aylarca güncellenmeden çalışabilir. Oysa program rehberi son derece dinamiktir; günlük olarak değişir ve genellikle birkaç günde bir ya da her gün yeniden indirilmesi gerekir.
• Veri Boyutu Farkı: Onlarca açık kanal barındıran tipik bir M3U dosyası yalnızca birkaç kilobayt (KB) boyutundadır. Ancak aynı kanalların bir haftalık dakika dakika detaylı yayın akışını ve özetlerini içeren XMLTV dosyası açıldığında onlarca megabayta (MB) ulaşabilir. Kanal her değiştirildiğinde veya adres kontrol edildiğinde bu devasa veri yığınının baştan aktarılması hem gereksiz bant genişliği tüketir hem de düşük donanımlı TV kutularının kilitlenmesine yol açar.

Açık veri ekosisteminde de bu mantık geçerlidir. Örneğin açık kaynaklı kanal dizinlerinde çalışan test yayınları bir havuzda toplanırken (bunun için halka açık televizyon kanalları dizini kılavuzu içeriğimize göz atabilirsiniz), internetten küresel rehber verilerini çeken projeler tamamen bağımsız bir EPG deposu altında yürütülür.

Nasıl Bağlanır? Sık Karşılaşılan Eşleşmeme Nedenleri

Çalma listesi oynatıcıya «video akışının nereden çekileceğini», program rehberi ise «bu kanalda hangi saatte ne yayınlanacağını» bildirir. Bu iki bağımsız kaynağı birbirine bağlayan köprü, M3U etiketinde genellikle tvg-id olarak geçen benzersiz kanal kimliğidir.

Tipik eşleme mantığı şu şekildedir:

M3U dosyasında kanal özelliklerini bildiren örnek satır:

#EXTINF:-1 tvg-id="CCTV1.cn" tvg-name="CCTV-1" tvg-logo="[原文](https://example.com/logo.png"),CCTV-1 综合
[原文](https://example.com/live/cctv1.m3u8)

Buna karşılık gelen XMLTV dosyasında ise şu tanımlar yer alır:

<channel id="CCTV1.cn">
  <display-name>CCTV-1</display-name>
</channel>
<programme start="20260908120000 +0800" stop="20260908123000 +0800" channel="CCTV1.cn">
  <title lang="zh">新闻30分</title>
</programme>

İstemci, M3U içerisindeki tvg-id ile XMLTV içerisindeki channel id değerini karşılaştırır. Bu iki metin dizesi birebir eşleştiğinde «新闻30分» yayını sorunsuz bir şekilde «CCTV-1 综合» kanalının yayın çubuğuna iliştirilir.

Kurulumun ardından rehber boş kalıyorsa veya yanlış bilgiler gösteriliyorsa, sorun çoğunlukla şu nedenlerden kaynaklanır:

1. tvg-id Büyük/Küçük Harf veya Karakter Farklılığı: M3U içinde tvg-id="cctv1" yazarken XMLTV dosyasında channel id="CCTV1.cn" tanımlanmışsa, isimler birbirine çok benzese dahi katı dize eşleşmesi başarısız olur.
2. Saat Dilimi Dönüşüm Hataları: XMLTV zaman damgaları ISO biçimindedir ve saat dilimi farkını belirtir (örneğin +0800). Oynatıcı cihazın yerel saat dilimini doğru hesaplayamazsa, o anki yayın birkaç saat ileri veya geri kaymış görünür.
3. Yayın Verisinin Süresinin Dolması: İnternetten toplanan EPG verileri kısıtlı bir zaman aralığını kapsar. Veri toplama betiği kesintiye uğramış ve dosya geçen haftada kalmışsa, kimlikler tam uyuşsa bile oynatıcı bugüne ait kayıt bulamaz ve boş ekran gösterir.
4. XML Biçim ve Kodlama Bozuklukları: XML katı kurallara tabidir. Kaçış karakteri uygulanmamış tek bir özel karakter (örneğin yalın bırakılmış &) veya kapatılmamış bir etiket tüm dosyanın işlenmesini durdurabilir ve sonraki kanalların da kaybolmasına yol açabilir.

Sitemizde Program Rehberi Nasıl Kontrol Edilir ve Yönetilir?

Yerel veya açık kaynaklı dosyalarınızı rahatça denetleyebilmeniz için platformumuzda pratik araçlar sunuyoruz:

• XMLTV Metnini Görüntüleme ve Doğrulama: /xmltv-checker/ aracını kullanabilirsiniz. Bu araç, XMLTV metinlerini veya bağlantılarını hızla ayrıştırarak kanal kimliklerini, geçerlilik tarihlerini ve yayın yapısını listeler. Elinizdeki rehberin kurallara uygun ve güncel olup olmadığını kolayca teyit edebilirsiniz.
• Çalma Listesi Etiketlerini Düzenleme: Oynatıcıya yüklemeden önce /m3u-playlist-editor/ üzerinden her satırdaki tvg-id yazımının XMLTV kimliğiyle tam örtüştüğünden emin olun. Akış bağlantısının erişilebilirliğini test etmek için ise /hls-player/ aracından yararlanabilirsiniz.
• Abonelik Oluşturma ve Cihaz Senkronizasyonu: /playlist-sync/ çalışma alanında onaylı listelerinizi merkezi olarak yönetebilir, EPG adresinizi ekleyerek cihazlarınız için toplu bir özel Feed oluşturabilirsiniz.

Önemli bir noktayı hatırlatmakta fayda var: Masaüstü bilgisayarda test yaparken oluşturulan özel Feed veya .m3u bağlantısını doğrudan Chrome tarayıcısının adres çubuğuna yapıştıran kullanıcılar olabiliyor. Chrome bir web tarayıcısıdır; bu bağlantıyı ya düz metin olarak indirir ya da doğrudan video olarak açmaya çalışır. Bir IPTV istemcisi gibi arka planda ilişkili EPG adresini çekip çözümlemez. Dolayısıyla masaüstü tarayıcısında bağlantı açmak bir rehber testi sayılmaz; doğrulama mutlaka XMLTV destekli bir oynatıcıda yapılmalıdır.

Halka Açık Verilerin Nesnel Sınırları

Kişisel izleme ortamınızı kurarken açık EPG kaynaklarının sınırlarını bilmeniz önemlidir:

• Platformumuzun Niteliği: m3u8-player.net teknik bir araç sitesidir. Sitemizdeki /xmltv-checker/ aracı yalnızca dosya yapısını doğrulamak amacıyla sunulur. Sitemiz bir televizyon kuruluşu değildir; yayın iletimi sağlamaz ve televizyon kanalı satışı yapmaz.
• Açık Kaynakların Dalgalı Yapısı: İnternette ücretsiz paylaşılan EPG verileri, çoğunlukla gönüllülerin web sayfalarından veri kazıyarak oluşturduğu otomatik çıktılardır. Bu kaynaklar her an kesintiye uğrayabilir, biçim değiştirebilir veya bazı niş kanalları içermeyebilir. Sitemiz, internetteki tüm açık kanallar için eksiksiz yayın akışı bulunabileceğini garanti etmez ve edemez.

Bireysel kullanıcılar için en mantıklı yaklaşım, listeyi sade tutmaktır: Binlerce çalışmayan açık kanalı oynatıcıya doldurmak yerine, öncelikle temel kanalların tvg-id değerlerini araçlarımızla doğrulayıp düzenli güncellenen yasal bir rehber kaynağıyla eşleştirmelisiniz.

Özet

IPTV çalma listesi ile program rehberi arasındaki ilişki, radyo cihazı ile gazetedeki yayın akışı bülteni arasındaki bağa benzer. Çalma listesi iletim hattını kurar, XMLTV yayın bilgilerini sunar, tvg-id ise ikisini buluşturan anahtardır. Bu iki dosyanın birlikte nasıl çalıştığını kavradığınızda, oynatıcılarda karşılaşılan siyah ekran, eksik kanal veya rehbersiz yayın sorunlarının büyük kısmını kolayca çözebilirsiniz.

Yeni bir program rehberi edindiğinizde veya oynatıcınız rehberi yükleyemediğinde, dosya sözdizimini ve kanal etiketlerini doğrulamak için hemen /xmltv-checker/ sayfasına giderek metni veya bağlantıyı test edebilirsiniz.

Kaynaklar

• Zhihu yazarı「易三福」: EPG istemcinin o an ne yayınlandığını göstermesini sağlar, format XMLTV’dir ve eşleşme tvg-id üzerinden yapılır (原文)
• Zhihu yazarı「x1ao4」: M3U ve XMLTV aynı anda hazırlanmalıdır; ID eşleşmezse kanal logosu ve yayın akışı görüntülenemez (原文)
• Zhihu yazarı「怪侠说不说」: iptv-org ekosisteminde EPG deposu ile çalma listesi deposu birbirinden bağımsız olarak sürdürülür (原文)