YouTube Persian SRT Overlay geliştiren: Amirhosein

راهنمای استفاده از افزونه زیرنویس SRT برای یوتیوب

این افزونه به شما اجازه می‌دهد فایل‌های .srt را روی ویدئوهای یوتیوب به‌صورت زیرنویس RTL نمایش دهید و تنظیمات ظاهری آن را به دلخواه تغییر دهید.



نصب افزونه

1.‌ روی آیکون ⚙️ در صفحه‌ی about:addons کلیک کنید و “Install Add-on From File…” را انتخاب کنید.
2. فایل my-extension.xpi یا my-extension.zip (پسوند .xpi) را بارگذاری کنید.
3. در صورت نمایش اخطار “This add-on appears to be corrupt”:
- مطمئن شوید که از فایل امضا‌شده (signed XPI) استفاده می‌کنید.
- ساختار ZIP صحیح است (فایل‌ها در ریشهٔ بسته باشند).
- در manifest.json یک شناسه‌ی یکتا (browser_specific_settings.gecko.id) تعریف شده باشد.

نکته: اگر بعد از کلیک روی آیکون افزونه، پنل تنظیمات ظاهر نشد، چند بار دیگر روی آیکون کلیک کنید تا DOM صفحه به درستی مقداردهی شود.

نحوهٔ استفاده

1. به صفحه‌ی ویدئوی یوتیوب بروید.
2. روی آیکون افزونه در نوار ابزار فایرفاکس کلیک کنید.
3. پنل تنظیمات در گوشهٔ بالا-راست داخل قاب ویدئو نمایش داده می‌شود.
4. برای بارگذاری زیرنویس:
5. روی دکمهٔ “انتخاب فایل” کلیک کنید و فایل .srt را انتخاب کنید،
6. یا فایل .srt را مستقیماً روی صفحه بکشید (Drag & Drop).
7. زیرنویس هم‌زمان با پخش ویدئو نمایش داده می‌شود.

تنظیمات پنل

• انتخاب فایل: بارگذاری فایل SRT
• اندازه قلم: تغییر اندازهٔ متن زیرنویس (اسلایدر)
• رنگ متن: انتخاب رنگ زیرنویس
• رنگ پس‌زمینه و شفافیت: تعیین رنگ و میزان شفافیت پشتِ متن
• فاصله از پایین: تنظیم فاصلهٔ زیرنویس از پایین قاب ویدئو (اسلایدر)
• × (بستن): بستن پنل تنظیمات

تمام تنظیمات به‌صورت فوری اعمال شده و در حافظه ذخیره می‌شوند.



رفع مشکل باز نشدن پنل

اگر بعد از کلیک روی آیکون افزونه، پنل نمایش داده نشد:
- چند بار پشت‌سرهم روی آیکون کلیک کنید.
- مطمئن شوید که صفحه‌ی ویدئو کاملاً بارگذاری شده باشد.
- در صورت نیاز صفحه را رفرش (F5) کنید.

این مشکل به دلیل تأخیر در مقداردهی DOM یوتیوب رخ می‌دهد و با چند کلیک یا رفرش رفع می‌شود.