e2sub — Live Subtitle Translator

فارسی · English

---

فارسی

Live Subtitle Translator افزونه‌ای برای Enigma2 است که زیرنویس‌های متنی زندهٔ کانال‌های تلویزیونی را به فارسی ترجمه می‌کند.

نسخه ۱.۰.۱ برای این مشخصات آماده شده است:

• Dreambox One UHD
• DreamOS / OpenDreambox 2.6
• معماری arm64
• Python 2.7.13

قابلیت‌ها

• ترجمهٔ زیرنویس متنی DVB/Teletext به فارسی
• ادامهٔ خودکار پس از تعویض کانال
• نمایش زیرنویس اصلی هنگام قطع سرویس ترجمه
• تنظیم رنگ، اندازه، موقعیت، پس‌زمینه، سایه و تأخیر زیرنویس
• پردازش غیرهمزمان بدون مسدودکردن پخش تلویزیون
• لاگ موقت با سقف قطعی ۵۱۲ کیلوبایت

API Key

فایل باید فقط شامل خود API Key باشد:

• Dreambox: /root/apikey.txt
• Vu+، برای توسعهٔ آینده: /home/root/apikey.txt

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

نصب

dpkg -i /tmp/enigma2-plugin-extensions-e2sub_1.0.1_arm64.deb

پس از نصب، فایل e2sub از پوشهٔ /tmp حذف و Enigma2 به‌صورت خودکار ری‌استارت می‌شود.

استفاده

1. از منوی Plugins وارد Live Subtitle Translator شوید.
2. افزونه را فعال کنید.
3. Track را روی Automatic بگذارید یا یک Track متنی انتخاب کنید.
4. با کلید سبز تنظیمات را ذخیره کنید.

نسخهٔ فعلی فقط زیرنویس متنی Teletext/DVB را پشتیبانی می‌کند؛ زیرنویس تصویری DVB/Bitmap هنوز پشتیبانی نمی‌شود.

لاگ افزونه در /tmp/e2sub.log قرار دارد. جزئیات بیشتر در معماری و راهنمای بیلد نوشته شده است.

---

English

Live Subtitle Translator is an Enigma2 plugin that translates live text television subtitles into Persian.

Version 1.0.1 targets Dreambox One UHD, DreamOS/OpenDreambox 2.6, arm64, and Python 2.7.13.

Features

• Persian translation of text DVB/Teletext subtitles
• Automatic continuation after channel changes
• Original-subtitle fallback when translation is unavailable
• Configurable font, color, background, position, shadow, and delay
• Asynchronous processing that does not block television playback
• Volatile log with a strict 512 KiB limit

API key

The file must contain only the API key:

• Dreambox: /root/apikey.txt
• Future Vu+ support: /home/root/apikey.txt

The key is never packaged or removed during uninstallation.

Installation

dpkg -i /tmp/enigma2-plugin-extensions-e2sub_1.0.1_arm64.deb

The installer is removed from /tmp, and Enigma2 restarts automatically.

Usage

1. Open Live Subtitle Translator from the Plugins menu.
2. Enable the plugin.
3. Keep track selection on Automatic, or select a text track.
4. Press the green key to save.

This release supports text Teletext/DVB subtitles only. Bitmap DVB subtitles are not supported yet.

The log is available at /tmp/e2sub.log. See the architecture and build guide for technical details.

Project/channel: routekernel