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

• شنیدن صدای سیستم: بدون نیاز به میکروفون، مستقیماً صدای ویندوز را می‌شنود.
• تبدیل گفتار به نوشتار (Offline): استفاده از موتور قدرتمند و آفلاین Vosk.
• ترجمه همزمان: استفاده از مترجم گوگل برای ترجمه متن انگلیسی به فارسی.
• رابط کاربری شناور (Overlay): پنجره‌ای که همیشه روی فیلم یا بازی شما قرار می‌گیرد.
• قابلیت شخصی‌سازی:
  • امکان تغییر شفافیت (Opacity) کادر زیرنویس.
  • امکان نمایش یا مخفی‌سازی متن اصلی (انگلیسی).
  • جابجایی راحت کادر با موس.

ابتدا مطمئن شوید پایتون نصب است. سپس در پوشه پروژه ترمینال را باز کنید و دستور زیر را بزنید:

pip install -r requirements.txt

به طور پیش‌فرض، برنامه‌ها فقط صدای "میکروفون" را می‌شنوند. برای اینکه این برنامه بتواند صدای فیلم یا بازی را بشنود، باید خروجی اسپیکر را به ورودی برنامه هدایت کنیم.

این بهترین و باکیفیت‌ترین روش است.

1. نرم‌افزار رایگان VB-CABLE Driver را دانلود و نصب کنید (بعد از نصب سیستم را ریستارت کنید).
2. در ویندوز به تنظیمات صدا بروید:
   • Settings > System > Sound
3. در بخش Output (خروجی)، دستگاه پخش را روی CABLE Input (VB-Audio Virtual Cable) قرار دهید.
   • نکته: با این کار صدای اسپیکر قطع می‌شود و صدا وارد کابل مجازی می‌شود (که برنامه ما آنجا گوش ایستاده است).
   • اگر می‌خواهید همزمان صدا را خودتان هم بشنوید: باید در تنظیمات Sound Control Panel، روی کابل Recording کلیک راست کنید، Properties را بزنید و در تب Listen گزینه "Listen to this device" را تیک بزنید و اسپیکر اصلی‌تان را انتخاب کنید.

1. در تنظیمات صدای ویندوز به بخش Manage Sound Devices بروید.
2. در بخش Input Devices، گزینه Stereo Mix را پیدا کرده و Enable کنید.

دستور زیر را در ترمینال اجرا کنید:

python main.py

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

• اگر از VB-CABLE استفاده می‌کنید: به دنبال گزینه‌ای بگردید که نامش شامل Line 1 (Virtual Audio Cable) باشد. ⚠️ مهم: ترجیحاً گزینه‌ای را انتخاب کنید که جلوی آن نوشته شده MME (مثلاً گزینه 2 در اکثر سیستم‌ها). پروتکل WDM-KS ممکن است خطا دهد.

• اگر از Stereo Mix استفاده می‌کنید: گزینه Stereo Mix را انتخاب کنید.

بعد از انتخاب دستگاه، یک نوار سیاه رنگ ظاهر می‌شود.

• جابجایی: روی نوار سیاه کلیک چپ کنید و نگه‌دارید تا آن را به جای دلخواه (مثلاً پایین صفحه) ببرید.
• کلیک راست: برای باز شدن منوی تنظیمات کلیک راست کنید:
  • Show English Text: اگر تیک را بردارید، فقط ترجمه فارسی را می‌بینید.
  • Opacity: میزان شفافیت کادر را تنظیم کنید (مناسب برای دیدن پشت زیرنویس).
  • Exit: بستن برنامه.

خطای Unanticipated host error [PaErrorCode -9999]: این خطا یعنی پروتکل انتخابی با درایور صدا ناسازگار است. برنامه را ببندید و دوباره باز کنید و این بار دستگاهی را انتخاب کنید که در نام آن MME یا DirectSound وجود دارد (از انتخاب WASAPI یا WDM-KS برای کابل مجازی خودداری کنید).

متن‌ها ترجمه نمی‌شوند یا خطا می‌دهد: مطمئن شوید به اینترنت متصل هستید (بخش تبدیل صدا به متن آفلاین است، اما ترجمه به فارسی نیاز به اینترنت دارد).