M3U vs Xtream Codes: Hangi IPTV Playlist Formatını Kullanmalısın?

2026'daki her IPTV sağlayıcısı hizmetini iki şekilde sunar: M3U playlist URL'i ve Xtream Codes girişi olarak. Çoğu kullanıcı oynatıcısının önce hangisini istediyse onu seçer ve bir daha düşünmez. Bu bir hata: bunlar birbirinin yerine geçmez ve neredeyse kesin olarak biri sizin durumunuza daha iyi uyar.

30 saniyelik özet

Cevabı baştan istiyorsan:

• M3U: basit, taşınabilir, her yerde çalışır, EPG ayrı bir dosya, kendin alıyorsun. Arşivleme, çoklu-oynatıcı kurulumları ve oynatıcının sağlayıcıya her 10 saniyede bir sinyal göndermesini istemediğin durumlar için en iyisi.
• Xtream Codes: entegre EPG, entegre VOD, entegre favoriler senkronu, sağlayıcı tarafında cihaz limiti uygulanır. Sağlayıcı düzgün destekliyorsa, bir veya iki cihazda günlük izleme için en iyisi.

Sağlayıcı sadece birini veriyorsa seçim şansın yok. İkisini de veriyorsa devamını oku.

Bir M3U dosyası aslında nedir

M3U dosyası düz metindir. Oynatıcının üstten alta okuduğu (metadata, URL) çiftleri listesidir. Format 1995'e dayanır ve başlangıçta Winamp playlist'leri içindi. IPTV için uyarlanmış modern genişletilmiş varyant şöyle görünür:

#EXTM3U url-tvg="https://example.com/epg.xml.gz"
#EXTINF:-1 tvg-id="newsone.uk" tvg-name="News One HD" tvg-logo="https://example.com/newsone.png" group-title="UK | HD",News One HD
https://stream.example.com/live/abc123/12345.m3u8
#EXTINF:-1 tvg-id="newstwo.uk" tvg-name="News Two HD" tvg-logo="https://example.com/newstwo.png" group-title="UK | HD",News Two HD
https://stream.example.com/live/abc123/12346.m3u8

Tüm format bu. #EXTM3U bunun genişletilmiş bir playlist olduğunu bildirir. Her #EXTINF satırı kanal metadata'sını taşır (TV-rehberi ID'si, görünen ad, logo URL'i, grup). Sonraki satır gerçek akış URL'idir: tipik olarak bir HLS .m3u8 manifest'i veya bazen doğrudan bir MPEG-TS uç noktası.

M3U'nun önemli özellikleri:

• Alındığı an statiktir. Oynatıcı dosyayı bir kere indirir. Sağlayıcı kanal eklerse veya taşırsa, yeniden almak zorundasın.
• Sağlayıcının URL'i kimlik bilgilerini içerir. Yukarıdaki örnekteki abc123 bir oturum token'ıdır. URL'e sahip olan herkes aboneliğinize sahiptir.
• EPG kanal-dışıdır. url-tvg özniteliği, oynatıcının bağımsız olarak çektiği ayrı bir XMLTV dosyasını işaret eder. Farklı yaşam döngüsü, farklı saat dilimi, farklı güncelleme kadansı.
• Giriş kavramı yok. URL'in kendisi kimlik doğrulamadır. Oturum yok, çıkış yok, "bu cihaz bir slot işgal ediyor" yok.

Bu basitlik M3U'nun süper gücüdür. Var olan her IPTV oynatıcısı bunu konuşur. Dosyayı yerel olarak kaydedebilir, bir metin editöründe düzenleyebilir, cihazlar arasında paylaşabilir, arşivleyebilirsin. Üzerinde bir Python script'i çalıştırıp grupları temizleyebilir veya ölü kanalları kaldırabilirsin. Veridir, hizmet değildir.

Xtream Codes aslında nedir

Xtream Codes bir HTTP API'sidir, dosya değil. Sağlayıcı sana bir sunucu URL'i, kullanıcı adı ve şifre verir. Oynatıcı şunlar gibi uç noktalara karşı JSON sorguları yapar:

