Purpose: Solving common problems and errors
๐จ Common Issues and Solutions
- Check internet connection - extension requires access to Google Translate API
- Make sure text is selected - select text in email before opening context menu
- Check browser console - open Developer Tools (Ctrl+Shift+J) to view errors
- Reload extension - go back to about:debugging and reload extension
- Reload extension - in about:debugging click "Reload"
- Check language settings - make sure correct translation language is selected in popup
- Reinstall extension - remove and install extension again
- Check permissions - make sure extension has "menus" permission
- Click "Close" button manually - use close button in translation window
- Use Escape key - press Esc for immediate closure
- Check time settings - in popup make sure correct display time is set
- Restart Thunderbird - sometimes restarting application helps
- Check Google Translate access - make sure translate.googleapis.com is accessible
- Check text length - very long texts may exceed API limits
- Try again later - possible temporary Google service issues
- Check firewall - make sure there's no blocking of Google API requests
๐ง Enabling Debugging and Logging
In Thunderbird open about:debugging or press Ctrl+Shift+J
In extensions list find BuxarTranslate and click "Inspect"
In opened developer window go to "Console" tab
Perform translation and review console messages for problem diagnosis
Key log messages:
๐ Common Error Diagnosis
Error 429 - Too Many Requests
Cause: Exceeded Google Translate API request limit
Solution: Wait a few minutes and try again
Error 403 - Forbidden
Cause: API access problems or blocking
Solution: Check internet connection and firewall
Translation loading error
Cause: Missing translation file for selected language
Solution: Check messages.json file presence in _locales
Extension not loading
Cause: Error in manifest.json or version incompatibility
Solution: Check Thunderbird version (should be 78.0+)
๐ Reinstallation Process
Go to Add-ons โ Manage Extensions โ Remove BuxarTranslate
Restart Thunderbird to clear cached data
Install extension again via .xpi file or temporary installation
Test extension operation on a test email
๐ Support and Bug Reports
- Check this documentation for solution to your problem
- Enable logging and provide error messages
- Describe steps to reproduce the problem
- Specify Thunderbird version and operating system