Skip to content

README.md

Latest commit

 

History

History
123 lines (79 loc) · 2.42 KB

README.md

File metadata and controls

123 lines (79 loc) · 2.42 KB

🌍 Python Translator (CLI)

A professional, interactive, and colorful command-line translator built with Python. This project provides a smooth CLI experience with animated typing effects, interactive menus, and support for dozens of languages.

✨ Features

  • 🔤 Translate text between 100+ languages
  • 🎨 Colorful and attractive terminal output (Colorama)
  • ⌨️ Typewriter-style text animation
  • 📜 Interactive and user-friendly menus
  • ⚡ Modern async architecture using AsyncIO
  • 🧩 Clean, modular, and extensible codebase

🧰 Requirements

  • Python 3.8+
  • pip

Required Libraries

pip install colorama googletrans==4.0.0-rc1

⚠️ Note: googletrans==4.0.0-rc1 is recommended for better stability.

🚀 Installation & Run

  1. Clone the repository:
git clone https://github.com/AliSaadatDev/python-translator-cli.git
cd python-translator-cli
  1. Install dependencies:
pip install -r requirements.txt
  1. Run the application:
python main.py

🧭 Usage

  1. After running, a list of supported languages will be displayed
  2. From the main menu, choose Start Translation
  3. Enter the text you want to translate
  4. Enter the target language code (e.g. en, fa, de)
  5. The translated text will be displayed instantly in the terminal

To return to the previous menu, type b.

🌐 Language Code Examples

Language Code
English en
Persian fa
German de
French fr
Japanese ja

The full list of supported languages is available in languages.py.

🗂 Project Structure

.
├── main.py        # Main application logic and menus
├── utils.py       # Helper utilities (typewriter effects, helpers)
├── languages.py   # Language codes and names
├── README.md      # Project documentation

🛠️ Future Improvements

  • Automatic source language detection
  • Save translations to file
  • Support alternative APIs (DeepL, LibreTranslate)
  • File translation support

👤 Author

CREATED_BY
📬 Telegram: t.me/theeeraven

📜 License

This project is licensed under the MIT License. Free to use, modify, and distribute.

⭐ Support

If you find this project useful, please consider giving it a ⭐ on GitHub — it really helps ❤️

Built with 🐍 Python and ❤️