Transnap 📸

Your intelligent screen translator.

Transnap is a simple yet powerful tool that lets you translate anything on your screen instantly. Whether you're reading a comic, debugging code, or browsing a foreign website, just select the text area, and let Google's Gemini AI handle the rest.

It's designed to be fast, unobtrusive, and easy to use, with a special focus on reading Persian (Farsi) text comfortably.

---

📥 Download & Install

For most users:

1. Go to the Releases page on GitHub.
2. Download the latest Transnap.exe file.
3. Run it! No installation or Python setup is required.

✨ Features

• Instant Snipping: Press Win + Shift + A (default, customizable) to freeze your screen and select any text.
• AI-Powered: Uses the advanced Google Gemini API for natural and accurate translations.
• Multi-Language Support: Translate text into over 50 languages including English, German, French, Spanish, Chinese, Japanese, and more.
• Persian Optimized: full Right-to-Left (RTL) support for a perfect reading experience.

🚀 How to Use

1. Get your Key: You'll need a free API key from Google Gemini. Get it here.
2. Launch Transnap: Open the application (Transnap.exe).
3. Save Key: Enter your API key and click "Save". You only need to do this once!
4. Select Language: Choose your desired target language from the dropdown menu.
5. Snap & Translate:
   • Click + New or press the hotkey (default Win + Shift + A).
   • Drag your mouse to select the text you want to translate.
   • Wait a moment, and the translation will appear in a clean, readable window.
   • Press Esc if you change your mind and want to cancel the snip.
   • Note for Gamers: If the shortcut doesn't work inside a game, click the ⚠ Game Mode button (or run the app as Administrator).

❓ Troubleshooting

Shortcut not working in games? Some games run with high privileges or block external inputs. To fix this:

1. Click the ⚠ Game Mode button in the app toolbar.
2. Or, right-click Transnap.exe and select Run as Administrator.

🤝 Development / Contribution

Only follow these steps if you are a developer and want to modify the code.

1. Install Python 3.x.
2. Clone the repository and navigate to the folder.
3. Install the dependencies:

   pip install -r requirements.txt

4. Run the app:

   python main.py

---

---

ترنسنپ (Transnap) 📸

مترجم هوشمند صفحه نمایش شما.

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

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

📥 دانلود و نصب

برای استفاده عادی: ۱. به بخش Releases (انتشارها) در گیت‌هاب بروید. ۲. آخرین نسخه فایل Transnap.exe را دانلود کنید. ۳. فایل را اجرا کنید! نیازی به نصب پایتون یا هیچ برنامه دیگری نیست.

✨ ویژگی‌ها

• اسکرین‌شات فوری: با فشردن کلیدهای Win + Shift + A (پیش‌فرض، قابل تغییر) صفحه را فریز کنید و متن دلخواهتان را انتخاب نمایید.
• قدرت هوش مصنوعی: استفاده از مدل پیشرفته Google Gemini برای ترجمه‌هایی روان و دقیق.
• پشتیبانی از تمام زبان‌ها: ترجمه متن به بیش از ۵۰ زبان زنده دنیا از جمله انگلیسی، آلمانی، فرانسوی، اسپانیایی، چینی، ژاپنی و ...
• بهینه‌شده برای فارسی: پشتیبانی کامل از چینش راست‌چین (RTL).

🚀 راهنمای استفاده

۱. دریافت کلید: ابتدا یک کلید API رایگان از گوگل جمنای دریافت کنید. لینک دریافت ۲. اجرای برنامه: فایل Transnap.exe را باز کنید. ۳. ذخیره کلید: کلید API خود را وارد کرده و دکمه "Save" را بزنید. (فقط بار اول نیاز است!) ۴. انتخاب زبان: زبان مقصد خود را از منوی کشویی انتخاب کنید. ۵. انتخاب و ترجمه: * دکمه + New را بزنید یا از کلید میانبر (پیش‌فرض Win + Shift + A) استفاده کنید. * با موس کادری دور متن مورد نظر بکشید. * چند لحظه صبر کنید تا ترجمه در پنجره‌ای تمیز و خوانا ظاهر شود. * اگر منصرف شدید، با زدن کلید Esc حالت انتخاب را لغو کنید. * نکته برای گیمرها: اگر کلید میانبر در بازی کار نمی‌کند، دکمه ⚠ Game Mode را بزنید (یا برنامه را به صورت Run as Administrator اجرا کنید).

❓ رفع اشکال

کلید میانبر در بازی کار نمی‌کند؟ برخی بازی‌ها دسترسی‌های سطح بالا دارند و جلوی کلیدهای میانبر را می‌گیرند. برای حل مشکل: ۱. دکمه ⚠ Game Mode را در نوار ابزار برنامه بزنید. ۲. یا روی فایل Transnap.exe کلیک راست کرده و Run as Administrator را انتخاب کنید.

🤝 توسعه و مشارکت

این بخش مخصوص برنامه‌نویسانی است که قصد تغییر در کد برنامه را دارند.

۱. پایتون نسخه ۳ را نصب کنید. ۲. مخزن (Repository) را کلون کنید. ۳. پیش‌نیازها را نصب کنید: bash pip install -r requirements.txt ۴. برنامه را اجرا کنید: bash python main.py