مرجع صيغتي M3U وM3U8

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

أبسط قائمة تشغيل

أبسط ملف M3U قائمة بالعناصر، عنصر في كل سطر:

Music/Artist/01-first-song.flac
Music/Artist/02-second-song.flac
https://radio.example.com/jazz

• كل سطر غير فارغ لا يبدأ بالرمز # هو عنصر: مسار ملف أو عنوان ويب.
• الأسطر التي تبدأ بالرمز # تعليقات أو توجيهات، وتتجاهل المشغّلات ما لا تفهمه منها.
• تُتجاهل الأسطر الفارغة.

صيغة M3U الموسّعة

تستخدم معظم القوائم اليوم الصيغة الموسّعة، التي تضيف سطر بداية وسطر وصف قبل كل عنصر:

#EXTM3U
#EXTINF:245,Artist – First song
Music/Artist/01-first-song.flac
#EXTINF:-1,Jazz radio
https://radio.example.com/jazz

#EXTM3U

يجب أن يكون السطر الأول تماماً. وهو يخبر المشغّل بقراءة أسطر #EXT…. وبدونه، تتعامل كثير من المشغّلات مع الملف كقائمة بسيطة وتتجاهل الأسماء والتفاصيل الأخرى.

#EXTINF:<duration>,<title>

يصف العنصر في السطر التالي:

• المدة (duration): الطول بالثواني. والقيمة -1 (أو 0 في بعض الملفات) هي الطريقة المعتادة للتعبير عن مدة “غير معروفة” أو “مستمرة”، كما في البث الإذاعي؛
• العنوان (title): الاسم الذي يعرضه المشغّل، أي كل ما بعد الفاصلة الأولى.

السمات

تقرأ كثير من المشغّلات أيضاً سمات بصيغة key="value" بين المدة والفاصلة:

#EXTINF:-1 tvg-id="jazz.example" tvg-logo="https://example.com/jazz.png" group-title="Radio",Jazz radio
https://radio.example.com/jazz

السمة	معناها الشائع
tvg-logo	عنوان صورة الشعار للعنصر
group-title	المجموعة أو المجلد الذي ينتمي إليه العنصر
tvg-id	معرّف يُستخدم لمطابقة العنصر مع بيانات دليل البرامج
tvg-name	اسم بديل يُستخدم لهذه المطابقة

هذه السمات عُرف متّبع وليست معياراً. تدعم المشغّلات مجموعات مختلفة منها، وبعضها يتجاهلها كلياً. وقد صُمّم M3U.Click ليحتفظ بكل سمة بترتيبها الأصلي، بما في ذلك السمات التي لا يعرفها، فلا يضيع شيء عند الحفظ.

توجيهات أخرى قد تراها

السطر	معناه	الدعم
#EXTGRP:<name>	يضع العناصر التالية في مجموعة	بعض المشغّلات؛ ويتجاهله VLC 3
#PLAYLIST:<title>	عنوان للقائمة كلها	يقرؤه VLC
#EXTALBUMARTURL:<url>	صورة الألبوم للعنصر	يقرؤه VLC
#EXTVLCOPT:<option>	خيار لا يفهمه إلا VLC	VLC فقط

تتجاوز المشغّلات الأسطر التي لا تفهمها، لذا فالأسطر الخاصة بمشغّل معيّن لا تضرّ غيره. ويحتفظ بها M3U.Click كما هي، مرتبطة بعنصرها.

العناصر: المسارات والعناوين

يمكن أن يكون العنصر:

• مساراً مطلقاً، مثل C:\Users\Sam\Music\song.flac في Windows أو /home/sam/Music/song.flac في Linux وmacOS؛
• مساراً نسبياً، مثل Music/song.flac، تقرؤه المشغّلات نسبةً إلى المجلد الذي يحتوي على ملف القائمة؛
• عنوان ويب، مثل https://example.com/podcast/episode-42.mp3؛
• مسار شبكة بالصيغة التي يفهمها المشغّل، مثل مجلد مشترك على شبكتك.

المسارات النسبية تجعل القائمة قابلة للنقل: يمكنك نقل القائمة مع مجلد الوسائط الخاص بها. ويشرح دليل خوادم الوسائط المنزلية كيف تتعامل الخوادم معها.

الترميز: لماذا وُجدت صيغة M3U8

• ملف .m3u8 يستخدم ترميز UTF-8. فمواصفة HLS (‏RFC 8216) تشترط أن تكون القوائم بترميز UTF-8، ويتوقع VLC أن تكون ملفات .m3u8 بترميز UTF-8 صحيح.
• ملف .m3u ليس له ترميز ثابت. فمثلاً، يقرأ VLC ملف .m3u الذي ليس بترميز UTF-8 صحيح على أنه Latin-1، فتظهر الأسماء العربية أو السيريلية أو الصينية في مثل هذا الملف رموزاً مشوّهة.

توصيتنا: احفظ القوائم بترميز UTF-8 وبامتداد .m3u8، دون علامة ترتيب البايتات (BOM). فمواصفة RFC 8216 تمنع وجود BOM في قوائم HLS، وبعض المشغّلات القديمة تعرضها كرموز غريبة قبل #EXTM3U.

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

يمكن أن تنتهي الأسطر بحرف سطر جديد (Unix وmacOS) أو بحرف رجوع ثم سطر جديد (Windows)، والمشغّلات تقبل الاثنين. لكن خلطهما في ملف واحد قد يربك الأدوات البسيطة، لذا يحتفظ M3U.Click بالنمط الذي يستخدمه ملفك.

صيغة M3U8 وبث HLS

تستخدم تقنية HTTP Live Streaming أيضاً ملفات .m3u8، وتعرّفها المواصفة RFC 8216. وقائمة HLS تصف بثاً واحداً مقسّماً إلى مقاطع قصيرة، بأسطر مثل #EXT-X-TARGETDURATION و#EXT-X-STREAM-INF، وليست قائمة تختار منها. فإذا كان لديك عنوان HLS، فأضفه كعنصر واحد في قائمتك. وقد صُمّم M3U.Click ليتعرّف على ملفات HLS ويتعامل معها كمصادر بث، لا كقوائم للتحرير.

أنواع الوسائط

عندما يرسل خادم ويب قائمة تشغيل، فإنه يصنّفها بنوع وسائط:

• النوع application/vnd.apple.mpegurl مسجّل لدى IANA لملفات .m3u8 و.m3u؛
• والنوع audio/mpegurl تسمح به أيضاً المواصفة RFC 8216؛
• والنوع audio/x-mpegurl شائع الاستخدام لملفات .m3u.

إذا عرض المتصفح القائمة كنص بدلاً من تنزيلها، فالأرجح أن الخادم يرسلها بنوع نصي عام. احفظ الصفحة أو الملف ثم افتحه في M3U.Click أو في مشغّلك.