Consume server-resolved translations for server-provided strings

The frontend kept its own copy of translatable strings for objects the server
provides (config entries, media item names, genres, recommendations, browse
folders) and resolved them locally. The server now resolves these for the
connection locale and sends them already localized, so consume those values
directly and stop resolving the keys client-side.

- Render server-resolved label/description/option title/category_label/name
  instead of looking them up via vue-i18n.
- Send translations/set_locale on connect and on UI language change, then
  refresh state so server-provided strings re-resolve (also covers the Ingress
  path where the auth command is skipped).
- Pre-translate the frontend-only settings entries locally; those stay
  frontend-owned.
- Remove the now-dead server-object keys from the locale files.
- Update getGenreDisplayName tests for the server-resolved behaviour.

Author: marcelveldt

src/App.vue

@@ -402,6 +402,19 @@ onMounted(async () => {
       }
     },
   );
+
+  // Push UI locale changes to the server so server-provided strings (config labels, media/folder
+  // names, provider descriptions) re-localize. Initial/reconnect locale is sent from the api on
+  // ServerInfo; this catches later changes (language preference applied, manual switch).
+  watch(
+    () => i18n.global.locale.value,
+    async (locale) => {
+      await api.setLocale(locale as string);
+      if (api.state.value === ConnectionState.AUTHENTICATED) {
+        await api.fetchState();
+      }
+    },
+  );
   window
     .matchMedia("(prefers-color-scheme: dark)")
     .addEventListener("change", setTheme);

src/components/HomeWidgetRows.vue

@@ -325,10 +325,8 @@ watch(
   },
 );
 
-const folderTitle = (folder: RecommendationFolder) =>
-  folder.translation_key
-    ? $t(`recommendations.${folder.translation_key}`, folder.name)
-    : folder.name;
+// recommendation folder names are resolved server-side for the connection locale
+const folderTitle = (folder: RecommendationFolder) => folder.name;
 
 const folderProvider = (folder: RecommendationFolder) => folder.provider || "";
 

src/components/ItemsListing.vue

