Localization¶

Internationalization with ARB files.

Overview¶

BirdNET Live uses Flutter's built-in localization system with ARB (Application Resource Bundle) files. All user-facing strings are localized — no hardcoded English in widgets.

Supported Languages¶

Language	File	Status
English	`lib/l10n/app_en.arb`	Complete
German	`lib/l10n/app_de.arb`	Complete

Translation Conventions¶

Technical terms kept in English: Point Count, Survey, Session, Live Mode — these are established field terminology and are not translated in the German UI.
Format identifiers kept as-is: WAV, FLAC, CSV, JSON, GPX, Raven Selection Table.
Language names untranslated: "English", "Deutsch", "System" appear as-is in the language picker.
Gain: Kept as "Gain" in both languages (universal audio term).
Settings labels: All setting titles, mode names, color map names, and status messages are localized.
Help text: Written to be taxonomically agnostic ("species" not "bird species", "animal sounds" not "birdsong").

Adding a String¶

Add the key and value to app_en.arb:

"myNewString": "Hello world",
"@myNewString": {
  "description": "Greeting shown on the home screen"
}

Add the translation to app_de.arb:
```
"myNewString": "Hallo Welt"
```
Regenerate (automatic on build, or manually):
```
flutter gen-l10n
```

Use in a widget:

final l10n = AppLocalizations.of(context)!;
Text(l10n.myNewString);

Configuration¶

Localization is configured in l10n.yaml at the project root. Generated files go to lib/l10n/gen/.

Language Settings¶

The app supports separate UI language and species language settings, stored via SharedPreferences.