GET https://example.com:8080/player_api.php
       ?username=KULLANICI
       &password=ŞİFRE
       &action=get_live_categories

GET https://example.com:8080/player_api.php
       ?username=KULLANICI
       &password=ŞİFRE
       &action=get_live_streams
       &category_id=4

GET https://example.com:8080/player_api.php
       ?username=KULLANICI
       &password=ŞİFRE
       &action=get_short_epg
       &stream_id=12345
       &limit=4

Her çağrı bir JSON dökümanı döner. Canlı kanallar, VOD katalogları, dizi katalogları, EPG, hesap bilgileri: hepsi ayrı uç noktalar. Oynatıcı bunları gördüğünüz kanal listesinde birleştirir.

Xtream'in önemli özellikleri:

• Canlı veri. Kategori adları, kanal sırası, logolar sunucu tarafında değişebilir ve oynatıcı bir sonraki yenilemede alır.
• EPG kanal-içidir. Aynı kimlik bilgileri, aynı sunucu, aynı yaşam döngüsü. Sağlayıcının saati EPG'nin saatidir.
• Eylem-başı uç noktalar. Oynatıcı sadece sorduğunuzu çeker. 5.000 kanallı M3U'yu yüklemek tek büyük bir istek; bir Xtream oturumu bunu kategorilere bölebilir.
• Gerçek oturumlar. Sunucu ne zaman bağlı olduğunuzu bilir. Cihazlarınızı sayabilir, limit-üstü bağlantıları reddedebilir, boştaki oturumları sonlandırabilir.
• Her URL'de kimlik bilgileri. Kullanıcı adı ve şifre sorgu parametresi olarak gider. Her yerdeki loglar onları depolar. Bu formatın en büyük zayıflığı.

Teslimat katmanı: ikisi de HLS üzerinde, ama farklı

Gerçek video akışı her iki durumda da aynı teknolojidir: neredeyse her zaman HLS (HTTP Live Streaming), bir .m3u8 manifest tarafından referans verilen küçük .ts segmentleri dizisi. Fark, oynatıcının akış URL'ini nasıl keşfettiğidir.

M3U'da:

// Oynatıcı M3U'yu parse eder, kanalı bulur,
// URL'i doğrudan takip eder:
GET https://stream.example.com/live/abc123/12345.m3u8

Xtream'de:

// Oynatıcı API'den akış URL'ini ister:
GET https://example.com:8080/get.php?
    username=KULLANICI&password=ŞİFRE
    &type=m3u_plus&output=ts&stream=12345

// Sunucu yönlendirme veya doğrudan manifest yanıtı verir:
HTTP/1.1 302 Found
Location: https://stream.example.com/live/abc123/12345.m3u8

Yani Xtream esasen "sorgu katmanı arkasında M3U"dur. Gerçek akış aynı. Kazandığınız şey üstüne metadata API'si; kaybettiğiniz şey doğrudan akış URL'ini yer imine eklemek veya kopyalamak.

Buffer için neden önemli

Genellikle önemli değil. Ama oynak ağlarda, Xtream yönlendirmesi M3U'nun doğrudan (manifest → segment) ile karşılaştırıldığında bir tur ekstra yapar (API → yönlendirme → manifest → segment). Kanal değiştirme için bu fazladan hop, geçiş anında algılanan 100-300 ms "bekleme"ye dönüşür. İyi oynatıcılar istekleri çakıştırır; kötüler çakıştırmaz.

EPG: iki formatın sert şekilde ayrıldığı yer

Burası Xtream'in genellikle kazandığı ve M3U'nun genellikle kaybettiği yer, ama detaylar önemli.

M3U + XMLTV: M3U, ayrı bir XMLTV dosyasını işaret eden bir url-tvg özniteliği referans verir. Oynatıcı onu indirir, parse eder, M3U'daki tvg-id özniteliklerini XMLTV'deki channel id öğeleriyle eşleştirir. XMLTV dosyası genellikle 20-50 MB gzipli, 7+ gün kapsar ve günde bir veya iki kez güncellenir. Gerçek zamanlı değildir. Yayıncının programı son dakika değişirse, rehberiniz bir sonraki XMLTV yenilemesine kadar yanlıştır.

Xtream EPG: oynatıcı her kanal için talep üzerine get_short_epg çağırır, gerçek zamanlı olarak sonraki birkaç programı alır. Çoğu sağlayıcı sunucu tarafında her 30-60 dakikada bir yukarı akış kaynaklarından günceller. Sapma nadirdir; ani program değişiklikleri hızla yayılır.

Yön	M3U + XMLTV	Xtream
Kapsam	7-14 gün	Genellikle 1-3 gün
Tazelik	Günlük yenileme, eskimiş olabilir	Talep üzerine, genellikle taze
Kanal eşleştirme	Manuel tvg-id bakımı	Otomatik (sunucu tarafında)
Çevrimdışı kullanım	Çalışır (dosya yerel)	Bağlantı gerektirir
Saat dilimi	Sağlayıcıya bağlı, genellikle UTC	Genellikle sunucu tarafında yerelleştirilmiş
Bant genişliği	Günde bir 30MB+ indirme	Kanal görünümü başına ~5KB

Koltuk izlemesi için Xtream'in deneyimi daha akıcı. Uzun menzilli DVR planlaması ("5 gün sonra hatırlatıcı kur") için M3U+XMLTV'nin derin geçmişi Xtream'in sığ penceresini yener. Bazı ciddi kullanıcılar ikisini de çalıştırır: canlı izleme için Xtream, 7 günlük pencere için ek XMLTV.

Güvenlik ve kimlik bilgisi maruziyeti

Hiçbir format modern anlamda "güvenli" değil, ama hata modları farklı.

M3U maruziyeti: tüm playlist URL'i bir kimlik bilgisi. M3U URL'inizi bir Discord kanalına yapıştırırsanız, oradaki herkes sağlayıcı token'ı döndürene kadar tam erişime sahip. İyi haber, ayrı bir şifre sızması yok; URL şifre.

Xtream maruziyeti: kullanıcı adı/şifre çifti her API isteğinde sorgu parametresi olarak görünür. Şunlara düşer:

• Sağlayıcı tarafındaki web sunucusu erişim logları
• Siz ve sağlayıcı arasındaki HTTP proxy'leri (kurumsal, ISP düzeyi)
• URL bir tarayıcıda açıldıysa Referer header'ı
• API'yi bir sekmede yüklediyseniz tarayıcı geçmişi
• Bug raporlarında ham URL gönderen herhangi bir oynatıcının crash dump'ları

Sağlayıcınız HTTPS Xtream uç noktalarını destekliyorsa onları kullanın, ama kontrol edin. Şaşırtıcı sayıda Xtream paneli hâlâ http:// üzerinde TLS sonlandırması olmadan dinler, özellikle eski Xtream Codes 2.x çalıştıran korsan olanlar. Düz HTTP, yoldaki herkesin kimlik bilgilerinizi kazıması demek.

IP-kilitleme, cihaz limitleri, eşzamanlı akışlar

M3U'nun "oturum" kavramı yok, bu yüzden bir cihaz limitini doğrudan zorlayamaz. Sağlayıcılar şu yollarla çalışır:

• Aynı M3U URL'inden eşzamanlı akışları sayma (> N ise atar)
• URL'i ilk kullanan cihaza IP-kilitleme (başka yerden reddedilir)
• Token rotasyonu: URL haftalık sessizce değişir, eski kopyalar bozulur

Xtream'in oturum modeli bunu yerel hale getirir. API, get_user_info'da döndürülen kullanıcı başına "max_connections"ı izler. Sunucu, M3U'nun "akış durur" yaklaşımı yerine ekstra bağlantıları temiz bir 403 ile reddeder. Daha iyi UX, aynı işlevsel limit.

Aileyle odalar arası paylaşmaya çalışan bir kullanıcı için Xtream daha dürüst. Tek kullanıcılı tek cihaz kurulumunda fark yok olur.

VOD ve diziler: Xtream'in gizli avantajı

