# Internationalization or i18n

# Customize player text

The Backtracks player supports customizing the text of user interface labels and strings. This allows the player's text to match your specific word choice, brand linguistic style, and match the user interface to any language your audiences may use to interact with your content.

# Example of internationalization

Here is an example of internationalizing the UI labels and strings for Spanish (Latin America). In this example, the audio is Spanish language audio with UI labels to match.

# Declarative Example

This is an example of setting some of the strings through the declarative attributes of a player created from a div.

# JavaScript Example

Here is an exmaple of fully internationalizing the UI labels and strings to Spanish (Latin American). Consider this a Spanish language pack for the Backtracks player.

TIP

The default language for player text is English (US) and if you do not override a label or string then the player will fallback to the default value. This allows you to customize only the string and labels that you need to for your use case.

# Customize only a few UI labels

It's possible override only some of the UI labels and strings.

# Language packs

Below are a few language packs that may be utilized. You may of course customize them or provide your own labels and translations.

# Create your own language pack

To create your own language/text overrides pack, just override values for the following phrases or text strings then use the overrides by setting the HTML player attribute data-bt-ui-strings, JavaScript player property uiStrings, or with any of the documented methods on this page.

{
  "comments.input.hint": "Write a comment",
  "controls.download.tooltip": "Download",
  "controls.fullscreen.tooltip": "Fullscreen",
  "controls.info.tooltip": "Info",
  "controls.play.highlight": "Play",
  "controls.settings.tooltip": "Settings",
  "controls.share.tooltip": "Share",
  "controls.subscribe.tooltip": "Subscribe",
  "controls.timeline.tooltip": "Timeline",
  "embed.overlay.dark-theme": "Dark Theme",
  "embed.overlay.light-theme": "Light Theme",
  "embed.overlay.options": "Options",
  "embed.overlay.show-art-cover": "Show Art Cover",
  "embed.overlay.show-transcript": "Show Transcript",
  "embed.overlay.theme": "Theme",
  "embed.overlay.title": "Embed",
  "info.overlay.title": "Info",
  "share.overlay.end-at": "End at",
  "share.overlay.start-at": "Start at",
  "share.overlay.title": "Share",
  "subscribe.overlay.title": "Subscribe",
  "timeline.overlay.title": "Timeline"
}

# French (Français)

{
  "comments.input.hint": "Écrire un commentaire",
  "controls.download.tooltip": "Télécharger",
  "controls.fullscreen.tooltip": "Plein écran",
  "controls.info.tooltip": "Info",
  "controls.play.highlight": "Lecture du fichier audio",
  "controls.settings.tooltip": "Paramètres",
  "controls.share.tooltip": "Partager",
  "controls.subscribe.tooltip": "Souscrire",
  "controls.timeline.tooltip": "Chronogramme",
  "embed.overlay.dark-theme": "Sombre",
  "embed.overlay.light-theme": "Clair",
  "embed.overlay.options": "Options",
  "embed.overlay.show-art-cover": "Afficher la couverture artistique",
  "embed.overlay.show-transcript": "Afficher la transcription",
  "embed.overlay.theme": "Thème",
  "embed.overlay.title": "Intégrer",
  "info.overlay.title": "Info",
  "share.overlay.end-at": "Fin à",
  "share.overlay.start-at": "Commencer à",
  "share.overlay.title": "Partager",
  "subscribe.overlay.title": "Souscrire",
  "timeline.overlay.title": "Chronogramme"
}

# Dutch (Nederlands)

