Update README.md

README.md

@@ -1,4 +1,144 @@
 # Video DownloadHelper Locales
 
-These are all the strings for the Video DownloadHelper addon.
-We accept pull requests!
+Welcome to the Video DownloadHelper localization repository! This is where all the language files for the addon live. Whether you're a fluent speaker wanting to help others in your community, or just someone who loves contributing to open source, you're in the right place!
+
+## 📁 What are these files?
+
+These `.toml` files contain all the text strings that users see when they use Video DownloadHelper. This includes:
+
+- Button labels and menu items
+- Settings and configuration descriptions
+- Error messages and notifications
+- Tooltips and help text
+- All user interface elements
+
+By translating these files, you're helping thousands of users around the world use Video DownloadHelper in their native language!
+
+## 🌐 Current Translation Status
+
+Here's the current status of all language translations. We're always looking for help to add more languages and improve existing ones!
+
+### Status Guide
+
+| Status | Meaning |
+|--------|---------|
+| ✅ Complete | Fully translated and ready to use |
+| ⏳ Not Translated | File exists but needs translation |
+| 📝 Not Started | No file created yet |
+
+
+### Translation Status
+
+| Language | Native Name | Code | Version | Status | File |
+|----------|-------------|------|---------|--------|------|
+| Arabic | العربية | ar | 10.0 | ✅ Complete | [`ar.toml`](./ar.toml) |
+| Bengali | বাংলা | bn | - | ❌ Not Started | - |
+| Bulgarian | български | bg | 10.0 | ⏳ Not Translated | [`bg.toml`](./bg.toml) |
+| Burmese | ဗမာစာ | my | - | ❌ Not Started | - |
+| Catalan | català | ca | 10.0 | ⏳ Not Translated | [`ca.toml`](./ca.toml) |
+| Chinese (Simplified) | 简体中文 | zh-CN | 10.0 | ✅ Complete | [`zh-CN.toml`](./zh-CN.toml) |
+| Chinese (Traditional) | 繁體中文 | zh-TW | 10.0 | ✅ Complete | [`zh-TW.toml`](./zh-TW.toml) |
+| Corsican | corsu | co | 10.0 | ⏳ Not Translated | [`co.toml`](./co.toml) |
+| Croatian | hrvatski | hr | - | ❌ Not Started | - |
+| Czech | čeština | cs | 10.0 | ✅ Complete | [`cs.toml`](./cs.toml) |
+| Danish | dansk | da | 10.0 | ⏳ Not Translated | [`da.toml`](./da.toml) |
+| Dutch | Nederlands | nl | 10.0 | ⏳ Not Translated | [`nl.toml`](./nl.toml) |
+| English | English | en | 10.0 | ✅ Complete | [`en.toml`](./en.toml) |
+| Estonian | eesti | et | - | ❌ Not Started | - |
+| Filipino | Wikang Filipino | fil | - | ❌ Not Started | - |
+| Finnish | suomi | fi | - | ❌ Not Started | - |
+| French | français | fr | 10.0 | ✅ Complete | [`fr.toml`](./fr.toml) |
+| German | Deutsch | de | 10.0 | ✅ Complete | [`de.toml`](./de.toml) |
+| Greek | ελληνικά | el | 10.0 | ⏳ Not Translated | [`el.toml`](./el.toml) |
+| Gujarati | ગુજરાતી | gu | - | ❌ Not Started | - |
+| Hebrew | עברית | he | - | ❌ Not Started | - |
+| Hindi | हिन्दी | hi | - | ❌ Not Started | - |
+| Hungarian | magyar | hu | 10.0 | ⏳ Not Translated | [`hu.toml`](./hu.toml) |
+| Icelandic | íslenska | is | 10.0 | ⏳ Not Translated | [`is.toml`](./is.toml) |
+| Indonesian | Bahasa Indonesia | id | 10.0 | ⏳ Not Translated | [`id.toml`](./id.toml) |
+| Italian | italiano | it | 10.0 | ✅ Complete | [`it.toml`](./it.toml) |
+| Japanese | 日本語 | ja | 10.0 | ✅ Complete | [`ja.toml`](./ja.toml) |
+| Kannada | ಕನ್ನಡ | kn | - | ❌ Not Started | - |
+| Khmer | ខ្មែរ | km | - | ❌ Not Started | - |
+| Korean | 한국어 | ko | 10.0 | ✅ Complete | [`ko.toml`](./ko.toml) |
+| Latvian | latviešu | lv | - | ❌ Not Started | - |
+| Lithuanian | lietuvių | lt | - | ❌ Not Started | - |
+| Lower Sorbian | dolnoserbšćina | dsb | 10.0 | ⏳ Not Translated | [`dsb.toml`](./dsb.toml) |
+| Malay | Bahasa Melayu | ms | - | ❌ Not Started | - |
+| Malayalam | മലയാളം | ml | - | ❌ Not Started | - |
+| Marathi | मराठी | mr | - | ❌ Not Started | - |
+| Nepali | नेपाली | ne | - | ❌ Not Started | - |
+| Norwegian | norsk | no | - | ❌ Not Started | - |
+| Norwegian (Bokmål) | norsk bokmål | nb | 10.0 | ⏳ Not Translated | [`nb.toml`](./nb.toml) |
+| Persian | فارسی | fa | 10.0 | ✅ Complete | [`fa.toml`](./fa.toml) |
+| Polish | polski | pl | 10.0 | ✅ Complete | [`pl.toml`](./pl.toml) |
+| Portuguese | português | pt | - | ❌ Not Started | - |
+| Portuguese (Brazil) | português do Brasil | pt-BR | 10.0 | ✅ Complete | [`pt-BR.toml`](./pt-BR.toml) |
+| Punjabi | ਪੰਜਾਬੀ | pa | - | ❌ Not Started | - |
+| Romanian | română | ro | 10.0 | ⏳ Not Translated | [`ro.toml`](./ro.toml) |
+| Russian | русский | ru | 10.0 | ✅ Complete | [`ru.toml`](./ru.toml) |
+| Serbian | српски | sr | - | ❌ Not Started | - |
+| Sinhala | සිංහල | si | - | ❌ Not Started | - |
+| Slovak | slovenčina | sk | 10.0 | ⏳ Not Translated | [`sk.toml`](./sk.toml) |
+| Slovenian | slovenščina | sl | 10.0 | ⏳ Not Translated | [`sl.toml`](./sl.toml) |
+| Spanish | español | es | 10.0 | ✅ Complete | [`es.toml`](./es.toml) |
+| Swedish | svenska | sv | 10.0 | ⏳ Not Translated | [`sv.toml`](./sv.toml) |
+| Tamil | தமிழ் | ta | - | ❌ Not Started | - |
+| Telugu | తెలుగు | te | - | ❌ Not Started | - |
+| Thai | ไทย | th | - | ❌ Not Started | - |
+| Turkish | Türkçe | tr | 10.0 | ✅ Complete | [`tr.toml`](./tr.toml) |
+| Ukrainian | українська | uk | 10.0 | ✅ Complete | [`uk.toml`](./uk.toml) |
+| Upper Sorbian | hornjoserbšćina | hsb | 10.0 | ⏳ Not Translated | [`hsb.toml`](./hsb.toml) |
+| Urdu | اردو | ur | - | ❌ Not Started | - |
+| Vietnamese | Tiếng Việt | vi | - | ❌ Not Started | - |
+
+
+## 🤝 How Can You Help?
+
+We'd love your help! Here's how you can contribute:
+
+### Adding a New Language
+1. **Fork** this repository to your GitHub account
+2. Create a new file in the `locales/` folder with the name `[language-code].toml`  
+   (for example: `fa.toml` for Persian, `fr.toml` for French)
+3. Copy the contents of `en.toml` as your template
+4. Translate all the strings to your language
+5. Make sure to use **UTF-8 encoding** so special characters display correctly
+6. Submit a **Pull Request** with your new translation
+
+### Improving an Existing Translation
+- Found a mistake in an existing translation?
+- Think a phrase could be translated better?
+- Notice any missing or incorrect strings?
+
+Just fork the repository, make your changes, and submit a pull request!
+
+## 📝 Important Notes for Translators
+
+- **Keep all keys exactly the same** - Only translate the text values, never change the key names
+- **Preserve any placeholders** - Things like `($1)` should stay exactly as they are
+- **Test your translation** - If possible, test how your translation looks in the actual addon
+- **Check character encoding** - Make sure your file is saved as UTF-8
+- **Be consistent** - Try to use the same terms throughout the file
+
+## ✨ Why Your Contribution Matters
+
+Video DownloadHelper is used by people all over the world. When you translate it into your language, you're:
+
+- 🌍 Making the web more accessible to non-English speakers
+- 🤝 Helping your community use technology in their native language
+- 🚀 Improving the experience for thousands of users
+- 💪 Supporting open source software development
+
+## 💬 Need Help?
+
+If you have any questions about translating, feel free to:
+- Open an issue in this repository
+- Ask in your pull request comments
+- Reach out to the maintainers
+
+## 🎉 Thank You!
+
+Every translation, no matter how big or small, makes Video DownloadHelper better for everyone. We truly appreciate your time and effort!
+
+**Ready to start? Pick a language from the table above and submit your pull request today!**