Troubleshooting·9 min

بقلم Shamir

EPG لا تعمل؟ دليل شامل لإصلاح دليل البرامج الخاص بك في 2026

أعددت مشغل IPTV. تحملت القنوات. يمكنك التبديل بينها. كل شيء يبدو رائعًا — حتى تفتح دليل البرامج وتجد لا شيء سوى بحر من الخلايا الفارغة. أو الأسوأ: خلايا بها برامج خاطئة، تعرض عروضًا انتهت قبل خمس سنوات.

مشاكل EPG هي ثاني أكثر شكوى IPTV التي يتم الإبلاغ عنها بعد التخزين المؤقت، والشيء المحبط هو أن الأعراض تبدو متطابقة بغض النظر عن السبب. يشرح هذا الدليل خمس مشاكل حقيقية وراء أدلة البرامج المعطلة، بالترتيب الذي تستحق فحصه.

لقطة شاشة: شبكة EPG فارغة تعرض القنوات بدون برامج

The fast fix

يوجد خمس أسباب لدليل فارغ — معظمها يمكن إصلاحها قبل أن تبحث

Tuneline هو مشغل وسائط مجاني بعرض افتراضي يحافظ على سرعة حتى الأدلة الضخمة، مع تحديث XMLTV بضغطة واحدة — بحيث تحمل بيانات البرامج التي تخنق المشغلات القديمة بشكل نظيف هنا. لا حساب مطلوب، احضر قائمة التشغيل الخاصة بك.

تحميل مجاني

ما هو EPG فعلاً

EPG يرمز إلى دليل البرامج الإلكتروني. إنها البيانات الوصفية التي تخبر مشغل IPTV الخاص بك بما يتم بثه حاليًا على كل قناة، وما يأتي بعده، وما هي أوصاف البرامج. لا يوجد سحر هنا — يحمل مشغلك ملفًا أو يستعلم عن API، ويحلل عناوين البرامج والأوقات، ويعرضها في شبكة بجانب قنواتك.

الصيغة القياسية هي XMLTV: ملف XML واحد يسرد كل قناة وكل برنامج وكل وقت بدء وكل مدة، واختياريًا الملصقات والأوصاف. يمكن لملف XMLTV النموذجي لمزود كبير أن يكون 50–500 ميجابايت بدون ضغط ويحتوي على مئات الآلاف من إدخالات البرامج.

السبب في انقطاع EPG كثيرًا هو أن هذا الملف يجب أن:

  1. يتم تحميله بنجاح من مزودك.
  2. يتم فك ضغطه بشكل صحيح (معظمها مضغوط).
  3. يتم تحليله بدون أخطاء.
  4. يطابق معرّفات القنوات في قائمة التشغيل — هذا حيث يحدث معظم الأعطال.
  5. يتم عرضه في شبكة مشغلك بدون انقطاع.

الفشل في أي من تلك الخطوات الخمس يعطيك دليل برامج فارغ. دعنا نمر بها.

خطأ شحنته ثم تتبعته بنفسي (بحيث تتمكن من اكتشافه في مشغلك الخاص): نسخة سابقة من Tuneline احتفظت ب EPG المحلل في الذاكرة ولم تلغِ صحتها عندما انتقل المستخدم بين مصادر Xtream. العرض: بدا الدليل ممتلئًا، لكن عناوين البرامج كانت للقنوات من المزود السابق. إذا أعدت التثبيت أو فرضت التحديث وظهر الدليل الصحيح، فهذا هو نوع هذا الخطأ — وهو شائع بشكل مفاجئ في المشغلات التي تخزن مؤقتًا بقوة دون تحديد نطاق ذاكرة التخزين المؤقت لكل مصدر.


السبب 1: عنوان URL EPG الخاص بك قديم أو مفقود

هذا هو السبب الأكثر شيوعًا والأبسط للإصلاح. إذا كنت تستخدم قائمة تشغيل M3U، فإن EPG الخاص بك يأتي من عنوان URL XMLTV منفصل يجب عليك إدخاله يدويًا في مشغلك. يفعل العديد من المستخدمين إما:

  • لم يدخلوا عنوان URL EPG على الإطلاق (M3U يحتوي على قنوات لكن بدون مصدر دليل).
  • أدخلوا عنوان URL EPG قبل أشهر وانقطع الآن.
  • أدخلوا عنوان URL خاطئ — دليل لقائمة قنوات مزود مختلف.

كيفية إصلاحها

ابحث عن صفحة توثيق مزودك. ينشر كل مزود IPTV مدفوع تقريبًا عنوان URL M3U و عنوان URL XMLTV. عادة ما تبدو كالتالي:

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

أو:

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

الصق هذا في إعدادات EPG في مشغلك، وأجبر على التحديث، وشاهد الدليل يملأ. في Tuneline، هذا هو الإعدادات → EPG → XMLTV URL، مع زر تحديث بجانبه مباشرة، وعادة ما يملأ الدليل في غضون ثوانٍ من التحديث.

لقطة شاشة: إعدادات Tuneline EPG مع XMLTV URL وزر التحديث

إذا كنت على Xtream Codes، فعادة لا تحتاج إلى تعيين عنوان URL EPG على الإطلاق — يأتي EPG من خلال نفس API كما تفعل القنوات. إذا كان دليلك فارغًا على Xtream، فتخطَّ إلى السبب 3.


السبب 2: تم تحميل EPG لكن معرّفات القناة غير متطابقة

هذا هو فشل EPG الأكثر إحباطًا لأنه يبدو كأن EPG نجح — يقول مشغلك إنه تم تحميله بنجاح — لكن الشبكة لا تزال فارغة.

ما حدث: ملف XMLTV الخاص بك يحتوي على آلاف القنوات، كل منها يتم تحديده بواسطة tvg-id مثل news.us أو sport.de. قائمة التشغيل M3U الخاصة بك لديها قيم tvg-id الخاصة بها. إذا لم تتطابق المعرّفات، لا يمكن للمشغل ربط برنامج بقناته. ينتهي بك الحال مع EPG محملة بالكامل وعديمة الفائدة لأن لا شيء يتصل.

كيفية اكتشافها

انظر إلى إدخال قناة واحدة في ملف M3U الخاص بك. سيبدو السطر كالتالي:

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

الآن انظر إلى ملف XMLTV الخاص بك (معظم المزودين يسمحون لك بتحميله مباشرة). ابحث عن معرّف القناة. هل توجد إدخالة <channel id="cnn.us"> متطابقة؟ إذا لم تكن — أو إذا كانت المعرّفات مختلفة قليلاً (مثل CNN.us مقابل cnn.us) — فهذه هي مشكلتك.

كيفية إصلاحها

خيارات قليلة، اعتمادًا على مشغلك:

  • أفضل إصلاح: استخدم مشغلاً يقوم بـ المطابقة الضبابية — أي، يعود إلى مطابقة القنوات بالاسم المعياري عندما يكون tvg-id مفقودًا أو خاطئ التغليف. يحول مطابق Tuneline كلا الجانبين إلى أحرف صغيرة، ويزيل اللواحق الشائعة مثل "HD"/"FHD"/"4K" وأكواد المنطقة الزائدة، ويطوي المسافات البيضاء قبل المقارنة. إنها ليست مثالية (قناتان لهما نفس الاسم بالفعل ستتعارض)، لكنها تنقذ 70-80٪ من قوائم التشغيل حيث معرّفات المزود مجرد غير مرتبة.
  • إصلاح يدوي: عدّل ملف M3U الخاص بك وغيّر قيم tvg-id لمطابقة ملف XMLTV. هذا متعب لكنه يعمل.
  • إصلاح المزود: أرسل بريدًا إلكترونيًا إلى مزود IPTV الخاص بك وأخبره أن معرّفات M3U ومعرّفات XMLTV الخاصة به غير متطابقة. بشكل مفاجئ في كثير من الأحيان، سيعيدون إنشاء الملف — فهم يتلقون هذه الشكوى باستمرار.

السبب 3: خادم EPG الخاص بمزودك بطيء أو يحد من معدل الطلب

تحميل ملفات XMLTV الكبيرة يستغرق وقتًا حقيقيًا. إذا كان خادم EPG الخاص بمزودك محملاً بشكل زائد (شائع جدًا أثناء ساعات الذروة)، قد يحدث انقطاع في مشغلك قبل انتهاء التحميل. يحد بعض المزودين أيضًا من تحميلات EPG — إذا قمت بتحديث EPG خمس مرات في الساعة الماضية، قد يتم حذف الطلب التالي بصمت.

الأعراض

  • يحمل EPG أحيانًا لكن ليس دائمًا.
  • يعمل التحديث الأول بعد التثبيت، ثم تعود التحديثات اللاحقة فارغة.
  • يعمل EPG في الساعة 3 صباحًا لكن يفشل في الساعة 8 مساءً.

كيفية إصلاحها

  • زد انقطاع EPG في مشغلك. معظم المشغلات الافتراضية 30 ثانية. ارفعها إلى 120.
  • حدّث EPG أقل. مرة واحدة كل 12 أو 24 ساعة كافٍ لبيانات البرنامج المباشر.
  • استخدم الإصدار المضغوط. إذا كشف مزودك عن epg.xml و epg.xml.gz، استخدم دائمًا عنوان URL المضغوط — عادة ما يكون أصغر 5-10 مرات.
  • إذا حد المزود من معدل الطلب، انتظر ساعة واحدة. ثم حدّث ولا تحدّث مرة أخرى لمدة يوم واحد.

السبب 4: ملف XMLTV الخاص بك تالف

تتضمن بعض تصدير XMLTV للمزودين إدخالات سيئة التكوين — تنسيقات تاريخ غير صالحة، أحرف UTF-8 معطلة، علامات غير مغلقة. سيرفض محلل XML الصارم تحميل الملف بأكمله بسبب إدخالة مكسورة واحدة، تاركًا لك EPG فارغ.

كيفية اكتشافها

إذا أظهرت سجلات مشغلك (كل مشغل جاد لديه منها) أخطاء مثل "XML parse error at line 47291" أو "unexpected end of input"، فقد اصطدمت بملف تالف.

كيفية إصلاحها

لديك بشكل عام ثلاث خيارات:

  • استخدم مشغلاً أكثر تسامحًا. تم تكوين بعض المشغلات (بما فيها Tuneline) لتخطي الإدخالات سيئة التكوين وتحميل الباقي. المشغلات الصارمة تستسلم للملف بأكمله.
  • استخدم مصدر EPG مختلفًا. تعيد العديد من تجميعات EPG العامة المجانية نشر بيانات المزود بتنسيق أنظف. كن حذرًا من شروط الترخيص.
  • أبلغ عن الملف السيء لمزودك. يمكنهم عادة إصلاحه في غضون يوم واحد.

السبب 5: مشغلك ليس جيدًا في عرض أدلة البرامج الكبيرة

يدّعي بعض المشغلات دعم EPG لكنهم يختنقون عندما تكون الشبكة أكثر من بضع مئات القنوات. البيانات موجودة، نجح التحليل، لكن واجهة المستخدم إما تتجمد أو تعرض خلايا فارغة لأن عرض آلاف إدخالات البرامج بشكل متزامن بطيء جدًا.

الأعراض

  • التمرير عبر EPG متقطع.
  • تظهر الخلايا وتختفي أثناء التمرير.
  • القنوات الخمسين الأولى تعرض البرامج لكن أي شيء أقل من ذلك فارغ.

كيفية إصلاحها

هذا حد المشغل. الإصلاحات هي:

  • استخدم مشغّلاً بتصيير EPG معرّض افتراضياً. المشغلات الحديثة تعرض الخلايا التي تراها فقط، بحيث يتحرك دليل بـ 5000 قناة بنفس سرعة دليل بـ 50 قناة. شبكة Tuneline's EPG معرّضة افتراضياً واختُبرت على قوائم تشغيل تضم أكثر من 10000 قناة — الأدلة الكبيرة لا يجب أن تكون سبباً في أن تشعر بأن مشاهدة التلفاز بطيئة.
  • صفّ قائمة القنوات الخاصة بك. إذا كنت تشاهد 30 قناة فقط بشكل منتظم، اخفِ كل شيء آخر. EPG يعرض بسرعة أكثر بكثير على قائمة أصغر.
  • بدّل المشغل. هذه غالباً هي الإجابة الصحيحة إذا كنت تعاني من EPG لأشهر.

ترتيب تشخيصي يوفر الوقت

عندما يسأل أحدهم: "لماذا لا يتم تحميل EPG الخاص بي؟" نرشده عبر الخطوات بهذا الترتيب:

  1. هل هناك عنوان EPG مُكوّن؟ (إذا كنت تستخدم M3U.) معظم المستخدمين تخطوا هذه الخطوة.
  2. هل لا يزال العنوان يعمل؟ افتحه في متصفح — يجب أن ترى XML أو تحصل على تنزيل.
  3. هل معرّفات القنوات في M3U تتطابق مع معرّفات XMLTV؟ اختر قناة واحدة وتحقق يدوياً.
  4. هل خادم EPG من موفرك يستجيب الآن؟ حاول التحديث في وقت مختلف من اليوم.
  5. هل يمكن قراءة ملف XMLTV بشكل صحيح؟ تحقق من سجلات المشغل بحثاً عن أخطاء التحليل.
  6. هل يمكن لمشغلك التعامل مع حجم هذا الدليل؟ جرب مجموعة فرعية أصغر.

