Troubleshooting·9 min

Yazan Shamir

EPG Yüklenmeyebiliyor Mu? 2026'da IPTV TV Kılavuzunuzu Düzeltmenin Eksiksiz Rehberi

IPTV oynatıcınızı kurup kurdum. Kanallar yükleniyor. Aralarında geçiş yapabilirsiniz. Her şey harika görünüyor — ta ki TV kılavuzunu açıp hiçbir şey bulmayıncaya kadar, sadece boş hücrelerden oluşan bir deniz. Ya da daha kötü: içinde yanlış gösterilerin olduğu hücreler, beş yıl önce sona eren programları listeleyen.

EPG sorunları, tamponlama sonrasında ikinci en çok bildirilen IPTV şikâyetidir ve sinir bozucu olan şey, nedeninden bağımsız olarak semptomların aynı görünmesidir. Bu rehber, bozuk EPG'lerin arkasındaki beş gerçek sorunu, kontrol etmeye değer sırada incelemektedir.

Ekran görüntüsü: kanalları gösteren ancak program olmayan boş EPG ızgara

The fast fix

Boş bir kılavuzun beş nedeni vardır — çoğu bakmadan önce düzeltilir

Tuneline, sanallaştırılmış oluşturmayı içeren ve büyük kılavuzları bile hızlı tutan, tek dokunuşlu XMLTV yenilemeli ücretsiz bir medya oynatıcıdır — böylece eski oynatıcıları boğan plan verileri burada temiz yüklenir. Hesap gerekli değil, kendi oynatma listenizi getirin.

Ücretsiz İndir

Bir EPG Aslında Nedir?

EPG Elektronik Program Kılavuzu'nun kısaltmasıdır. Bu, IPTV oynatıcınıza her kanalda şu anda neyin yayınlandığını, sırada neyin olduğunu ve program açıklamalarının ne olduğunu söyleyen metaveridir. Bunda sihir yok — oynatıcınız bir dosya indirir veya bir API'yi sorgular, program başlıklarını ve zamanlarını ayrıştırır ve onları kanallarınızın yanında bir ızgarada oluşturur.

Standart format XMLTV'dir: her kanalı, her programı, her başlangıç saatini, her süresi ve isteğe bağlı olarak afişleri ve açıklamaları listeleyen tek bir XML dosyası. Büyük bir sağlayıcı için tipik bir XMLTV dosyası sıkıştırılmamış 50–500 MB olabilir ve yüz binlerce program girişi içerebilir.