{
  "comments.input.hint": "Een reactie schrijven",
  "controls.download.tooltip": "Downloaden",
  "controls.fullscreen.tooltip": "Volledig scherm",
  "controls.info.tooltip": "Info",
  "controls.play.highlight": "Audio afspelen",
  "controls.settings.tooltip": "Instellingen",
  "controls.share.tooltip": "Delen",
  "controls.subscribe.tooltip": "Abonneren",
  "controls.timeline.tooltip": "Tijdlijn",
  "embed.overlay.dark-theme": "Donker",
  "embed.overlay.light-theme": "Licht",
  "embed.overlay.options": "Opties",
  "embed.overlay.show-art-cover": "Albumhoes tonen",
  "embed.overlay.show-transcript": "Transcript tonen",
  "embed.overlay.theme": "Thema",
  "embed.overlay.title": "Inbedden",
  "info.overlay.title": "Info",
  "share.overlay.end-at": "Eindigen na",
  "share.overlay.start-at": "Beginnen na",
  "share.overlay.title": "Delen",
  "subscribe.overlay.title": "Abonneren",
  "timeline.overlay.title": "Tijdlijn"
}

# German (Deutsche)

{
  "comments.input.hint": "Schreiben Sie einen Kommentar",
  "controls.download.tooltip": "Herunterladen",
  "controls.fullscreen.tooltip": "Vollbild",
  "controls.info.tooltip": "Info",
  "controls.play.highlight": "Audio abspielen", 
  "controls.settings.tooltip": "Einstellungen",
  "controls.share.tooltip": "Teilen",
  "controls.subscribe.tooltip": "Abonnieren",
  "controls.timeline.tooltip": "Zeitachse",
  "embed.overlay.dark-theme": "Dunkel",
  "embed.overlay.light-theme": "Hell",
  "embed.overlay.options": "Optionen",
  "embed.overlay.show-art-cover": "Kunst-Cover anzeigen",
  "embed.overlay.show-transcript": "Transkript anzeigen",
  "embed.overlay.theme": "Thema",
  "embed.overlay.title": "Einbetten",
  "info.overlay.title": "Info",
  "share.overlay.end-at": "Beenden um",
  "share.overlay.start-at": "Beginnen um",
  "share.overlay.title": "Teilen",
  "subscribe.overlay.title": "Abonnieren",
  "timeline.overlay.title": "Zeitachse"
}

# Hindi (हिन्दी)

{
  "comments.input.hint": "कमेंट लिखें",
  "controls.download.tooltip": "डाउनलोड करें",
  "controls.fullscreen.tooltip": "पूरी स्क्रीन",
  "controls.info.tooltip": "जानकारी",
  "controls.play.highlight": "ऑडियो बजाएँ ",
  "controls.settings.tooltip": "सेटिंग",
  "controls.share.tooltip": "शेयर करें",
  "controls.subscribe.tooltip": "सबस्क्राइब करें",
  "controls.timeline.tooltip": "टाइमलाइन",
  "embed.overlay.dark-theme": "डार्क",
  "embed.overlay.light-theme": "लाइट",
  "embed.overlay.options": "विकल्प",
  "embed.overlay.show-art-cover": "आर्ट कवर दिखाएँ",
  "embed.overlay.show-transcript": "ट्रांसक्रिप्ट दिखाएँ",
  "embed.overlay.theme": "थीम",
  "embed.overlay.title": "एम्बेड",
  "info.overlay.title": "जानकारी",
  "share.overlay.end-at": "पर बंद करें",
  "share.overlay.start-at": "पर शुरू करें",
  "share.overlay.title": "शेयर करें",
  "subscribe.overlay.title": "सबस्क्राइब करें",
  "timeline.overlay.title": "टाइमलाइन"
}

# Hebrew (עברית)

