Text Translator for NVDA

Overview

Text Translator is an NVDA (NonVisual Desktop Access) add-on that provides a comprehensive graphical interface for translating text and text files using Google Translate. Designed with accessibility in mind, this tool enables NVDA users to easily translate text between numerous languages directly within their screen reader environment.

Usage

Opening the Translator

There are two ways to open the Text Translator:

1. Keyboard Shortcut: Press NVDA+Alt+T (NVDA key + Alt + T)
2. System Tray Menu:
3. Navigate to the NVDA system tray icon
4. Go to Tools → Text Translator

Using the Interface

1. Enter Text: Type or paste text into the main text area
2. Load from File: Click "Attach Text File" to load text from a .txt file
3. Select Languages:
4. Source Language: Choose the language of your text, or select "Auto Detect"
5. Target Language: Choose the language you want to translate to
6. Translate: Click "Translate with Google" to begin translation
7. Save Results: After translation, you can save the result to a text file

Language Codes

The add-on supports comprehensive language codes including: - Common languages: en (English), es (Spanish), fr (French), de (German), zh-CN (Simplified Chinese) - Regional languages: ckb (Kurdish Sorani), or (Odia), sat (Santali) - Full list available in the language dropdown menus

common errors

• "Translation error": Network or service issue
• "Error reading file": File encoding or access problem
• "Error saving file": Permission or path issue

Building from Source

1. Clone the repository: bash git clone https://github.com/blindtechvisionary/text-translator-nvda-addon.git

2. Install dependencies (if any)

3. Package using NVDA's add-on template tools

Contributing

Contributions are welcome! Please: 1. Fork the repository 2. Create a feature branch 3. Submit a pull request with clear description of changes

License

This add-on is distributed under the GNU General Public License v2.0. See the license on gnu.org for complete license terms.

Support

• Issues: Report bugs on the GitHub Issues page
• Questions: Use GitHub Discussions for general questions
• Contributions: Pull requests and translations welcome

Version History

v1.0 (Initial Release)

• Basic translation functionality
• File attachment support
• 130+ language support
• NVDA integration with keyboard shortcut
• Save to file capability

Acknowledgments

• NVDA community for the development framework
• Google Translate for the translation service
• Contributors and testers

Disclaimer

This add-on uses Google Translate services. Please respect Google's Terms of Service and API usage limits. The developers are not responsible for translation accuracy or service availability.