Mediarium
Documentation menu

Docs / Using Mediarium

Languages

Mediarium's screens come in English, Spanish (Español), German (Deutsch), French (Français), Brazilian Portuguese (Português do Brasil) and European Portuguese (Português de Portugal).

Choosing a language

  • Settings > General > App language changes it for the browser you're using, and so does App language in the profile menu. The page reloads in the new language. It only changes the language of the app itself, not the audio or subtitle language.
  • The sign-in page and the first step of setup have the same list, so you can switch before signing in.
  • Until you pick one, Mediarium follows your browser's language when it has a translation, and English otherwise. A browser set to Portuguese from Portugal gets the European Portuguese translation, any other Portuguese the Brazilian one.

The choice is kept per browser, so a phone and a laptop can each use their own language. Dates and numbers follow the language too.

Titles and descriptions in your language

The language for movie and show information is its own choice, apart from the screen language: someone can read Mediarium in English and still want film titles in Portuguese.

  • Pick it under Settings > Info, lists and subtitles > Movie and show info > Language for movie and show info, or in the Connect your services step of setup. There are about thirty languages. If you've set a screen language, a button offers the matching one.
  • It changes the titles, descriptions, genres and posters on Discover, search results and title pages. Where TMDB has no translation of something, you see the English text.
  • Your files and folders always use the English title. The name of a movie folder, the title a release is searched for on your indexers, and the matching of downloads never depend on this setting, so changing it never renames or re-searches anything.
  • Your library lists and the pages of titles already in your library still show the title they were added under (the English one) for now.

What stays in English

  • Messages that come from the server itself: error details, health checks, log lines and the Activity history.
  • Names of other apps and services (Plex, Jellyfin, TMDB, OpenSubtitles…), release names, quality names such as 1080p, and file paths.
  • Button and menu names of other apps' own websites in setup steps (for example where to find a key on TMDB), so they match what you see there.
  • Music and book details: they come from MusicBrainz and Open Library as those services provide them. (Movie and show details can be read in your language: see below.)

Helping with a translation

The text lives in web/src/locales/es.json, de.json, fr.json, pt.json (Brazil) and pt-PT.json (Portugal). Each line pairs the English phrase with its translation:

"Add to library": "Añadir a la biblioteca",
"{n} movies": "{n} películas"
  • Keep the words in braces ({n}, {title}) exactly as they are. They're filled in when the text is shown.
  • A key like "noun|Search" is the same English word used in a different place (here the page title, not the button), so it can be translated differently.
  • A phrase that's missing shows in English, so nothing ever goes blank.
  • npm run i18n (in web/) lists phrases a language doesn't have yet; node tools/i18n-check.mjs --strict fails when any are missing.

In the code, text goes through t('...'), tx('...') (a sentence with a link or bold word inside), plural(n, '{n} file', '{n} files') or tc('context', '...'), always with the English written out in full, never built from pieces.

Corrections and new languages are welcome: open an issue or a pull request on GitHub.

Suggest a change to this page on GitHub

Buy a coffee

Enjoying Mediarium?

It is free and made in spare time. A coffee helps keep it running.

Support on Ko-fi

No account needed. Opens Ko-fi in a new tab. Nothing loads from Ko-fi until you click.