Languages (i18n)

hdds_viewer supports 5 languages with automatic system language detection.

Supported Languages

Automatic Detection

By default, hdds_viewer automatically detects your system language:

1. Checks LANG environment variable

2. Falls back to system locale settings

3. Uses English if no supported language is detected

Manual Language Selection

Via Settings

1. Open Settings panel (Ctrl+,)

2. Navigate to Language section

3. Select desired language from dropdown

Via CLI

# Set language via environment variable
HDDS_VIEWER_LANG=fr hdds-viewer

Or use standard locale
LANG=de_DE.UTF-8 hdds-viewer

Via Config File

Edit ~/.config/hdds-viewer/config.toml:

[appearance]
language = "ja"

Language Files

Translations are embedded in the binary. No external files required.

For Enterprise users with custom translations, files can be placed in:

• Linux: ~/.config/hdds-viewer/i18n/
• macOS: ~/Library/Application Support/HDDS Viewer/i18n/
• Windows: %APPDATA%\HDDS Viewer\i18n\

Translated Elements

All UI elements are translated:

• Menu labels and tooltips
• Panel titles and headers
• Button text and icons
• Error messages and notifications
• Command palette entries
• Settings descriptions
• QoS Advisor rules and recommendations
• AI Assistant prompts

Adding Translations (Enterprise)

Create a TOML file with your translations:

# ~/.config/hdds-viewer/i18n/es.toml
[menu]
file = "Archivo"
edit = "Editar"
view = "Ver"

[panels]
frame_table = "Tabla de Tramas"
topology = "Topología"
timeline = "Línea de Tiempo"

[actions]
capture_start = "Iniciar Captura"
capture_stop = "Detener Captura"

Right-to-Left (RTL) Support

RTL languages (Arabic, Hebrew) are on the roadmap for future releases.

Date and Number Formatting

hdds_viewer respects locale settings for:

• Date formats (DD/MM/YYYY vs MM/DD/YYYY)
• Number separators (1,000.00 vs 1.000,00)
• Time formats (24h vs 12h AM/PM)

Keyboard Shortcuts

Keyboard shortcuts remain consistent across all languages. They are not localized to ensure muscle memory works regardless of language setting.