Bir M3U dosyası VOD girişlerini listeleyebilir, ama acı verici. Her film ayrı bir #EXTINF + URL satırı, metadata yapısı yok, group-title ötesinde kategorizasyon yok, dizi-bölüm gruplama yok. M3U'dan VOD okuyan oynatıcılar tipik olarak posterleri, açıklamaları, düzgün gruplaması olmayan binlerce başlığın düz bir listesini gösterir.

Xtream'in get_vod_categories, get_vod_streams ve get_vod_info uç noktaları şunları sunar:

• Film posterleri ve arka planları (sunucu tarafında TMDB'den alınmış)
• Konu özetleri, oyuncu kadrosu, puan, yıl, tür
• Dizi → sezonlar → bölümler ağacı
• Konteyner formatı (mkv, mp4), böylece oynatıcı doğrudan-oynat veya transcode yapmaya karar verebilir

Sağlayıcınızın ana içeriği canlı TV yerine VOD/dizi ise, Xtream deneyimi gerçekten daha iyi: düz IPTV listesi yerine Netflix-tarzı UI ile karşılaştırılabilir. Çoğu sadece-M3U oynatıcı VOD'u "diğer kanallar" olarak gömer.

Hangisini seçmelisin?

Karar ağacı:

M3U seç eğer…

• Playlist'ini script'lemek, arşivlemek, düzenlemek veya dönüştürmek istiyorsan
• Çoklu oynatıcı çalıştırıyorsan (biri Windows, biri Android, biri Apple TV) ve taşınabilir bir dosya istiyorsan
• Uzun menzilli EPG'yi (DVR planlaması için 7+ gün) önemsiyorsan ve iyi bir XMLTV kaynağın varsa
• Sağlayıcı sadece M3U gönderiyorsa veya Xtream sunucusu güvenilmezse
• Birden fazla kaynaktan toplayan bir "playlist of playlists" bakımı yapıyorsan

Xtream Codes seç eğer…

• Küçük resimli, posterli ve zengin EPG'li TV benzeri bir deneyim istiyorsan
• Sağlayıcının önemsediğin önemli VOD/dizi içeriği varsa
• Sabit cihaz sayın var ve sağlayıcı limitleri temiz şekilde zorluyorsa
• Kanal listesinin hiçbir şeyi yeniden indirmeden sunucu tarafında yenilenmesini tercih ediyorsan
• Sağlayıcının Xtream paneli HTTPS çalıştırıyorsa

Bölünmüş karar

Nightmare TV'deki güç kullanıcıları genellikle zengin metadata ve canlı EPG için Xtream Codes'ı birincil bağlantı olarak, artı 7-günlük genişletilmiş rehber için ek bir XMLTV dosyası çalıştırır. Her ikisinin de en iyisi: günlük kullanım için Xtream UX, istediğiniz zaman XMLTV derin geçmiş. Nightmare TV ikisini de aynı kanal listesinde yüklemenize izin verir.

Yanlış hamle, aynı sağlayıcıyı iki kez yüklemek: bir M3U olarak, bir Xtream olarak. Çift kanallar, çelişen EPG ve oynatıcı hangisine güveneceğinden emin olamayacak. Bir tane gerçek-kaynak seç ve onu destekle.

Kısa Özet

• M3U düz bir metin dosyası. Taşınabilir, script'lenebilir, oturum yok. EPG ayrı bir XMLTV indirmesi.
• Xtream Codes bir HTTP API. Canlı metadata, kanal-içi EPG, oturum-bilen cihaz limitleri, gerçek VOD UI.
• İkisi de altta HLS sunuyor: akış kalitesi aynı, etrafındaki sarmalayıcı farklı.
• Taşınabilirlik ve script'lenebilirlik için M3U seç. Günlük izleme ve VOD için Xtream seç.
• Xtream sunucunun HTTPS olduğunu her zaman kontrol et. Düz HTTP her istekte şifreni açığa çıkarır.
• En iyi uygulama: 7 günlük EPG derinliği için Xtream birincil + ek XMLTV.