{
  "comments.input.hint": "כתיבת הערה",
  "controls.download.tooltip": "הורדה",
  "controls.fullscreen.tooltip": "מסך מלא",
  "controls.info.tooltip": "מידע ",
  "controls.play.highlight": "נגן אודיו", 
  "controls.settings.tooltip": "הגדרות",
  "controls.share.tooltip": "שתף",
  "controls.subscribe.tooltip": "הרשמה",
  "controls.timeline.tooltip": "ציר זמן",
  "embed.overlay.dark-theme": "כהה",
  "embed.overlay.light-theme": "בהיר",
  "embed.overlay.options": "אפשרויות",
  "embed.overlay.show-art-cover": "הצג כיסוי אמנותי",
  "embed.overlay.show-transcript": "הצג תמליל",
  "embed.overlay.theme": "ערכת נושא",
  "embed.overlay.title": "הטמעה",
  "info.overlay.title": "מידע",
  "share.overlay.end-at": "סיים ב-",
  "share.overlay.start-at": "התחל ב-",
  "share.overlay.title": "שתף",
  "subscribe.overlay.title": "הרשמה",
  "timeline.overlay.title": "ציר זמן"
}

# Japanese (日本語)

{
  "comments.input.hint": "コメントを記入",
  "controls.download.tooltip": "ダウンロード",
  "controls.fullscreen.tooltip": "フルスクリーン",
  "controls.info.tooltip": "情報",
  "controls.play.highlight": "音楽を再生", 
  "controls.settings.tooltip": "設定",
  "controls.share.tooltip": "共有",
  "controls.subscribe.tooltip": "登録",
  "controls.timeline.tooltip": "タイムライン",
  "embed.overlay.dark-theme": "ダーク",
  "embed.overlay.light-theme": "ライト",
  "embed.overlay.options": "オプション",
  "embed.overlay.show-art-cover": "アートカバーを表示",
  "embed.overlay.show-transcript": "文字起こしを表示",
  "embed.overlay.theme": "テーマ",
  "embed.overlay.title": "埋め込み",
  "info.overlay.title": "情報",
  "share.overlay.end-at": "終了時間:",
  "share.overlay.start-at": "開始時間:",
  "share.overlay.title": "共有",
  "subscribe.overlay.title": "登録",
  "timeline.overlay.title": "タイムライン"
}

# Korean (한국인)

{
  "comments.input.hint": "댓글 쓰기",
  "controls.download.tooltip": "다운로드",
  "controls.fullscreen.tooltip": "전체화면",
  "controls.info.tooltip": "정보",
  "controls.play.highlight": "오디오 재생",
  "controls.settings.tooltip": "설정",
  "controls.share.tooltip": "공유",
  "controls.subscribe.tooltip": "구독",
  "controls.timeline.tooltip": "타임라인",
  "embed.overlay.dark-theme": "다크",
  "embed.overlay.light-theme": "라이트",
  "embed.overlay.options": "옵션",
  "embed.overlay.show-art-cover": "아트 커버를 표시",
  "embed.overlay.show-transcript": "필기 기록을 표시",
  "embed.overlay.theme": "테마",
  "embed.overlay.title": "포함",
  "info.overlay.title": "정보",
  "share.overlay.end-at": "종료 시각",
  "share.overlay.start-at": "시작 시각",
  "share.overlay.title": "공유",
  "subscribe.overlay.title": "구독",
  "timeline.overlay.title": "타임라인"
}

# Portuguese - Brazil (Português)

{
  "comments.input.hint": "Escrever um comentário",
  "controls.download.tooltip": "Baixar",
  "controls.fullscreen.tooltip": "Tela cheia",
  "controls.info.tooltip": "Info",
  "controls.play.highlight": "Reproduzir áudio",
  "controls.settings.tooltip": "Configurações",
  "controls.share.tooltip": "Compartilhar",
  "controls.subscribe.tooltip": "Inscrever-se",
  "controls.timeline.tooltip": "Linha do tempo",
  "embed.overlay.dark-theme": "Escuro",
  "embed.overlay.light-theme": "Claro",
  "embed.overlay.options": "Opções",
  "embed.overlay.show-art-cover": "Mostrar Arte da Capa",
  "embed.overlay.show-transcript": "Mostrar Transcrição",
  "embed.overlay.theme": "Tema",
  "embed.overlay.title": "Integrar",
  "info.overlay.title": "Info",
  "share.overlay.end-at": "Termina em",
  "share.overlay.start-at": "Começa em",
  "share.overlay.title": "Compartilhar",
  "subscribe.overlay.title": "Inscrever-se",
  "timeline.overlay.title": "Linha do tempo"
}

