Guides·8 min

نوشتهٔ Rawnok Jahan

چگونه یک فهرست پخش M3U را از صفر بسازیم (۲۰۲۶)

تقریباً تمام مطالبی که درباره فایل‌های M3U نوشته شده‌اند، فرض می‌کنند کسی از قبل یک فایل به شما داده است. این راهنما رویکردی متفاوت دارد: چند URL پخش دارید، یا می‌خواهید چند منبع را در یک جا جمع کنید و فهرست پخش را خودتان بسازید.

خبر خوب این است که فایل M3U یک فایل متنی ساده است. می‌توانید آن را در Notepad، TextEdit یا هر ویرایشگری که در اختیار دارید بنویسید و در هر پخش‌کننده‌ای که M3U را می‌خواند، از آن استفاده کنید. به نرم‌افزار خاص، ابزار پولی یا حساب کاربری نیاز ندارید. قالب آن تقریباً از ساده‌ترین قالب‌های فایلی ممکن است.

کل ساختار فایل، از ابتدا تا انتها، همین است.

توضیح صادقانه: Tuneline یک مدیا پلیر برای محتوایی است که خودتان ارائه می‌کنید. این راهنما نشان می‌دهد چگونه با استفاده از منابعی که حق استفاده از آن‌ها را دارید، فهرست پخش بسازید. این برنامه هیچ فهرست یا محتوای اختصاصی‌ای همراه خود ندارد.

فایل M3U در اصل چیست؟

M3U یک فهرست مطالب است، نه یک محفظه. هیچ ویدیو یا صدایی در آن وجود ندارد. این فایل متنی، نام‌ها و نشانی‌ها را فهرست می‌کند و پخش‌کننده آن را از بالا به پایین می‌خواند و بر اساس موارد موجود، یک کتابخانه می‌سازد. (توضیح کامل قالب در اینجا.)

به همین دلیل می‌توانید آن را دستی بنویسید. خبری از ساختار باینری پیچیده، چک‌سام هدر یا فشرده‌سازی نیست. اگر می‌توانید یک URL را تایپ کنید، می‌توانید یک فهرست پخش بسازید.

حداقل فهرست پخش قابل استفاده

ساده‌ترین M3U معتبر، فهرستی از URLهاست که هرکدام در یک خط قرار می‌گیرند:

https://example.com/stream-one.m3u8
https://example.com/stream-two.m3u8

این ساختار واقعاً کار می‌کند و همه پخش‌کننده‌ها آن را بارگذاری می‌کنند. اما استفاده از آن بسیار ناخوشایند است، چون هیچ‌کدام از موارد نام ندارند؛ فقط فهرستی از URLهای خام می‌بینید و نمی‌دانید هرکدام مربوط به چیست.

بنابراین در عمل، همه از M3U توسعه‌یافته استفاده می‌کنند که پیش از هر ورودی، یک خط فراداده اضافه می‌کند:

#EXTM3U
#EXTINF:-1,First Source
https://example.com/stream-one.m3u8
#EXTINF:-1,Second Source
https://example.com/stream-two.m3u8

با رعایت سه قانون، کل قالب را در اختیار دارید:

  1. #EXTM3U در خط اول. این خط به پخش‌کننده می‌گوید «در ادامه منتظر فراداده باش». اگر آن را حذف کنید، بسیاری از پخش‌کننده‌ها به حالت URL خام برمی‌گردند و تمام نام‌هایی را که نوشته‌اید از دست می‌دهند.
  2. #EXTINF: پیش از هر ورودی. عدد بعد از دونقطه، مدت‌زمان را بر حسب ثانیه مشخص می‌کند. برای موارد زنده یا بدون پایان مشخص، از -1 استفاده کنید. بعد از ویرگول، نام نمایشی قرار می‌گیرد.
  3. نشانی در خط بلافاصله بعدی. هر ورودی یک نشانی دارد که باید بلافاصله پس از خط #EXTINF همان ورودی بیاید.

افزودن لوگو، گروه و شناسه راهنما

