Language Packs

​

Overview

​

Available Languages

• Arabic (Egypt)
• Armenian
• Bulgarian
• Catalan
• Chinese (Simplified)
• Chinese (Traditional)
• Croatian
• Czech
• Danish
• Dutch
• Finnish
• French
• German
• Greek
• Hebrew
• Hungarian
• Indonesian
• Irish
• Italian
• Japanese
• Korean
• Kurdish (Kurmanji)
• Kyrgyz
• Lithuanian
• Malay
• Norwegian (Bokmål)
• Persian
• Polish
• Portuguese
• Portuguese (Brazilian)
• Romanian
• Russian
• Serbian (Cyrillic)
• Serbian (Latin)
• Slovak
• Slovenian
• Spanish
• Swedish
• Thai
• Turkish
• Ukrainian
• Vietnamese

​

Language File Format

​

File Structure

{
  "_Metadata": {
    "Code": "fr-FR",
    "EnglishName": "French",
    "LocalName": "Français",
    "Author": "Jonas Boumediene",
    "MinVersion": "9.3"
  },
  "Items": {
    "FrmMain.MnuOpenFile": "Ouvrir un fichier…",
    "FrmMain.MnuSave": "Sauvegarder",
    "FrmMain.MnuSaveAs": "Sauvegarder sous…",
    "FrmMain.MnuPrint": "Imprimer…",
    "FrmMain.MnuExit": "Quitter"
  }
}

​

Metadata Section

​

Items Section

• Key: The translation identifier (e.g., FrmMain.MnuOpenFile)
• Value: The translated string in the target language

​

Key Format

• FrmMain.MnuOpenFile - Main form, Open File menu item
• FrmSettings.Nav._General - Settings form, General navigation item
• FrmMain.MnuSave._Success - Main form, Save menu success message
• _.ImageOrderBy._Name - Global constant, sort by name option

​

Translation Categories

​

1. Menu Items

"FrmMain.MnuFile": "Fichier",
"FrmMain.MnuOpenFile": "Ouvrir un fichier…",
"FrmMain.MnuSave": "Sauvegarder",
"FrmMain.MnuPrint": "Imprimer…",
"FrmMain.MnuExit": "Quitter"

​

2. Toolbar Actions

"FrmMain.MnuZoomIn": "Zoomer",
"FrmMain.MnuZoomOut": "Dézoomer",
"FrmMain.MnuRotateLeft": "Pivoter à gauche",
"FrmMain.MnuRotateRight": "Pivoter à droite"

​

3. Settings and Dialogs

"FrmSettings.Nav._General": "Général",
"FrmSettings.Nav._Appearance": "Apparence",
"FrmSettings._Theme": "Thème",
"FrmSettings._DisplayLanguage": "Langue d'affichage"

​

4. Messages and Notifications

"FrmMain.MnuSave._Success": "L'image est enregistrée",
"FrmMain.MnuSave._Error": "Impossible d'enregistrer l'image",
"FrmMain.MnuSave._Confirm": "Êtes-vous sûr de vouloir écraser cette image ?"

​

5. Global Constants

"_._OK": "OK",
"_._Cancel": "Annuler",
"_._Yes": "Oui",
"_._No": "Non",
"_._Save": "Sauvegarder",
"_._Close": "Fermer"

​

6. Tooltips and Descriptions

"FrmCrop.BtnSave._Tooltip": "Sauvegarder l'image",
"FrmCrop.BtnReset._Tooltip": "Réinitialiser la sélection",
"FrmCrop.BtnCopy._Tooltip": "Copier la sélection dans le presse-papiers"

​

Translation Guidelines

​

Best Practices

1. Consistency: Use consistent terminology throughout the translation
2. Context: Consider the UI context when translating
3. Length: Keep translations similar in length to avoid UI layout issues
4. Formality: Maintain appropriate formality level for your language
5. Placeholders: Preserve placeholders like {0}, {1} in the exact same position

​

Special Characters

​

Ellipsis (…)

"FrmMain.MnuOpenFile": "Open file…",
"FrmMain.MnuSaveAs": "Save as…"

​

Placeholders

"FrmMain._OpenWith": "Open with {0}",
"_.ImageInfo._ListCount": "{0} file(s)",
"FrmExportFrames._Exporting": "Exporting frames {0}/{1} \n{2}…"

​

Keyboard Shortcuts

"FrmMain.MnuOpenFile": "Open file… (Ctrl+O)"

​

Special Formatting

• \n - Line break (preserve)
• \r\n - Windows line break (preserve)
• HTML entities if present (preserve)

​

Common Translation Patterns

​

Confirmation Messages

"FrmMain.MnuDelete._Description": "Are you sure you want to delete this file?"

​

Error Messages

"FrmMain.MnuSave._Error": "Unable to save the image"

​

Success Messages

"FrmMain.MnuSave._Success": "The image has been saved"

​

Progress Messages

"FrmMain.MnuSave._Saving": "Saving the image…"

​

Contributing Translations

​

Method 1: Crowdin (Recommended)

​

Getting Started

1. Visit the ImageGlass Crowdin page
2. Create a free Crowdin account or sign in
3. Select your language from the list
4. Start translating strings

​

Translation Workflow

1. Browse Strings: View all translatable strings in the interface
2. Translate: Enter your translation in the text box
3. Review Context: See screenshots and context information
4. Vote: Vote on translations by other contributors
5. Discuss: Use comments to discuss translations with other contributors

​

Crowdin Features

• Translation Memory: Suggests previously translated similar strings
• Machine Translation: Provides suggestions from MT engines
• Glossary: Maintains consistent terminology
• Quality Checks: Identifies potential issues (placeholders, length, etc.)
• Screenshots: Visual context for UI strings

