صيغة M3U / M3U8 مشروحة سطرًا بسطر

ملف نصي لا محتوى

وُلدت صيغة M3U في تسعينيات القرن الماضي مع مشغّلات الصوت المكتبية، وأشهرها Winamp، لتسجيل قائمة مقطوعات متتابعة. ولم يتغير مبدؤها منذ ذلك الحين: قائمة تشغيل M3U هي ملف نصي خام يضم سلسلة عناوين (مسارات محلية أو URL) يفتحها المشغّل بالترتيب. لا يحتوي على صورة ولا صوت ولا فيديو. بل يكتفي بإخبار المشغّل أين يجد كل تدفق وكيف يعرضه.

وهذا يفسّر أمرين كثيرًا ما يُساء فهمهما. أولًا، قد «يحتوي» ملف M3U حجمه بضع مئات من الكيلوبايتات على آلاف المدخلات: فليس فيه سوى نص. ثانيًا، لا قيمة للقائمة إلا بالعناوين التي تشير إليها: فإذا كان الخادم المقصود خارج الخدمة بقي الملف صحيحًا تمامًا لكن لا يبدأ شيء. والمشغّل، مثل مشغّل الفيديو والوسائط، لا يفعل سوى تفسير هذه الأسطر؛ أما قانونية التدفقات وتوفرها فتتوقفان كليًا على مصدرها، ويجب أن تملك الحقوق على ما تشاهده.

نصادف قوائم M3U اليوم في ثلاثة أوضاع رئيسية: قوائم ملفات صوت أو فيديو مخزنة على قرص أو NAS، وقوائم إذاعات وقنوات يبثها ناشروها عبر الإنترنت، والقوائم التي توفرها خدمة تلفزيونية أنت مشترك فيها.

البنية الدنيا: #EXTM3U و#EXTINF

تبدأ قائمة التشغيل «الموسعة» (Extended M3U) حتمًا بالترويسة #EXTM3U في السطر الأول تمامًا. ثم يشغل كل مدخل سطرين: سطر وصف يبدأ بـ #EXTINF، ثم سطر العنوان نفسه. إليك مثالًا كاملًا وصحيحًا، بإذاعتين وهميتين:

#EXTM3U
#EXTINF:-1,Radio Exemple Info
https://flux.exemple.fr/info/live.mp3
#EXTINF:-1,Radio Exemple Musique
https://flux.exemple.fr/musique/playlist.m3u8

لنحلّل السطر #EXTINF:-1,Radio Exemple Info:

• #EXTINF: يعلن عن معلومات المدخل التالي.
• -1 هي المدة بالثواني. في مقطوعة موسيقية نكتب مثلًا 215؛ وفي التدفق المباشر الذي لا نهاية له تكون القاعدة المتبعة -1 (بعض القوائم تضع 0، وتتسامح معه معظم المشغّلات).
• الفاصلة تفصل الجزء التقني عن الاسم المعروض. وكل ما يلي آخر فاصلة بعد الخصائص هو العنوان الذي سيراه المستخدم.

الأسطر التي تبدأ بـ # وليست توجيهات معروفة تُعامَل تعليقات وتُتجاهل. والأسطر الفارغة مسموح بها مبدئيًا، لكن الأفضل تجنبها بين #EXTINF وعنوانه: فبعض المشغّلات تفقد حينئذ الربط بين الاسم والتدفق.

الخصائص الموسعة: tvg-id وtvg-logo وgroup-title

في قوائم القنوات استقر عرف: إضافة خصائص بين المدة والفاصلة، على شكل nom="valeur". ولا تدخل في أي معيار رسمي، لكن تكاد كل مشغّلات التلفزيون تتعرف عليها.

#EXTM3U url-tvg="https://guide.exemple.fr/epg.xml.gz"
#EXTINF:-1 tvg-id="exemple1.fr" tvg-name="Exemple 1" tvg-logo="https://img.exemple.fr/ex1.png" group-title="Généralistes",Exemple 1 HD
https://tv.exemple.fr/live/ex1.m3u8

في سطر الترويسة، تبيّن الخاصية url-tvg (أو بديلها x-tvg-url) عنوان دليل البرامج بصيغة XMLTV. وتفصّل مقالتنا عن EPG وصيغة XMLTV طريقة عمل هذا الدليل.