قالب ساده، فهرستی قابل استفاده در اختیار شما می‌گذارد. چند ویژگی اختیاری می‌توانند آن را به فهرستی خوش‌دست‌تر برای مرور تبدیل کنند. این ویژگی‌ها در خط #EXTINF و پیش از ویرگول قرار می‌گیرند:

#EXTM3U
#EXTINF:-1 tvg-id="source.one" tvg-logo="https://example.com/logo1.png" group-title="News",First Source
https://example.com/stream-one.m3u8
#EXTINF:-1 tvg-id="source.two" tvg-logo="https://example.com/logo2.png" group-title="Sport",Second Source
https://example.com/stream-two.m3u8

هرکدام چه کاربردی دارند:

ویژگیکاربردتنظیم آن ارزش دارد؟
tvg-idاین ورودی را به فید راهنما (EPG) مرتبط می‌کند تا اطلاعات جدول برنامه‌ها با آن هماهنگ شودفقط در صورتی که از راهنما استفاده می‌کنید. در این صورت، این مهم‌ترین ویژگی است.
tvg-logoURL آیکونی که کنار نام نمایش داده می‌شودداشتنش خوب است. URL تصویر باید قابل دسترسی باشد.
group-titleدسته‌ای که این ورودی در آن قرار می‌گیردبله. همین ویژگی است که یک فهرست ساده را به منویی قابل مرور تبدیل می‌کند.
tvg-nameنام جایگزینی که برای تطبیق با راهنما استفاده می‌شودفقط زمانی که tvg-id در دسترس نباشد و پخش‌کننده شما بر اساس نام تطبیق دهد.

group-title بیشترین تأثیر را بر تجربه روزمره شما دارد. پخش‌کننده‌ها نوار کناری دسته‌ها را مستقیماً بر اساس آن می‌سازند؛ بنابراین فهرست پخشی با گروه‌بندی منطقی فوراً قابل پیمایش است، اما فهرستی بدون گروه‌بندی به پیمایش بی‌پایان تبدیل می‌شود. (اطلاعات بیشتر درباره دسته‌بندی فهرست پخش.)

اگر قصد دارید راهنما اضافه کنید، هنگام ساخت فایل tvg-id را درست تنظیم کنید. تطبیق دستی راهنما با فهرست پخش پس از ساخت آن، برای ده‌ها ورودی، واقعاً طاقت‌فرساست. (راهنما چگونه تطبیق داده می‌شود.)

گام‌به‌گام: ساخت فایل

در ویندوز

  1. Notepad را باز کنید. نه Word و نه WordPad؛ به یک ویرایشگر متن ساده و بدون قالب‌بندی نیاز دارید.
  2. فهرست پخش خود را با استفاده از قالب بالا بنویسید.
  3. File → Save As.
  4. گزینه Save as type را روی All Files (*.*) بگذارید. این همان مرحله‌ای است که بیشتر افراد فراموش می‌کنند.
  5. نام فایل را myplaylist.m3u بگذارید و پسوند را هم خودتان وارد کنید.
  6. گزینه Encoding را روی UTF-8 تنظیم کنید.

اگر مرحله ۴ را انجام ندهید، ویندوز بی‌سروصدا فایل را به شکل myplaylist.m3u.txt ذخیره می‌کند و هیچ پخش‌کننده‌ای آن را تشخیص نمی‌دهد.

در macOS

  1. TextEdit را باز کنید.
  2. از مسیر Format → Make Plain Text (⇧⌘T) استفاده کنید. TextEdit در ابتدا در حالت متن غنی باز می‌شود و این حالت فایل را خراب می‌کند.
  3. فهرست پخش خود را بنویسید.
  4. از مسیر File → Save فایل را ذخیره و نام آن را myplaylist.m3u بگذارید.
  5. وقتی macOS پیشنهاد افزودن .txt را داد، گزینه Use .m3u را انتخاب کنید.

در Android یا iOS

ویرایشگرهای متنی گوشی از نظر امکان کنترل پسوند فایل، تفاوت زیادی با هم دارند. معمولاً راحت‌تر است فایل را روی کامپیوتر بنویسید و به گوشی منتقل کنید، یا از ویرایشگری استفاده کنید که بتواند فایل را با پسوند دلخواه ذخیره کند.

کدام پسوند: .m3u یا .m3u8؟

هر دو کار می‌کنند. تفاوت عملی آن‌ها در رمزگذاری متن است:

  • .m3u8 نشان می‌دهد محتوا با UTF-8 رمزگذاری شده است؛ بنابراین نام‌های غیرفارسی، حروف دارای اعراب و خط‌های غیربومی به‌درستی حفظ می‌شوند.
  • .m3u در گذشته معمولاً به رمزگذاری محلی و قدیمی اشاره داشت و بعضی نرم‌افزارهای قدیمی هنوز با آن همین‌طور رفتار می‌کنند.

فایل را با نام .m3u8 و رمزگذاری UTF-8 ذخیره کنید، مگر اینکه دلیل مشخصی برای انجام ندادن آن داشته باشید. همه پخش‌کننده‌های مدرن هر دو نوع را می‌خوانند و با این کار از یک دسته کامل از خطاهای به‌هم‌ریختگی نویسه‌ها جلوگیری می‌کنید. تنها نکته این است که بعضی از برنامه‌های قدیمی تلویزیون فقط .m3u را تشخیص می‌دهند؛ بنابراین اگر دستگاه به‌طور کامل فایل شما را نپذیرفت، تغییر نام پسوند ارزش امتحان کردن دارد.

بارگذاری فهرست پخش

پس از ذخیره فایل، آن را به یک پخش‌کننده بدهید.

در کامپیوتر، بیشتر پخش‌کننده‌ها می‌توانند فایل محلی را مستقیماً باز کنند. در Tuneline در macOS، ویندوز یا لینوکس، گزینه Add Source را انتخاب کنید، فایل محلی را برگزینید و فایل بلافاصله بارگذاری می‌شود.

در گوشی‌ها و تلویزیون‌ها، استفاده از URL به‌جای فایل محلی معمولاً مطمئن‌تر است، چون برنامه‌های موبایل و تلویزیون از مسیرهای دلخواه سیستم فایل جدا هستند. اگر می‌خواهید همین فهرست پخش دست‌ساز را روی تلویزیون هم داشته باشید، فایل را در محلی میزبانی کنید که از طریق HTTPS قابل دریافت باشد و سپس آن را با نشانی‌اش اضافه کنید. (روش تبدیل یک M3U محلی به URL.)

پیش از اینکه یک ساعت برای ساخت دستی فایل وقت بگذارید، این نکته را بدانید: فهرست پخش محلی file:// نمی‌تواند با فضای ابری همگام شود. همگام‌سازی ابری به نشانی‌ای نیاز دارد که از دستگاهی دیگر قابل دسترسی باشد و مسیر موجود روی هارددیسک شخصی شما چنین چیزی نیست. میزبانی فایل به‌صورت URL باعث می‌شود روی تمام دستگاه‌هایی که دارید قابل استفاده باشد.

پنج اشتباهی که فهرست پخش دست‌ساز را خراب می‌کنند

به‌ترتیب تقریبیِ میزان تکرار، این‌ها معمولاً مقصر هستند:

  1. فایل در واقع یک .txt است. ویندوز به‌طور پیش‌فرض پسوندها را پنهان می‌کند؛ بنابراین playlist.m3u.txt در File Explorer به شکل playlist.m3u دیده می‌شود. گزینه View → File name extensions را فعال و بررسی کنید.
  2. #EXTM3U وجود ندارد یا خط اول نیست. وجود یک خط خالی یا نویسه‌ای اضافی پیش از آن باعث می‌شود پخش‌کننده کل فایل را فهرستی از URLهای خام در نظر بگیرد. تمام نام‌هایی که نوشته‌اید ناپدید می‌شوند.
  3. URL مستقیماً در خط بعد از #EXTINF قرار ندارد. وجود یک خط خالی بین این دو، ورودی را از نشانی‌اش جدا می‌کند.
  4. متن غنی به‌جای متن ساده. فایلی که در Word یا حالت پیش‌فرض TextEdit ساخته شود، شامل بایت‌های قالب‌بندی است. فایل روی صفحه درست به نظر می‌رسد، اما هنگام پردازش به داده‌های نامفهوم تبدیل می‌شود.
  5. وجود علامت نقل‌قول هوشمند در یک ویژگی. ویرایشگرهایی که " را به " تبدیل می‌کنند، ویژگی‌هایی تولید می‌کنند که هیچ تجزیه‌کننده‌ای آن‌ها را نمی‌شناسد. این مورد از همه پنهان‌تر است، چون فایل کاملاً درست به نظر می‌رسد. ویرایشگرهای متن ساده چنین کاری نمی‌کنند، اما واژه‌پردازها می‌کنند.