​

Proofreading

• Review and approve translations
• Ensure quality and consistency
• Manage translation discussions

​

Method 2: Manual Translation

​

Step 1: Get the Template

1. Download an existing .iglang.json file as a template
2. Or export strings from Crowdin

​

Step 2: Create Your Language File

1. Copy an existing language file (e.g., French.iglang.json)
2. Rename to your language (e.g., Spanish.iglang.json)
3. Update the metadata section:

{
  "_Metadata": {
    "Code": "es-ES",
    "EnglishName": "Spanish",
    "LocalName": "Español",
    "Author": "Your Name",
    "MinVersion": "9.3"
  },
  "Items": {
    // Your translations here
  }
}

​

Step 3: Translate Strings

"FrmMain.MnuOpenFile": "Abrir archivo…",
"FrmMain.MnuSave": "Guardar",
"FrmMain.MnuExit": "Salir"

​

Step 4: Validate Your File

1. Ensure valid JSON syntax (use a JSON validator)
2. Check all placeholders are preserved
3. Test special characters and encoding (UTF-8)
4. Verify string lengths for UI compatibility

​

Step 5: Test Your Translation

1. Install the language pack (see installation section below)
2. Switch ImageGlass to your language
3. Review all UI elements
4. Check for truncation or layout issues
5. Test with different window sizes

​

Step 6: Submit Your Translation

1. Create a pull request on GitHub
2. Or email the file to: [email protected]
3. Include your name/handle for credits

​

Installing Language Packs

​

Using the UI

1. Open ImageGlass Settings
2. Navigate to Language
3. Click Install new language pack…
4. Select your .iglang.json file
5. The language will appear in the language dropdown
6. Select your language to apply it

​

Using Command Line (igcmd)

igcmd.exe install-languages "C:\path\to\language.iglang.json"

• Per-user: %AppData%\ImageGlass\Languages\
• System-wide: <ImageGlass Install Dir>\Languages\

​

Testing Your Language Pack

1. Install the language pack
2. Open ImageGlass Settings → Language
3. Select your language from the Display language dropdown
4. Restart ImageGlass if needed
5. Navigate through all menus and dialogs
6. Verify translations appear correctly

​

Language Code Reference

​

Translation Tips by Section

​

Main Window (FrmMain)

• File operations (open, save, print)
• Image navigation (next, previous, first, last)
• View options (zoom, rotate, flip)
• Tools and actions

​

Settings Window (FrmSettings)

• Navigation tabs (General, Appearance, Viewer, etc.)
• Settings labels and descriptions
• Button labels
• Help text

​

Tool Windows

• FrmCrop: Crop tool interface
• FrmResize: Resize image dialog
• FrmColorPicker: Color picker tool
• FrmExportFrames: Frame export dialog
• FrmSlideshow: Slideshow controls

​

Global Strings (_.*)

• Button labels (OK, Cancel, Yes, No)
• Common actions (Save, Close, Delete)
• Messages (Error, Warning, Success)

​

Quality Assurance

​

Self-Review Checklist

• All placeholders ({0}, {1}, etc.) preserved
• Ellipsis (…) used consistently for dialogs
• No untranslated strings
• Consistent terminology throughout
• Appropriate formality level
• No grammatical errors
• Text length suitable for UI
• Valid JSON syntax
• UTF-8 encoding without BOM

​

Testing Checklist

• Language installs successfully
• Language appears in dropdown
• All menu items translated
• All dialogs translated
• No text truncation
• No layout issues
• Special characters display correctly
• Keyboard shortcuts work

​

Updating Existing Translations

• New features are added to ImageGlass
• New strings are introduced
• Existing translations need improvement

​

Update Process

1. Check Crowdin for new strings in your language
2. Translate any missing strings
3. Review and improve existing translations
4. Submit updates via Crowdin or pull request

​

Version Compatibility

• If new strings are added, update MinVersion
• Older ImageGlass versions will fall back to English for missing strings

​

Community and Support

​

Getting Help

• Crowdin Discussions: Ask questions in the Crowdin project
• GitHub Issues: Report translation issues on GitHub
• Email: Contact [email protected]

​

Translation Credits

• The application About dialog
• The GitHub repository
• Release notes

​

Join the Community

• Become a translator on Crowdin
• Help review and improve translations
• Assist other translators
• Test language packs before release

​

Exporting Language Packs

1. Open ImageGlass Settings → Language
2. Click Export language pack…
3. Save the .iglang.json file
4. Share with others or submit as contribution

​

Technical Details

​

File Encoding

​

JSON Validation

• JSONLint
• VS Code with JSON validation
• Online JSON validators

​

File Size

• Compressed: ~30-50 KB
• Uncompressed: ~30-50 KB (JSON text)

• Missing translations (smaller)
• Encoding issues (larger)
• Formatting issues

​

Best Practices Summary

1. Use Crowdin for easy collaboration and quality checks
2. Stay consistent with terminology and style
3. Test thoroughly before submitting
4. Preserve formatting and special characters
5. Consider context when translating
6. Respect length to avoid UI issues
7. Communicate with other translators
8. Update regularly as new strings are added

​

Resources

• ImageGlass Crowdin Project
• GitHub Repository
• Contributing Guidelines
• Existing language files: Setup/Assets/Language/ in source code

​

FAQ

​

Can I create a translation for a language variant?

​

How do I update an existing translation?

​

What if my translation is too long for the UI?

​

Can I translate the documentation too?

​

How long until my translation is included?

​

Thank You!