@@ -1758,10 +1758,9 @@ const getSortName = function (
   preferSortName = false,
 ) {
   if (!item) return "";
-  if ("translation_key" in item && item.translation_key && item.name)
-    return t(item.translation_key, [item.name]);
-  if ("translation_key" in item && item.translation_key)
-    return t(item.translation_key);
+  // names (incl. translated folder/media names) are resolved server-side; sort by item.name,
+  // falling back to sort_name when explicitly preferred for regular items.
+  if ("translation_key" in item && item.translation_key) return item.name;
   if (preferSortName && "sort_name" in item && item.sort_name)
     return item.sort_name;
   return item.name;

src/helpers/utils.ts

@@ -158,24 +158,13 @@ const genreKeyFromName = function (name: string): string {
 
 export const getGenreDisplayName = function (
   name: string,
-  translationKey: string | undefined,
-  t: (key: string) => string,
-  te: (key: string) => boolean,
+  // translationKey/t/te are no longer used: genre names are resolved server-side for the
+  // connection locale, so the `name` passed in is already the localized display value. The
+  // parameters are kept so the (many) call sites don't all need to change.
+  _translationKey?: string | undefined,
+  _t?: (key: string) => string,
+  _te?: (key: string) => boolean,
 ): string {
-  // First try the translation key as-is (in case backend sends full key like 'genre_names.afrobeats')
-  if (translationKey && te(translationKey)) return t(translationKey);
-
-  // Then try with genre_names prefix (in case backend sends just the key name like 'afrobeats')
-  if (translationKey) {
-    const keyWithPrefix = `genre_names.${translationKey}`;
-    if (te(keyWithPrefix)) return t(keyWithPrefix);
-  }
-
-  // Fallback: generate key from name
-  const key = `genre_names.${genreKeyFromName(name)}`;
-  if (te(key)) return t(key);
-
-  // No translation found - apply sentence case for user-created/promoted genres
   return name;
 };
 

src/plugins/api/index.ts

@@ -2,7 +2,7 @@ import { store } from "../store";
 /* eslint-disable no-constant-condition */
 import { computed, reactive, ref } from "vue";
 import { toast } from "vue-sonner";
-import { $t } from "../i18n";
+import { $t, i18n } from "../i18n";
 import type { ITransport } from "../remote/transport";
 import { WebSocketTransport } from "../remote/websocket-transport";
 import { getDeviceName } from "./helpers";
@@ -2388,13 +2388,32 @@ export class MusicAssistantApi {
     this.serverInfo.value = msg;
     // ServerInfo means transport is connected and server is ready, but not yet authenticated
     this.state.value = ConnectionState.CONNECTED;
+    // declare our UI locale so the server localizes server-provided strings (config labels,
+    // media/folder names, provider descriptions). Handled server-side before the auth gate,
+    // so it also works on the Ingress path where the frontend skips the auth command.
+    void this.setLocale(i18n.global.locale.value);
     this.signalEvent({
       event: EventType.CONNECTED,
       object_id: "",
       data: msg,
     });
   }
 
+  /**
+   * Declare the connection's UI locale to the server (translations/set_locale).
+   *
+   * The server resolves server-provided strings for this locale at serialization. Tolerant of
+   * older servers that do not implement the command.
+   */
+  public async setLocale(locale: string): Promise<void> {
+    if (!locale || locale === "auto") return;
+    try {
+      await this.sendCommand("translations/set_locale", { locale });
+    } catch {
+      // server may predate the set_locale command — ignore
+    }
+  }
+
   /**
    * Signal an event to all registered listeners.
    */

src/plugins/api/interfaces.ts

@@ -561,6 +561,8 @@ export interface ConfigEntry {
   category_translation_key?: string;
   // category_translation_params: optional parameters for the category translation key
   category_translation_params?: string[];
+  // category_label: localized category display name, resolved server-side
+  category_label?: string | null;
   // advanced: indicates this is an advanced setting (hidden by default)
   advanced?: boolean;
 

src/translations/bg_BG.json

@@ -126,73 +126,6 @@
         "radio_in_library": "Радиа в библиотеката",
         "download_log": "Изтегляне на журнал",
         "add_new_provider_button": "Добавяне на {0} доставчик",
-        "log_level": {
-            "label": "Ниво на журнала",
-            "description": "Задайте детайлността на журнала за този доставчик.",
-            "options": {
-                "global": "Глобално",
-                "info": "Информация",
-                "warning": "Предупреждение",
-                "error": "Грешка",
-                "debug": "Отстраняване на грешки"
-            }
-        },
-        "auto_play": {
-            "label": "Автоматично възпроизвеждане (възобновяване при включване на захранването)",
-            "description": "Когато този плейър е включен, автоматично започва да възпроизвежда (ако има елементи в опашката)."
-        },
-        "output_channels": {
-            "description": "Можете да конфигурирате този плейър да възпроизвежда само левия или десния канал, например за да създадете стерео двойка с 2 плейъра.",
-            "options": {
-                "stereo": "Стерео (и двата канала)",
-                "left": "Само ляв канал",
-                "right": "Само десен канал",
-                "mono": "Моно (и двата канала)"
-            }
-        },
-        "volume_normalization": {
-            "label": "Активиране на нормализирането на силата на звука (базирано на EBU-R128)"
-        },
-        "eq_bass": {
-            "label": "Еквалайзер: бас",
-            "description": "Използвайте вградения основен еквалайзер, за да регулирате нивото на баса (ниските тонове) на звука."
-        },
-        "eq_mid": {
-            "label": "Еквалайзер: mid",
-            "description": "Използвайте вградения основен еквалайзер, за да регулирате средното ниво на звука."
-        },
-        "eq_treble": {
-            "label": "Еквалайзер: високи честоти",
-            "description": "Използвайте вградения основен еквалайзер, за да регулирате нивото на treble (високите тонове) на звука."
-        },
-        "crossfade": {
-            "label": "Активиране на плавно преливане",
-            "description": "Активиране на преход с плавно преливане между (опашка) песни."
-        },
-        "crossfade_duration": {
-            "label": "Продължителност на плавното преливане",
-            "description": "Продължителност в секунди на плавното преливане между песните (ако е активирано)"
-        },
-        "hide_player": {
-            "label": "Скриване на този плейър в потребителския интерфейс",
-            "description": "Скриване на този плейър в потребителския интерфейс.\n\nИмайте предвид, че той все още може да се контролира и ще се показва във всички синхронизирани групи, към които принадлежи."
-        },
-        "default_enqueue_select_artist": {
-            "description": "Ако искате се възпроизведе изпълнител, кои елементи трябва да бъдат поставени в опашката?",
-            "options": {
-                "library_album_tracks": "Всички песни от всички албуми в библиотеката"
-            }
-        },
-        "default_enqueue_select_album": {
-            "description": "Ако искате да се възпроизведе албум, кои елементи трябва да бъдат поставени в опашката?"
-        },
-        "default_enqueue_action_radio": {
-            "options": {
-                "play": "Пускане на радиостанцията сега и запазване на останалите елементи от опашката.",
-                "replace": "Изчистване на опашката и пускане на радиостанцията",
-                "add": "Добавете радиостанцията(ите) в края на опашката."
-            }
-        },
         "default": "по подразбиране",
         "provider_depends_on_confirm": "Преди да можете да настроите {0}, трябва да конфигурирате доставчика {1}. Искате ли да го направите сега?",
         "category": {
@@ -203,26 +136,6 @@
             "web_player": "Уеб плейър",
             "options": "Опции на плейъра"
         },
-        "announce_volume_strategy": {
-            "options": {
-                "none": "Да не се регулира силата на звука"
-            }
-        },
-        "announce_volume": {
-            "label": "Сила на звука за обявления"
-        },
-        "announce_volume_min": {
-            "label": "Минимално ниво на звука за обявления",
-            "description": "Силата на звука (регулирането) на обявленията не трябва да пада под това ниво."
-        },
-        "announce_volume_max": {
-            "label": "Максимално ниво на силата на звука за обявления",
-            "description": "Силата на звука (регулирането) на обявленията не трябва да надвишава това ниво."
-        },
-        "icon": {
-            "label": "Икона",
-            "description": "Material design икона за този плейър.\n\nВижте https:\/\/pictogrammers.com\/library\/mdi\/."
-        },
         "theme": {
             "label": "Тема",
             "options": {
@@ -270,20 +183,6 @@
         "no_music_providers": "Няма конфигурирани доставчици на музика",
         "no_music_providers_detail": "Започнете вашето изживяване с Music Assistant, като добавите вашите музикални доставчици.",
         "no_player_providers": "Няма конфигурирани доставчици на плейъри",
-        "volume_normalization_radio": {
-            "label": "Метод за нормализиране на силата на звука, който да се използва за радио потоци",
-            "options": {
-                "disabled": "Деактивирано",
-                "fixed_gain": "Фиксирана корекция на усилването"
-            }
-        },
-        "volume_normalization_tracks": {
-            "label": "Метод за нормализиране на силата на звука, който да се използва за песни",
-            "options": {
-                "disabled": "Деактивирано",
-                "fixed_gain": "Фиксирана корекция на усилването"
-            }
-        },
         "dsp": {
             "disabled_message": "В момента DSP е изключен. Включете го с помощта на превключвателя по-горе",
             "input": "Вход",
@@ -318,9 +217,6 @@
                 "FR": "Д"
             }
         },
-        "volume_control": {
-            "label": "Контрол на силата на звука"
-        },
         "dsp_enabled": "DSP е активиран",
         "dsp_disabled": "DSP е дезактивиран",
         "dsp_note_multi_device_group": {
@@ -661,32 +557,6 @@
     "music_assistant_library": "Библиотека на Music Assistant",
     "select_all_confirmation": "Избиране на всички елементи? Зареждането на всички данни може да отнеме известно време.",
     "this_device": "Това устройство",
-    "recommendations": {
-        "in_progress_items": "Продължете да слушате...",
-        "recommended_new_tracks": "Препоръчани нови песни",
-        "recently_played": "Наскоро възпроизвеждани",
-        "suggested_new_albums_for_you": "Предложени нови албуми за вас",
-        "random_artists": "Случайни изпълнители",
-        "random_albums": "Случайни албуми",
-        "custom_mixes": "Персонализирани миксове",
-        "your_listening_history": "Вашата история на слушане",
-        "popular_albums": "Популярни албуми",
-        "radio_stations_for_you": "Радиостанции за вас",
-        "producers__songwriters": "Продуценти и автори на песни",
-        "new_releases_for_you": "Нови версии за вас",
-        "recent_favorite_tracks": "Наскоро добавени към любими песни",
-        "favorite_playlists": "Любими плейлисти",
-        "favorite_radio_stations": "Любими радиостанции",
-        "listen_again": "Слушайте отново",
-        "recommended": "Препоръчано",
-        "recently_added": "Наскоро добавени",
-        "episodes_recently_added": "Наскоро добавени епизоди",
-        "newest_authors": "Най-новите автори",
-        "newest_episodes": "Най-новите епизоди",
-        "discover": "Откриване",
-        "libraries": "Библиотеки",
-        "library": "Библиотека"
-    },
     "homescreen_edit_enable": "Редактиране на началния екран",
     "homescreen_edit_disable": "Изход от режима за редактиране на началния екран",
     "lyrics_will_appear_soon": "Текстът ще се появи, когато песента започне...",
@@ -912,44 +782,6 @@
     "description": "Описание",
     "genre": "Жанр",
     "genres": "Жанрове",
-    "genre_names": {
-        "asian_music": "Азиатска музика",
-        "bluegrass": "Блуграс",
-        "blues": "Блус",
-        "brazilian_music": "Бразилска музика",
-        "chanson": "Шансон",
-        "childrens_music": "Детска музика",
-        "christmas_music": "Коледна музика",
-        "church_music": "Църковна музика",
-        "classical": "Класическа",
-        "comedy": "Комедия",
-        "country": "Кънтри",
-        "dance": "Денс",
-        "disco": "Диско",
-        "electronic": "Електронна",
-        "experimental": "Експериментална",
-        "folk": "Фолк",
-        "funk": "Фънк",
-        "gangsta_rap": "Гангстерски рап",
-        "hip_hop": "Хип хоп",
-        "industrial": "Индустриална",
-        "jazz": "Джаз",
-        "latin": "Латино",
-        "metal": "Метал",
-        "middle_eastern_music": "Близкоизточна музика",
-        "musical": "Мюзикъл",
-        "pop": "Поп",
-        "punk": "Пънк",
-        "r_b": "R&b",
-        "reggae": "Реге",
-        "rock": "Рок",
-        "salsa": "Салса",
-        "sound_effects": "Звукови ефекти",
-        "soundtrack": "Саундтрак",
-        "tango": "Танго",
-        "waltz": "Валс",
-        "wellness": "Уелнес"
-    },
     "link": "Връзка",
     "link_alias_failed": "Свързването на псевдонима не е успешно",
     "alias_linked_successfully": "Псевдонимът е свързан успешно",