🌍 Help Translate OSR Studio
Make OSR Studio accessible to more users worldwide
Ready to Contribute?
Check out the complete translation guide with detailed instructions
🗣️ Available Languages
OSR Studio is currently available in the following languages:
🤝 How to Contribute
There are two ways to help translate OSR Studio:
📝 Note: All translations are stored as JSON files in src/OsrStudio.Loc/Languages/
. Each language has one file named with its ISO 639-1 language code (e.g., es.json
for Spanish, zh-CN.json
for Simplified Chinese).
Translation Guidelines
- ✅ Keep keys unchanged - Only translate the values
- ✅ Preserve placeholders - Keep {0}, {1} format specifiers
- ✅ Maintain consistency - Use same translations for repeated terms
- ✅ Consider context - Understand where the text appears
- ✅ Keep it concise - Long translations may not fit in the UI
- ✅ Use proper encoding - UTF-8 for all non-Latin scripts
🔧 Technical Details
OSR Studio uses a JSON-based localization system:
- Format: Simple key-value pairs in JSON
- Default Language: English (en.json) serves as fallback
- Runtime Loading: Translations load automatically at startup
- Language Switching: Users can change languages without restart
- Fallback System: Missing translations fall back to English
🎯 Pro Tip: Even partial translations are valuable! If you translate 80% of the strings, users will see your translations with English fallback for the remaining 20%.
❓ Frequently Asked Questions
Can I submit a partial translation?
Yes! Partial translations are welcome. The system automatically falls back to English for missing strings.
How do I know if my language code is correct?
Use standard ISO 639-1 codes. For regional variants, use the format: language-REGION
(e.g., pt-BR
, zh-CN
).
Will my translation be reviewed?
Yes, all translation contributions are reviewed for format correctness and ideally by native speakers in the community.
What if someone else is already translating my language?
Check the open Pull Requests first to avoid duplicate work. You can also comment on existing PRs to collaborate!
🚀 Get Started Today
Your contribution helps make OSR Studio accessible to millions of users worldwide!