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 advanced AI models 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.
• Multi-Provider AI: Supports Google Gemini, OpenRouter, and any Custom OpenAI-compatible endpoint.
• 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. Select LLM Provider: Choose between Google Gemini, OpenRouter, or Custom (OpenAI-compatible).
2. Get & Save your Key:
   • For Google Gemini: Get key from Google AI Studio.
   • For OpenRouter: Get key from OpenRouter Keys.
   • Click Save to store your API key safely.
3. Configure Model & Base URL (Optional): Customize model names (e.g. google/gemini-2.0-flash-001, openai/gpt-4o-mini) or custom endpoint Base URLs.
4. Select Target 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) 📸

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

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

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

📥 دانلود و نصب

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

✨ ویژگی‌ها

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

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

۱. انتخاب ارائه‌دهنده (Provider): از بین گزینه‌های Google Gemini، OpenRouter یا Custom (OpenAI-compatible) انتخاب کنید. ۲. دریافت و ذخیره کلید:

• برای گوگل جمنای: کلید از گوگل AI Studio.
• برای OpenRouter: کلید از کلیدهای OpenRouter.
• کلید را وارد کرده و دکمه Save را بزنید. ۳. تنظیم مدل و آدرس پایه (اختیاری): مدل دلخواه (مانند google/gemini-2.0-flash-001) یا آدرس پایه (Base URL) را تنظیم کنید. ۴. انتخاب زبان: زبان مقصد خود را از منوی کشویی انتخاب کنید. ۵. انتخاب و ترجمه: * دکمه + 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