اگر فایل شما بارگذاری می‌شود اما چیزی نشان نمی‌دهد، فهرست بررسی بررسی بارگذاری‌نشدن کانال‌ها را دنبال کنید؛ در این مرحله قالب درست است و مشکل از نشانی‌هاست.

یک الگوی آماده برای کپی‌کردن

#EXTM3U
#EXTINF:-1 tvg-id="example.news" tvg-logo="https://example.com/news.png" group-title="News",Example News
https://example.com/news/index.m3u8
#EXTINF:-1 tvg-id="example.sport" tvg-logo="https://example.com/sport.png" group-title="Sport",Example Sport
https://example.com/sport/index.m3u8
#EXTINF:-1 group-title="Local",Local Recording Folder Stream
http://192.168.1.50:8080/stream

نشانی‌ها را با نشانی‌های خودتان جایگزین کنید، فایل را با نام .m3u8 و رمزگذاری UTF-8 ذخیره کنید تا یک فهرست پخش قابل استفاده داشته باشید.

منابع را از کجا پیدا کنیم؟

این راهنما عمداً فقط قالب فایل را پوشش می‌دهد. اینکه نشانی‌های داخل فایل را از کجا تهیه می‌کنید، پرسش جداگانه‌ای است و پاسخ آن اهمیت دارد.

منابع قانونی که می‌توانید بر اساس آن‌ها فهرست پخش بسازید شامل مدیاسرور خانگی خودتان، دوربین‌ها و انکودرهای شبکه در LAN، فیدهای رایگان و عمومی پخش زمینی و FAST، و هر سرویسی است که در چارچوب اشتراکی که واقعاً در اختیار دارید، یک نشانی به شما ارائه می‌کند. (کانال‌های FAST چیستند و چگونه آن‌ها را اضافه کنیم؟) (پخش از Jellyfin، Plex یا Emby.)

پخش‌کننده ابزاری برای محتوایی است که حق تماشای آن را دارید. ساختن فهرست پخش، منشأ محتوا را تغییر نمی‌دهد.

خلاصه مطلب

  • M3U یک فایل متنی ساده است. Notepad یا TextEdit تمام نرم‌افزاری است که نیاز دارید.
  • ابتدا #EXTM3U، سپس #EXTINF:-1,Name و بلافاصله بعد از آن نشانی قرار می‌گیرد.
  • group-title فهرست را قابل مرور می‌کند؛ tvg-id باعث می‌شود راهنما با آن هماهنگ شود.
  • فایل را با فرمت .m3u8 و کدگذاری UTF-8 ذخیره کنید و ویرایشگر خود را روی حالت متن ساده بگذارید.
  • مهم‌ترین دلیل کار نکردن فایل، این است که در واقع .txt است.

فهرست پخش ساخته‌اید و دنبال جایی برای اجرای آن هستید؟ Tuneline را دانلود کنید — رایگان است، محتوای همراه ندارد و روی macOS، Windows، Linux، iPhone، iPad، Android، Android TV، Google TV و Apple TV اجرا می‌شود.

اشتراک‌گذاری مقاله

The fast fix

Get Tuneline free

A clean, no-account media player for macOS, Windows, Linux, Android, TV, and iOS. Bring your own 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.