Tranfastic

Lightweight Portable Instant Translator App with GUI

Features . Quick Start . Development . Contributing . Legal . Troubleshooting . Roadmap . License

🇹🇷 Türkçe

Tranfastic is a lightweight Python application designed for instant, real-time translation while you work. It sits discreetly in your system tray, and a quick hotkey opens a window for text input, making translated text readily available for copying or inserting.

✨ Features

• 🔥 Instant Translation: Quick translate with global hotkey (Shift+Alt+D)
• ⚡ Hotkey Activation: Opens translation pop up instantly with a customizable keyboard shortcut.
• 🌐 Multiple Languages: Support for English, Turkish, German, Spanish, Japanese and more.
• 📱 System Tray: Runs quietly in the background.
• 📋 Clipboard Integration: Automatic paste translated text
• 🔧 Configurable: Customizable hotkeys and languages
• 🔄 Auto-Update: Automatic updates
• 🔒 Privacy Focused: Does not store any translation history or sensitive information.
• 🎨 Clean Interface: Minimalist design that doesn't distract from your work.

🚀 Quick Start

📥 Download

Choose your preferred installation method:

🖥️ Windows Installer (Recommended)

1. Download Tranfastic-Setup.exe from Releases
2. Run the installer as administrator
3. Launch from Start Menu or Desktop shortcut

📦 Portable Version

No installation required! Works on any Windows 10/11 machine. Best for trying out the application.

1. Download Tranfastic.exe from Releases
2. Copy to any folder (Desktop, USB drive, etc.)
3. Double-click to run

🎯 How to Use

1. Using the Hotkey:

   • Press Shift+Alt+D (default) or set your preferred hotkey in the settings.

2. Input & Translate:

   • Type or paste text into the pop-up window and press Enter to receive your translation.

3. Close with Ease:

   • Press Esc to quickly close the pop-up window.

🛠️ Development

📦 Installation

1. First, clone the repository:

git clone https://github.com/your-username/Tranfastic.git
cd Tranfastic

2. Setup virtual envoirement

python -m venv venv

# Activate virtual envoirement
./venv/Script/activate

3. Install dependencies:

pip install -r requirements.txt

🏃 Run the Application

1. Start Tranfastic:

python main.py

The Tranfastic icon will appear in your system tray.

🔨 Build Portable Executable

# Clone repository
git clone https://github.com/ysfemreAlbyrk/Tranfastic.git
cd Tranfastic

# Install dependencies
pip install -r requirements.txt

# Build portable executable
./build_portable.bat

The executable will be created in dist/Tranfastic.exe

🐛 Need Help?

Having issues? Check our comprehensive Troubleshooting Guide for solutions to common problems.

🤝 Contributing

We welcome contributions! To contribute:

1. Fork the repository and create a new branch for your feature or bug fix.
2. Test your changes to ensure stability.
3. Submit a pull request, explaining the changes and any added features.

For bug reports, please open an issue with:

• A clear description of the issue.
• Steps to reproduce the problem.
• The logs/[date].log file content (located in the application's directory) if available.

🛠️ Development Roadmap

See our detailed Development Roadmap for planned features, timelines, and how to contribute to Tranfastic's future.

Quick highlights:

• 🔄 Phase 2 (In Progress): User experience improvements and translation history management
• 🚀 Phase 3: Advanced features including OCR, voice input, and multi-API support
• 🤖 Phase 4: AI & machine learning integration (via ollama)
• 🌍 Phase 5: Cross-platform expansion

🙏 Open Source Dependencies

Tranfastic wouldn't be possible without these amazing open source projects:

• googletrans - Google Translate API wrapper that powers our translation engine
• PyQt5 - Cross-platform GUI framework for our modern, responsive interface
• pystray - System tray integration that keeps Tranfastic running silently in the background
• keyboard - Global hotkey detection for instant translation window activation
• Inter Font - Beautiful, modern font family for our clean interface
• Material Symbols - Google's Material Design icons for UI elements
• pywin32 - Windows-specific APIs for seamless Windows integration

📝 License

This project is licensed under the MIT License. See the LICENSE file for details.