قاعدتان في الصياغة تجنّبانك معظم المشكلات: القيم تُوضع دائمًا بين علامات اقتباس مستقيمة ("، لا «» ولا “ ”)، ويجب ألا يحتوي الاسم المعروض على علامات اقتباس غير مهرَّبة. وفاصلة داخل قيمة بين علامتي اقتباس تقبلها المحللات الجيدة، لكن فاصلة في اسم القناة نفسه قد تبتر العنوان عند بعض المشغّلات.

M3U أم M3U8: ما الفرق؟

يدل الامتداد .m3u8 في الأصل على قائمة تشغيل M3U مرمَّزة بـ UTF-8. ومن هنا جاء الرقم «8». أما ملف .m3u التقليدي فكان يُقرأ تاريخيًا بالترميز المحلي للنظام (غالبًا Windows-1252 في أوروبا الغربية وWindows-1256 للعربية)، ما كان يحوّل «Généralistes» إلى «Généralistes» حين يُفتح على جهاز ملف كُتب على جهاز آخر.

وفي 2009 تبنّت Apple هذا الامتداد لبروتوكول بثها HLS (HTTP Live Streaming)، الذي وُحِّد لاحقًا في RFC 8216. فقد يدل ملف .m3u8 إذن على شيئين مختلفين تمامًا:

• قائمة قنوات أو مقطوعات، كتبها إنسان أو خدمة، تحمّلها في مشغّلك؛
• مانيفست HLS، يولّده خادم البث تلقائيًا، ويسرد مقاطع الفيديو الصغيرة التي مدة كل منها بضع ثوانٍ لقناة واحدة أو فيلم واحد.

يحتوي الثاني على توجيهات خاصة بـ HLS، مثل #EXT-X-TARGETDURATION أو #EXT-X-STREAM-INF. فإذا فتحت عنوانًا ورأيت أسماء من نوع segment_10452.ts تتوالى، فأنت تنظر إلى مانيفست HLS لا إلى قائمة قنوات. ويشرح مقالنا HLS وMPEG-TS وDASH هذه الآلية بالتفصيل.

عمليًا، تقرأ المشغّلات الحالية .m3u و.m3u8 بلا تمييز وتكتشف UTF-8 في معظم الحالات. ويبقى الأسلم أن تحفظ قوائمك دائمًا بترميز UTF-8، أيًّا كان الامتداد.

الترميز وBOM ونهايات الأسطر: الفخاخ الخفية

كثير من القوائم «التي لا تعمل» مكتوبة كتابة سليمة تمامًا… لكنها محفوظة حفظًا خاطئًا. وثلاث تفاصيل لا تُرى على الشاشة تسبب المشكلة.

الـ BOM في UTF-8

تضيف بعض المحررات، ومنها إصدارات قديمة من المفكرة (Notepad) في ويندوز، في بداية الملف ثلاثة بايتات غير مرئية تسمى BOM (Byte Order Mark: EF BB BF بالنظام الست عشري). فالمشغّل الصارم الذي يتحقق من أن الملف يبدأ بالضبط بـ #EXTM3U يرى #EXTM3U مسبوقًا بهذه البايتات، فيرفض القائمة أو يتجاهل المدخل الأول. والحل: احفظ بترميز «UTF-8» لا «UTF-8 with BOM». في Notepad++ تقترح قائمة Encoding الخيارين صراحةً؛ وفي Visual Studio Code يظهر الترميز أسفل يمين النافذة ويتغير بنقرة.

حروف مشوّهة بعد التحويل

إذا ظهرت الأسماء بسلاسل مثل é أو برموز �، فقد كُتب الملف بترميز وقُرئ بآخر. أعد فتحه في محرر يتيح اختيار ترميز القراءة (Windows-1256 أو Windows-1252 أو ISO-8859-1 إذا عادت الحروف صحيحة)، ثم أعد حفظه بترميز UTF-8.

نهايات الأسطر

ينهي ويندوز الأسطر بحرفين (CR LF)، أما لينكس وmacOS وأندرويد فبحرف واحد (LF). وتقبل المشغّلات الحديثة الاثنين، لكن حرف CR متبقيًا ملتصقًا بنهاية URL قد يجعله غير صالح عند خادم مدقِّق. وعند الشك حوّل إلى LF، وهو ما توفره محررات الشيفرة.

أخطاء الصياغة الأكثر شيوعًا

هذه هي العيوب التي نجدها غالبًا عند فتح قائمة عنيدة، مع عَرَضها وتصحيحها.

وللقوائم الكبيرة جدًا، عادة أخيرة مفيدة: عدّ أسطر #EXTINF وأسطر العناوين. في ويندوز، ينجز PowerShell ذلك بـ (Select-String -Path liste.m3u -Pattern '^#EXTINF').Count. ويجب أن يتساوى الرقمان.

إنشاء قائمة تشغيلك وتحريرها

بناء قائمة تشغيل يدويًا بسيط، ويتيح جمع الإذاعات والقنوات التي يبثها ناشروها مجانًا في مواقعهم، أو فيديوهات الـ NAS لديك، مثلًا. والطريقة:

1. افتح محرر نصوص يتحكم في الترميز: Notepad++ أو Visual Studio Code في ويندوز، وTextEdit بوضع «النص العادي» في ماك. وتجنب معالجات النصوص (Word وLibreOffice Writer) التي تُدرج علامات اقتباس طباعية.
2. اكتب الترويسة #EXTM3U في السطر الأول، ويليها عند الاقتضاء url-tvg="…" إن كان لديك دليل.
3. أضف كل مدخل في سطرين: #EXTINF:-1 group-title="Radios",Nom ثم العنوان الكامل، مبتدئًا بـ http:// أو https:// لتدفق شبكي، أو بمسار لملف محلي.
4. احفظ بترميز UTF-8 دون BOM، بالامتداد .m3u أو .m3u8.
5. اختبر القائمة في مشغّلك وصحّح المدخلات الفاشلة واحدًا واحدًا.

للملفات المحلية، فضّل المسارات النسبية (Films/vacances-2024.mp4) حين تكون القائمة في المجلد نفسه الذي توجد فيه الفيديوهات: فتبقى القائمة صالحة إن نقلت المجموعة كلها إلى قرص آخر. أما المسار المطلق مثل C:\Users\… فلن يعمل إلا على الجهاز الأصلي.

وأخيرًا، لتحميل قائمة في مشغّل، هناك عادةً خياران: تحديد عنوانها على الويب (يعيد المشغّل تنزيلها عند كل تحديث، فتنعكس تحديثات المصدر) أو استيراد ملف محلي (ثابت ما لم تستبدله). وفي AICKO IPTV تُشرح الطريقتان خطوة بخطوة في صفحة Xtream Codes وM3U.

الخلاصة

• قائمة M3U ملف نصي يسرد عناوين؛ ولا تحتوي على أي فيديو.
• تبدأ بـ #EXTM3U، ثم يتناوب سطر #EXTINF وسطر عنوان لكل مدخل.
• تتولى الخصائص tvg-id وtvg-logo وgroup-title الدليل والشعارات والفئات.
• يعني .m3u8 «M3U بترميز UTF-8»، لكنه يدل أيضًا على مانيفستات بروتوكول HLS.
• احفظ دائمًا بترميز UTF-8 دون BOM، مع علامات اقتباس مستقيمة.

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

هل يمكن فتح ملف M3U بالمفكرة (Notepad)؟

نعم. إنه ملف نصي بسيط، يُقرأ ويُعدَّل بأي محرر. وعند الحفظ اختر ترميز UTF-8؛ فالإصدارات الحديثة من المفكرة في ويندوز 10 و11 تحفظ بترميز UTF-8 دون BOM افتراضيًا.

لماذا تُحمَّل قائمتي لكن لا تبدأ أي قناة؟

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

هل ملف M3U خطير؟

الملف نفسه لا يحتوي سوى نص ولا يمكنه التنفيذ. ينشأ الخطر من مصدره: فقائمة من مصدر مشبوه قد تشير إلى محتوى يُبث بصورة غير قانونية. لا تحمّل إلا قوائم صادرة عن خدمات أنت عميل لديها أو عن ناشرين رسميين.

ما الحجم الأقصى لقائمة التشغيل؟

لا تضع الصيغة أي حد. وتأتي القيود من الجهاز: قد تبطئ قائمة من عدة عشرات الآلاف من المدخلات التحميل على جهاز تلفزيون ضعيف. وحذف الفئات غير اللازمة يحسّن الاستجابة بوضوح.