# Spanish - Latin America (Español)

{
  "comments.input.hint": "Escribir un comentario",
  "controls.download.tooltip": "Descargar",
  "controls.fullscreen.tooltip": "Pantalla completa",
  "controls.info.tooltip": "Info",
  "controls.play.highlight": "Reproducir audio",
  "controls.settings.tooltip": "Ajustes",
  "controls.share.tooltip": "Compartir",
  "controls.subscribe.tooltip": "Suscribirse",
  "controls.timeline.tooltip": "Cronología",
  "embed.overlay.dark-theme": "Oscuro",
  "embed.overlay.light-theme": "Claro",
  "embed.overlay.options": "Opciones",
  "embed.overlay.show-art-cover": "Mostrar portada de arte",
  "embed.overlay.show-transcript": "Mostrar transcripción",
  "embed.overlay.theme": "Tema",
  "embed.overlay.title": "Incrustar",
  "info.overlay.title": "Info",
  "share.overlay.end-at": "Termina a las",
  "share.overlay.start-at": "Comienza a las",
  "share.overlay.title": "Compartir",
  "subscribe.overlay.title": "Suscribirse",
  "timeline.overlay.title": "Cronología"
}

# Swedish (Svenska)

{
  "comments.input.hint": "Skriv en kommentar",
  "controls.download.tooltip": "Ladda ner",
  "controls.fullscreen.tooltip": "Fullskärm",
  "controls.info.tooltip": "Info",
  "controls.play.highlight": "Spela ljud",
  "controls.settings.tooltip": "Inställningar",
  "controls.share.tooltip": "Dela",
  "controls.subscribe.tooltip": "Prenumerera",
  "controls.timeline.tooltip": "Tidslinje",
  "embed.overlay.dark-theme": "Mörk",
  "embed.overlay.light-theme": "Ljus",
  "embed.overlay.options": "Alternativ",
  "embed.overlay.show-art-cover": "Visa konstomslag",
  "embed.overlay.show-transcript": "Visa transkript",
  "embed.overlay.theme": "Tema",
  "embed.overlay.title": "Bädda in",
  "info.overlay.title": "Info",
  "share.overlay.end-at": "Avsluta vid",
  "share.overlay.start-at": "Börja vid",
  "share.overlay.title": "Dela",
  "subscribe.overlay.title": "Prenumerera",
  "timeline.overlay.title": "Tidslinje"
}

# Turkish - (Türk)

{
  "comments.input.hint": "Bir yorum Yaz",
  "controls.download.tooltip": "İndir",
  "controls.fullscreen.tooltip": "Tam ekran",
  "controls.info.tooltip": "Bilgi",
  "controls.play.highlight": "Başlat",
  "controls.settings.tooltip": "Ayarlar",
  "controls.share.tooltip": "Paylaş",
  "controls.subscribe.tooltip": "Abone ol",
  "controls.timeline.tooltip": "Zaman çizelgesi",
  "embed.overlay.dark-theme": "Koyu",
  "embed.overlay.light-theme": "Açık",
  "embed.overlay.options": "Seçenekler",
  "embed.overlay.show-art-cover": "Resim Kapağı Göster",
  "embed.overlay.show-transcript": "Konuşma Metnini Göster",
  "embed.overlay.theme": "Tema",
  "embed.overlay.title": "Yerleştir",
  "info.overlay.title": "Bilgi",
  "share.overlay.end-at": "Bitiş",
  "share.overlay.start-at": "Başlangıç",
  "share.overlay.title": "Paylaş",
  "subscribe.overlay.title": "Abone ol",
  "timeline.overlay.title": "Zaman çizelgesi"
}