🌐 Language Translator.

Try it out here: Translator App on Streamlit.

A command-line based language translator built in Python. This project utilizes the Deep Translator library, allowing users to translate text across multiple languages easily and quickly.

📝 Features

• 50 Supported Languages: Offers a wide variety of languages, categorized for easy selection.
• Simple CLI: Interactive command-line interface for a streamlined user experience.
• Language Detection: Automatically selects the language based on user input.
• Display of Available Languages: Organized into categories for easy navigation.

📚 Language Categories

• European Languages
• Asian Languages
• Slavic Languages
• Nordic and Baltic Languages
• Other Languages

🖥️ Getting Started

These instructions will help you set up and run the project on your local machine.

Prerequisites

• Python installed on your system.
• Deep Translator Library: This project uses the deep-translator library for translation.

Installation

1. Clone the Repository

   git clone https://github.com/miqueasmd/translator.git
   cd translator
   

2. Install Dependencies: Use pip to install the required library

   pip install deep-translator
   

🚀 Usage

1. Run translator.py to launch the program.
2. Enter the text you want to translate.
3. Choose your target language from the displayed list.
4. View the translated text in your chosen language.

📄 Project Structure

• translator.py: Main script for running the translator.
• languages.py: Dictionary of languages supported by the translator.
• app.py: Streamlit application for the translator.
• README.md: Project documentation and setup instructions.

🌍 Supported Languages

The supported languages and their codes are available in languages.py. This allows for future expansions or modifications of supported languages as needed.

🚀 Running the Application with Streamlit

To run the translation application using Streamlit, follow these steps:

1. Install dependencies: Make sure you have streamlit and deep-translator installed. You can install them using pip.

2. Run the application: Navigate to the directory where the app.py file is located and run the appropriate command.

3. Open the application in the browser: Once you run the above command, Streamlit will automatically open a new tab in your browser with the translation application.

4. Using the application:

   • Enter the text you want to translate in the input field.
   • Select the target language from the dropdown menu.
   • Click the "Translate" button to get the translation.

🤝 Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request with any improvements or new features.

How to Contribute:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make changes and commit them with clear messages.  
4. Push your changes to your forked repository.
5. Submit a pull request to the main repository.

🛠️ Future Enhancements

• Additional Libraries: Integrate with other translation libraries for added options.
• Extended Language Options: Add more languages or dialects.
• Batch Translation: Allow users to input multiple texts for translation in one session.

☕ Support Me

If you like my work, consider supporting my studies!

Your contributions will help cover fees and materials for my Computer Science and Engineering studies at UoPeople starting in September 2025.

Every little bit helps—you can donate from as little as $1.