EPG · XMLTV

ما هو EPG؟

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

Lumen·TV مشغّل IPTV لـAndroid TV وGoogle TV وFire TV وهواتف Android وأجهزته اللوحية. يحتاج إلى Android 8.0 أو أحدث. يشغّل قائمة تشغيل M3U أو Xtream Codes التي لديك بالفعل، ولا يتضمن أي قنوات. 21 يومًا مجانًا، ثم ‏0.99 € شهريًا لجهاز واحد، أو ‏19.99 € دفعة واحدة لعدد 2 من الأجهزة، أو ‏29.99 € دفعة واحدة لعدد 5. الفترة التجريبية لا تحتاج إلى بطاقة، وتنتهي من تلقاء نفسها.

حُدِّث في 28 أكتوبر 2026

ماذا يحتوي ملف XMLTV.

نوعان من الإدخالات: <channel> لكل قناة يغطيها الدليل، مع id واسم؛ و<programme> لكل برنامج، يسمّي قناته بذلك المعرّف، مع وقت بداية ووقت نهاية وعنوان، وغالبًا وصف.

<tv>
  <channel id="news24.example">
    <display-name>News 24</display-name>
  </channel>
  <programme channel="news24.example" start="20261021190000 +0200" stop="20261021200000 +0200">
    <title>Evening bulletin</title>
    <desc>Headlines, weather, sport.</desc>
  </programme>
</tv>

قناة واحدة وأحد برامجها. يحمل كل وقت فارقه الخاص عن UTC، وهو هنا متقدّم بساعتين.

حجمه: يبلغ أسبوع من البرامج لقائمة تشغيل كبيرة عدة ميغابايتات، لذا تُنشر الأدلة غالبًا مضغوطة، بصيغة .xml.gz.
إلى أي مدى مسبقًا: بقدر ما يملؤه الناشر: بضعة أيام، أو أسبوع، وأحيانًا أكثر.

كيف يعثر الدليل على قنواتك: tvg-id.

الدليل وقائمة التشغيل ملفان منفصلان، يأتيان غالبًا من مكانين منفصلين، ويربط بينهما شيء واحد: يجب أن يطابق tvg-id في سطر القناة ضمن قائمة تشغيل M3U تمامًا id قناة في الدليل. فـtvg-id="news24.example" يعثر على برامج channel="news24.example"؛ أما tvg-id="News24" فلا يعثر على شيء.

لذلك عندما يُحمَّل الدليل ولكنه لا يعرض شيئًا لقنواتك، يكون السبب المعتاد أن الملفين يسمّيان قنواتهما بطريقة مختلفة، ولا يستطيع التوفيق بينهما إلا من ينشرهما. أما خادم Xtream Codes فينشر قائمة قنواته ودليله معًا، ولهذا يتطابقان عادةً.

من أين يأتي عنوان الدليل.

مع تسجيل دخول Xtream Codes: ينشر الخادم الدليل على xmltv.php، ويُفتح باسم المستخدم وكلمة المرور نفسيهما، لذا يستطيع المشغّل أن يعثر عليه بنفسه. راجع ما هو Xtream Codes.
مع قائمة تشغيل M3U: الدليل عنوان ثانٍ، ينشره مزوّدو الخدمة عادةً بجانب رابط قائمة التشغيل. ويكتبه بعضهم في السطر الأول من قائمة التشغيل، بصيغة url-tvg؛ أما قراءة المشغّل له من هناك فتتوقف على المشغّل.
من مكان آخر: أي عنوان XMLTV يفي بالغرض، ما دامت معرّفاته تطابق معرّفات قائمة التشغيل.

ماذا يفعل Lumen·TV بالدليل.

دليل واحد لكل قائمة تشغيل، يُعرض كخط زمني تتصفحه نصف ساعة أو يومًا في كل مرة، وكالبرنامج الحالي والتالي فوق الصورة.
عدد الأيام الذي ينشره مزوّد الخدمة، حتى سبعة أيام.
تسجيل دخول Xtream Codes، أو رابط get.php، يعثر على دليله بنفسه. أما قائمة M3U العادية فتحتاج إلى إدخال عنوان الدليل على حدة: إذ لا يقرأ Lumen·TV العنوان المكتوب داخل قائمة التشغيل. إضافة دليل، خطوة بخطوة.
يطابق البرامج مع القنوات عبر tvg-id وحده، ويقرأ الدليل المنشور مضغوطًا (.xml.gz) وكذلك غير المضغوط.
يوضّح سبب خلوّ الدليل: لا يوجد عنوان، أو عنوان لا يحتوي على برامج، أو قنوات بلا tvg-id، أو معرّفات لا تطابق شيئًا، أو دليل توقّف مزوّده عن تحديثه.
دمج عدة أدلة في دليل واحد، وضبط فارق توقيت الدليل، والتذكيرات ليست ضمن التطبيق.