Skip to content

OfflineTranslatorPy — a compact offline translator built for developers. 🧠 Smart · 📦 Minimal · 🔐 100% Local Processing

License

Notifications You must be signed in to change notification settings

danialsource/offlinetranslatorpy

Repository files navigation

📚 Offline Translator – English → Persian

Release License Python

A lightweight offline translator with English → Persian support.
Works completely offline, no additional models or internet required.
Supports both CLI and GUI modes with CustomTkinter.


🚀 Features

  • 📝 Translate text offline (English → Persian)
  • 💾 Save translation history in SQLite
  • 🖥️ GUI with CustomTkinter
  • 💻 CLI support for quick translations
  • ⚡ Fast, lightweight, and portable

OfflineTranslator/
├── dist/                        # فایل EXE نهایی
│   └── translator.exe
├── history.db                    # دیتابیس SQLite
├── assets/                       # تصاویر یا فایل‌های اضافی
│   └── preview.png
├── LICENSE                       # لایسنس MIT
├── README.md                     # توضیحات پروژه
├── requirements.txt              # پکیج‌های مورد نیاز (برای توسعه)
├── translator.py                 # کد اصلی (برای توسعه و بازسازی EXE)
└── OfflineTranslator_v1.0.zip    # ZIP آماده ریلیز (فقط شامل EXE)

🎨 Screenshots

Preview

GUI example: type English text → click Translate → get Persian output


🛠️ Installation

1️⃣ Clone the repo:

git clone https://github.com/YourUsername/OfflineTranslator.git
cd OfflineTranslator

2️⃣ Install dependencies:

Copy code
pip install -r requirements.txt

Only CustomTkinter is required since translation uses a built-in dictionary.

💻 Usage CLI Mode

Copy code
python translator.py
Select 1 for CLI mode

Type English text and get Persian translations instantly

GUI Mode

Copy code
python translator.py
Select 2 for GUI mode

Type your English text in the box

Click Translate → get Persian output

💾 History

  • Translations are stored in history.db

  • Automatically created on first run

  • Browse past translations anytime

📦 Release (Windows EXE)

  • Download the EXE ZIP from Releases

  • Extract and run translator.exe

  • Works without Python or any installation

  • Recommended: run EXE in a folder where it can create history.db (e.g., Desktop or Documents)

⚡ Notes

  • Translation uses a built-in dictionary, so not all phrases may be supported

  • Expandable by editing the simple_dict in translator.py

  • Fully offline, lightweight, and easy to distribute

📝 License

MIT License © 2025 danialsource

About

OfflineTranslatorPy — a compact offline translator built for developers. 🧠 Smart · 📦 Minimal · 🔐 100% Local Processing

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages