Language Profiles#

Language profiles define preferred audio languages for media files, and tell Sonarr how media files should be upgraded if a more preferred language version becomes available.

sonarr:
  settings:
    profiles:
      language_profiles:
        definitions:
          # Add language profiles here.
          # The name of the block becomes the name of the quality profile.
          Anime:
            upgrades_allowed: true
            upgrade_until: "Japanese"
            # Highest priority quality first, lowest priority goes last.
            languages:
              - "Japanese"
              - "English"
          # Add additional language profiles here as needed.

In Buildarr, language profiles are defined using a dictonary structure. The languages listed in the languages attribute are enabled, and prioritised from first to last (top to bottom). Languages not in this list are not selected for download.

For more information, see this guide from WikiArr.

General configuration#

Configuration parameters for controlling how Buildarr handles language profiles.

delete_unmanaged = False class-attribute instance-attribute #

Automatically delete language profiles not defined in Buildarr.

definitions: Dict[str, LanguageProfile] = {} class-attribute instance-attribute #

Define language profiles to configure on Sonarr here.

If there are no language profiles defined and delete_unmanaged is False, Buildarr will not modify existing language profiles, but if delete_unmanaged is True, Buildarr will delete all existing profiles. Be careful when using delete_unmanaged.

Creating a language profile#

A language profile is defined under the language_profiles block as shown below.

...
  language_profiles:
    definitions:
      Anime: # Name of the language profile
        upgrades_allowed: true
        upgrade_until: "Japanese" # Required if upgrades are allowed
        languages: # Required
          - "Japanese"
          - "English"
upgrades_allowed: bool = False class-attribute instance-attribute #

Enable automatic upgrading if a version of a media file in a more preferred language becomes available.

If disabled, languages will not be upgraded.

upgrade_until: Optional[Language] = None class-attribute instance-attribute #

The highest priority language to upgrade an episode to. Usually this would be set to the highest priority language in the profile.

This attribute is required if upgrades_allowed is set to True.

languages: Annotated[List[Language], Field(min_items=1)] instance-attribute #

The languages episodes are allowed to be in. The order of the list determines priority (highest priority first, lowest priority last).

Use the name of the language in English (e.g. Japanese, not Nihongo or 日本語).

...
  languages:
    - "Japanese"
    - "English"

At least one language must be specified.

Available languages#

These are the available languages that can be selected in a language profile.

  • Arabic
  • Bulgarian
  • Chinese
  • Czech
  • Danish
  • Dutch
  • English
  • Finnish
  • Flemish
  • French
  • German
  • Greek
  • Hebrew
  • Hindi
  • Hungarian
  • Icelandic
  • Italian
  • Japanese
  • Korean
  • Lithuanian
  • Malayalam
  • Norwegian
  • Polish
  • Portuguese
  • Russian
  • Spanish
  • Swedish
  • Turkish
  • Ukrainian
  • Vietnamese