EPG'nin bu kadar sık kırılmasının nedeni, bu dosyanın gereksinim duymasıdır:

  1. Sağlayıcınızdan başarıyla indirin.
  2. Doğru şekilde sıkıştırmasını açın (çoğu gzip'lenmiştir).
  3. Hatasız analiz edin.
  4. Oynatma listenizde kanal kimliklerini eşleştirin — çoğu hata burada oluşur.
  5. Oynatıcınızın ızgarasında zaman aşımı olmadan görüntülenin.

Bu beş adımdan herhangi birinde başarısızlık size boş bir TV kılavuzu verir. Bunları adım adım gidelim.

Gönderip sonra kendim araştırdığım bir hata (böylece bunu kendi oynatıcınızda tespit edebilirsiniz): Tuneline'nin önceki bir sürümü ayrıştırılmış EPG'i bellekte tutuyordu ve kullanıcı Xtream kaynakları arasında geçiş yaptığında bunu geçersiz kılmıyordu. Semptom: kılavuz dolu görünüyordu, ancak program başlıkları önceki sağlayıcının kanallarına aitti. Yeniden yüklerseniz veya zorla yenileseniz ve doğru kılavuz görünürse, bu tür bir hatadır — ve onu kaynak başına önbellek kapsamı olmadan agresif bir şekilde önbelleğe alan oynatıcılarda şaşırtıcı derecede yaygındır.


Neden 1: EPG URL'niz Eski Veya Eksik

Bu, en yaygın neden ve çözülmesi en basit olanıdır. Bir M3U oynatma listesi kullanıyorsanız, EPG'iniz oynatıcınıza manuel olarak girmeniz gereken ayrı bir XMLTV URL'den gelir. Birçok kullanıcı:

  • Hiçbir zaman EPG URL'si girmedi (M3U kanalları var ama kılavuz kaynağı yok).
  • Aylar önce girdiği ve o zamandan beri çevrimdışı olan EPG URL'si.
  • Yanlış URL girdi — farklı bir sağlayıcının kanal listesi için bir kılavuz.

Nasıl düzeltilir

Sağlayıcınızın belgeleme sayfasını bulun. Hemen hemen her ücretli IPTV sağlayıcısı hem M3U URL hem de XMLTV URL yayınlar. Tipik olarak şöyle görünürler:

http://your-provider.example/xmltv.php?username=USER&password=PASS

Veya:

http://your-provider.example/epg.xml.gz

Bunu oynatıcınızın EPG ayarlarına yapıştırın, bir yenileme zorlayın ve kılavuzun doldurulmasını izleyin. Tuneline'de bu Ayarlar → EPG → XMLTV URL'si, hemen yanında bir yenileme düğmesi ile ve kılavuz genellikle yenilemeden sonra saniyeler içinde doldurulur.

Ekran görüntüsü: Tuneline EPG ayarları XMLTV URL ve yenileme düğmesiyle

Xtream Codes'de iseniz, genellikle EPG URL'sini ayarlamanıza gerek yoktur — EPG kanallar ile aynı API aracılığıyla gelir. Xtream'de kılavuzunuz boşsa, Neden 3'e geçin.


Neden 2: EPG İndirildi Ancak Kanal Kimlikler Eşleşmeyebiliyor

Bu en sinir bozucu EPG başarısızlığıdır çünkü EPG'in çalıştığı gibi görünür — oynatıcınız başarıyla yüklendiğini söyler — ancak ızgara hala boştur.

Ne oldu: XMLTV dosyanız, her biri news.us veya sport.de gibi bir tvg-id tarafından tanımlanan binlerce kanal içeriyor. M3U oynatma listeniz kendi tvg-id değerlerine sahiptir. Kimlikler eşleşmezse, oynatıcı bir programı kanalına bağlayamaz. Hiçbir şey bağlantılı olmadığı için işe yaramayan tamamen yüklü bir EPG ile sona erirsiniz.

Nasıl tespit edilir

M3U dosyanızda bir kanalın girişine bakın. Satır şu şekilde görünecektir:

#EXTINF:-1 tvg-id="cnn.us" tvg-name="CNN" tvg-logo="...",CNN

Şimdi XMLTV dosyanıza bakın (çoğu sağlayıcı bunu doğrudan indirmenize izin verir). Kanal kimliğini arayın. Eşleşen <channel id="cnn.us"> girişi var mı? Hayır ise — veya kimlikler biraz farklı ise (örn., CNN.us vs cnn.us) — bu sizin sorununuz.

Nasıl düzeltilir

Oynatıcınıza bağlı olarak birkaç seçenek:

  • En iyi çözüm: Bulanık eşleştirme yapan bir oynatıcı kullanın — yani tvg-id eksik veya yanlış yazılı olduğunda normalleştirilmiş adla kanalları eşleştirmeye geri döner. Tuneline'nin eşleştirmesi her iki tarafı küçük harfe dönüştürür, "HD"/"FHD"/"4K" ve bölge kodları gibi yaygın sonekleri çıkarır ve karşılaştırmadan önce boşluğu daraltır. Mükemmel değildir (gerçekten aynı şey olarak adlandırılan iki kanal çarpışacaktır), ancak sağlayıcının kimliklerinin sadece hantallığı olan oynatma listeleri kaydeder (70-80%).
  • Manuel çözüm: M3U dosyanızı düzenleyin ve XMLTV dosya ile eşleştirmek için tvg-id değerlerini değiştirin. Bu sıkıcı ama işe yarar.
  • Sağlayıcı çözümü: IPTV sağlayıcınıza e-posta gönderin ve onlara M3U kimliklerinin ve XMLTV kimliklerinin eşleşmediğini söyleyin. Şaşırtıcı derecede sık dosyayı yeniden oluştururlar — bu şikâyeti sürekli alırlar.

Neden 3: Sağlayıcınızın EPG Sunucusu Yavaş veya Oran Sınırlaması Yapıyor

Büyük XMLTV dosyalarının indirilmesi gerçek zamana alır. Sağlayıcınızın EPG sunucusu aşırı yüklenmişse (yoğun saatlerde çok yaygındır), oynatıcınız indirme tamamlanmadan zaman aşımına uğrayabilir. Bazı sağlayıcılar EPG indirmelerini de oran sınırlandırırlar — son saatte EPG'i beş kez yenileseydim, sonraki istek sessizce bırakılabilir.

Semptomlar

  • EPG bazen yüklenir ama her zaman değil.
  • Kurulduktan sonra ilk yenileme işe yarar, sonra sonraki yenilemeler boş döndürür.
  • EPG sabah 3'te çalışır ama akşam 8'de başarısız olur.

Nasıl düzeltilir

  • Oynatıcınızda EPG zaman aşımını artırın. Çoğu oynatıcı 30 saniyeyi varsayılan olarak ayarlar. Bunu 120'ye yükseltin.
  • EPG'yi daha az sık yenileyin. Canlı program verileri için her 12 veya 24 saatte bir yeterlidir.
  • Gziplenmiş sürümü kullanın. Sağlayıcınız hem epg.xml hem de epg.xml.gz'i açığa çıkarırsa, her zaman gziplenmiş URL'yi kullanın — tipik olarak 5–10× daha küçüktür.
  • Sağlayıcı oran sınırı koymışsa, bir saat bekleyin. Sonra yenileyin ve bir gün boyunca tekrar yenilemeyin.

Neden 4: XMLTV Dosyanız Bozulmuş

Bazı sağlayıcıların XMLTV dışarı aktarımları hatalı biçimlendirilmiş girdileri içerir — geçersiz tarih biçimleri, bozuk UTF-8 karakterleri, kapatılmamış etiketler. Katı bir XML ayrıştırıcısı, tek bir bozuk giriş nedeniyle tüm dosyayı yüklemeyi reddedecek ve sizi boş EPG ile bırakacaktır.

Nasıl tespit edilir

Oynatıcınızın günlükleri (her ciddi oynatıcının vardır) "Satır 47291'de XML ayrıştırma hatası" veya "beklenmeyen giriş sonu" gibi hatalar gösterirse, bozuk bir dosyaya çarpmışsınız.

Nasıl düzeltilir

Genellikle üç seçeneğiniz vardır:

  • Daha hoşgörülü bir oynatıcı kullanın. Bazı oynatıcılar (Tuneline dahil) hatalı biçimlendirilmiş girdileri atlamak ve geri kalanını yüklemek için yapılandırılır. Katı oynatıcılar tüm dosyadan feragat ederler.
  • Farklı bir EPG kaynağı kullanın. Birçok ücretsiz halka açık EPG toplayıcısı, sağlayıcı verilerini daha temiz biçimlendirme ile yeniden yayınlar. Lisans koşullarına dikkat edin.
  • Kötü dosyayı sağlayıcınıza bildirin. Genellikle bir gün içinde bunu düzeltebilirler.

Neden 5: Oynatıcınız Büyük EPG'leri İyi Oluşturmakta Kötü

Bazı oynatıcılar EPG desteklediklerini iddia ederler ancak ızgara birkaç yüz kanaldan fazla olduğunda boğulurlar. Veriler var, ayrıştırma başarılı oldu, ancak binlerce program girişini aynı anda oluşturmak çok yavaş olduğu için kullanıcı arayüzü donuyor veya boş hücreler gösteriyor.

Semptomlar

  • EPG'nin kaydırılması yavaş.
  • Kaydırırken hücreler görünür ve kaybolur.
  • İlk 50 kanal programları gösterir ama bunun altındaki herhangi bir şey boştur.

Nasıl düzeltilir

Bu bir oynatıcı sınırlamasıdır. Çözümler şunlardır:

  • Sanal EPG rendering ile bir oynatıcı kullanın. Modern oynatıcılar yalnızca gerçekten görebildiğiniz hücreleri render eder, bu nedenle 5.000 kanallı bir kılavuz, 50 kanallı bir kılavuz kadar hızlı kaymaktadır. Tuneline'nin EPG ızgarası sanal ve 10.000+ kanal oynatma listeleriyle test edilmiştir — büyük kılavuzlar TV izlemenizin yavaş hissetmesinin nedeni olmamalıdır.
  • Kanal listenizi filtreleyin. Yalnızca düzenli olarak 30 kanal izliyorsanız, diğer her şeyi gizleyin. EPG daha küçük bir listede çok daha hızlı render edilir.
  • Oynatıcı değiştirin. EPG ile aylar boyunca mücadele ettiyseniz, bu genellikle doğru cevaptır.

Zaman Kazandıran Tanı Sırası

Birisi bize "neden EPG yüklenmiyor?" diye sorduğunda, bunu sırasıyla açıklarız:

  1. Yapılandırılmış bir EPG URL var mı? (M3U'da ise.) Çoğu kullanıcı bu adımı atladı.
  2. URL hâlâ çalışıyor mu? Tarayıcıda açın — XML görmeli veya bir indirme almalısınız.
  3. M3U içindeki kanal kimlikleri XMLTV içindeki kimliklerle eşleşiyor mu? Bir kanal seçin ve elle doğrulayın.
  4. Sağlayıcınızın EPG sunucusu şu anda yanıt veriyor mu? Günün farklı bir saatinde yenilemeyi deneyin.
  5. XMLTV dosyası ayrıştırılıyor mu? Ayrıştırma hataları için oynatıcı günlüklerini kontrol edin.
  6. Oynatıcınız bu kılavuzun boyutunu işleyebiliyor mu? Daha küçük bir alt kümeyi deneyin.

Bunları sırasıyla incelirseniz, her seferinde nedeni bulursunuz.


"İyi EPG" Aslında Neye Benziyor

İşte IPTV oynatıcınıza uygulamanız gereken standar:

  • İlk yükleme < 60 saniye Wi-Fi'da 200 MB'lık bir kılavuz için.
  • Arka planda yenileme oynatmayı kesintiye uğratmayan.
  • Bulanık kimlik eşleştirmesi böylece hafifçe uyumsuz oynatma listeleri yine de bağlanır.
  • Şu An/Sonraki bar tam ızgarayı açmadan şu anda yayında olanı ve sonrakini gösterme.
  • EPG içinde arama yapın — "oyun saat kaçta?" gibi soruları kaydırmadan bulun.
  • Hatırlatmalar — belirli bir program başlayacağı zaman sizi uyarır.
  • Tekrar izleme entegrasyonu — 3 saat önce yayınlanan bir programa tıklamak, sağlayıcınız destekliyorsa tekrar izlemeyi oynatır.

Mevcut oynatıcınız bunların çoğunu yapmazsa, bu normal değildir. Oynatıcınızın teknolojik açıdan geriye kalmış olduğunun bir işaretidir.

Ekran Görüntüsü: Tuneline içinde tam dolu bir EPG ızgara


Sıkça Sorulan Sorular

Neden EPG yıllar öncesinden eski şovları gösteriyor?

XMLTV dosyanız eski. Oynatıcınız bir kez rehber indirdi ve o zamandan beri yenileme yapmadı. Manuel olarak yenilemeyi zorlayın, ardından otomatik yenilemenin günlük bir programda etkinleştirildiğini kontrol edin.

Neden EPG bazı kanallar için çalışıyor ama diğerleri için değil?

Neredeyse her zaman bir tvg-id eşleştirme sorunu (Neden 2). EPG olan kanallar XMLTV dosyasıyla eşleşen kimliklere sahiptir; olmayanlar sahip değildir.

Kullanabileceğim ücretsiz bir genel EPG kaynağı var mı?

Evet — iptv-org/epg gibi projeler birçok ülke için topluluk tarafından yönetilmiş XMLTV dışa aktarımlarını sağlar. Kalite değişir. Sağlayıcınızın EPG'nın yerini almak yerine ona ek olması en iyisidir.

Tuneline, eski IPTV oynatıcılarından daha iyi EPG desteğine sahip midir?

Biz EPG desteğini özellikle denediğimiz her diğer oynatıcı yukarıdaki beş nedenden birinde başarısız olduğu için inşa ettik. Tuneline bulanık kimlik eşleştirmesi, sanal ızgara renderlaması, arka planda yenileme, arama, hatırlatmalar ve desteklenen yerlerde tekrar izleme entegrasyonu yapar. Bunların hiçbiri sihir değildir — 2026'de bir TV kılavuzunun yapması gereken şeydir.

EPG'ı ne sıklıkla yenilemeliyim?

Canlı program verileri için günde bir kez yeterlidir. Çoğu sağlayıcı XMLTV'ı günde bir veya iki kez günceller. Her 15 dakikada bir yenileme, size daha yeni veriler vermez — sadece sağlayıcınızı yorar ve muhtemelen hız sınırlamasına uğrarsınız.


Kısa Versiyon

EPG sorunları gizemli görünüyor ama neredeyse her zaman beş düzeltilebilir sorundan birinden kaynaklanır: eksik URL, uyumsuz kanal kimlikleri, yavaş sağlayıcı, bozuk dosya veya zayıf oynatıcı renderlaması. Bunları sırasıyla incelirseniz, kılavuzu bir saatten kısa sürede düzelteceksiniz.

Her birkaç haftada aynı EPG tuhaflıklarıyla mücadele etmekten bıktıysanız, try Tuneline — bulanık kimlik eşleştirmesi, sanal rendering ve arka planda yenileme standarttır. Kılavuzunuz sadece çalışmalıdır.

Yazıyı paylaş

The fast fix

Rather not troubleshoot? Tuneline handles this for you.

A free media player with hardware-accelerated playback and automatic reconnect built in — the two things most players leave off. Bring your existing playlist.

Download free

The cross-platform media player behind these answers — new platforms, sync updates, the honest build story. No spam, unsubscribe anytime.

Bu yazıyı başka bir dilde okuyun

Tuneline bir medya oynatıcı uygulamasıdır. Hiçbir içerik sağlamaz, barındırmaz veya dağıtmaz. Kendi oynatma listenizi siz getirirsiniz, tıpkı VLC'de olduğu gibi.