إذا عملت بشكل منهجي من خلال كل هذا، ستجد السبب في كل مرة.


كيف يبدو "EPG جيد" بالفعل

إليك المعيار الذي يجب أن تطالب به من مشغل IPTV:

  • تحميل < الأول في 60 ثانية لدليل بحجم 200 ميجابايت على Wi-Fi.
  • تحديث خلفي لا يقاطع التشغيل.
  • مطابقة معرّفات ذكية بحيث لا تزال قوائم التشغيل المختلفة قليلاً تربط.
  • شريط الآن/التالي يعرض ما يُبث الآن وما سيبث لاحقاً دون فتح الشبكة الكاملة.
  • البحث في EPG — ابحث عن "متى تبث اللعبة؟" دون التمرير.
  • التنبيهات — أخبرني عندما يكون برنامج معين على وشك البدء.
  • دمج إعادة البث — النقر على برنامج أُذيع منذ 3 ساعات يشغل إعادة البث إذا كان موفرك يدعمها.

إذا لم يفعل مشغلك الحالي معظم هذه الأشياء، فهذا ليس طبيعياً. هذا يشير إلى أن مشغلك متخلف عن أحدث التقنيات.

لقطة شاشة: شبكة EPG مكتملة بالكامل في Tuneline


الأسئلة الشائعة

لماذا يعرض EPG الخاص بي برامج قديمة من سنوات مضت؟

ملف XMLTV الخاص بك قديم. حمل مشغلك دليلاً مرة واحدة ولم يحدثه منذ ذلك الحين. أجبر تحديثاً يدوياً، ثم تأكد من تفعيل التحديث التلقائي على جدول يومي.

لماذا يعمل EPG مع بعض القنوات ولا يعمل مع قنوات أخرى؟

تقريباً دائماً مشكلة مطابقة tvg-id (السبب 2). القنوات التي بها EPG لديها معرّفات تطابق ملف XMLTV؛ والقنوات بدونها لا تطابق.

هل هناك مصدر EPG عام مجاني يمكنني استخدامه؟

نعم — مشاريع مثل iptv-org/epg تحتفظ بصادرات XMLTV منسقة من المجتمع لعدد من الدول. تختلف الجودة. إنها أفضل كملحق لـ EPG موفرك، وليس كبديل.

هل يتمتع Tuneline بدعم EPG أفضل من مشغلات IPTV الأقدم؟

بنينا دعم EPG خصيصاً لأن كل مشغل آخر جربناه فشل في أحد الأسباب الخمسة أعلاه. يفعل Tuneline مطابقة معرّفات ذكية وتصيير شبكة افتراضي وتحديث خلفي وبحث وتنبيهات ودمج إعادة البث حيث يكون مدعوماً. لا شيء من هذا سحري — إنه فقط ما يجب أن يفعله دليل التلفاز في 2026.

كم مرة يجب أن أحدث EPG الخاص بي؟

مرة واحدة في اليوم كافية لبيانات البرنامج المباشرة. معظم الموفرين يحدثون XMLTV الخاص بهم مرة أو مرتين يومياً. التحديث كل 15 دقيقة لن يحصل على بيانات أحدث — سيؤدي فقط إلى إرهاق موفرك واحتمال فرض تقييد على معدل الطلبات.


النسخة المختصرة

مشاكل EPG تبدو غامضة لكنها تقريباً دائماً ناجمة عن واحدة من خمس مشاكل قابلة للإصلاح: عنوان URL مفقود أو معرّفات قنوات غير متطابقة أو موفر بطيء أو ملف تالف أو تصيير ضعيف من المشغل. اعمل من خلالها بالترتيب وستصلح الدليل في أقل من ساعة.

إذا كنت متعباً من محاربة نفس EPG الغرائب كل بضعة أسابيع، جرب Tuneline — مطابقة معرّفات ذكية وتصيير افتراضي وتحديث خلفي يأتيان معياريين. دليلك يجب أن يعمل ببساطة.

شارك هذا المقال

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.

اقرأ هذا المقال بلغة أخرى

Tuneline هو تطبيق مشغل وسائط. لا يوفر أي محتوى ولا يستضيفه ولا يوزعه. أنت من يحضر قائمة التشغيل الخاصة بك، تمامًا كما تفعل مع VLC.