{{Header}}
{{Title|title=
Change the System or Browser Language
}}
{{#seo:
|description=How to change the User Interface Language for your Operating System and Tor Browser
|image=Language.png
}}
<div class="mininav">
* [[Language]]
* [[Keyboard Layout]]
</div>
[[File:Language.png|thumb|200px]]
{{intro|
This wiki page provides information on how to change the system language in Kicksecure, as well as how to install additional languages and input methods.
}}
= Introduction =

The system language used in {{project_name_long}} is easily changed. The technical steps are identical to the Debian method because {{project_name_long}} is based on Debian GNU/Linux and Xfce. Users can also refer to Debian or Xfce upstream documentation. It is also easy to change the language in Firefox Browser (see further below). Native English speakers do not need to make any changes.

= System =

These instructions are sourced from the Debian wiki [https://wiki.debian.org/ChangeLanguage ChangeLanguage] and [https://wiki.debian.org/InputMethodBuster InputMethodBuster] entries. In Xfce, it is unnecessary to install additional language packs.

== All Languages ==

{{Box|text=
'''1.''' Open a terminal in {{project_name_workstation_long}}.

{{Open a product ws terminal}}

'''2.''' Check the language environment variable.

Run. <ref>The Debian wiki notes: <blockquote>First, you have to set EnvironmentVariables such as LANG, LANGUAGE, LC_CTYPE, LC_MESSAGES to your local language. Usually LANG (or LC_ALL) is sufficient.</blockquote></ref>

{{CodeSelect|code=
env {{!}} grep LANG
}}

The output should show.

<pre>LANG=en_US.UTF-8</pre>

'''3.''' Determine the code for your language and country.

Before re-configuring the locale to your local language it is necessary to identify the two letter code for your language and country:

* <u>Language</u>: the two-letter ISO 639-1 language code is found in the fourth column (639-1) [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes here]. For example, Japanese is <code>ja</code>, Korean is <code>ko</code>, German is <code>de</code> and so on.
* <u>Country</u>: [https://www.iso.org/obp/ui/#search this website] ("Country Codes") identifies country codes. For example, Japan is <code>JP</code>, Korea is <code>KR</code>, Germany is <code>DE</code> and so on.

It is now possible to combine these codes to determine the language to export. For example, Japanese is <code>ja_JP.UTF-8</code>, Korean is <code>ko_KR.UTF-8</code>, German is <code>de_DE.UTF-8</code> and so on.

'''4.''' Reconfigure locales.

Reconfigure locales with the following command.

{{CodeSelect|code=
sudo dpkg-reconfigure locales
}}

A window will prompt for the preferred the locale(s) to be made available. Select the preferred option(s) with the space bar -- multiple locales can be chosen.

'''5.''' Reboot {{project_name_workstation_short}}.

This is required for the changes to take effect.

'''Figure:''' ''Japanese Locale in {{project_name_short}}''

[[File:Anonwhonixjapanese.png]]

}}

== Fonts ==

Depending on the locale, it may be necessary to install [https://wiki.debian.org/Fonts additional fonts] in {{project_name_workstation_short}} so characters present correctly system-wide

'''1.''' Platform specific notice.

* [[{{project_name_short}}|{{project_name_short}}]]: No special notice.
* [[{{q_project_name_short}}|{{q_project_name_short}}]]: In Template.

'''2.''' Font installation.

* [https://packages.debian.org/stable/fonts/ Debian stable fonts packages].
* TrueType (TTF) and OpenType (OTF) fonts are generally recommended. These packages start with <code>fonts-</code>.
* For Korean fonts, [https://sourceforge.net/p/whonix/discussion/general/thread/fff34595/ forums] contributor previously recommended the following additional packages: <code>fonts-unfonts-core</code> (Korean TrueType fonts) and <code>nabi</code> (Korean X input method). After restarting {{project_name_workstation_short}} and starting nabi, the Korean script should be available system-wide for writing and reading. <ref>
{{CodeSelect|code=
sudo apt install fonts-unfonts-core
}}

{{CodeSelect|code=
sudo apt install nabi
}}</ref>

For example to install Japanese TrueType fonts:

{{CodeSelect|code=
sudo apt update
}}

{{CodeSelect|code=
sudo apt install fonts-ipaexfont
}}

'''Figure:''' ''Japanese Font Installation in {{project_name_short}}''

[[File:Anonwhonixjapanesefont.png]]

== Input Method ==

The <code>ibus</code> package is recommended for languages other than English. As of 2021, this should work by default for the following languages:
<div style="column-count:4;-moz-column-count:4;-webkit-column-count:4">
* English
* Arabic
* Bulgarian
* Catalan; Valencian
* Croatian
* Czech
* Danish
* Dutch; Flemish
* Estonian
* Finnish
* French
* German
* Greek, Modern
* Hebrew
* Hungarian
* Italian
* Japanese
* Korean
* Latvian
* Lithuanian
* Malay
* Mongolian
* Norwegian
* Polish
* Portuguese
* Romanian; Moldavian; Moldovan
* Russian
* Serbian
* Slovak
* Slovenian
* Spanish; Castilian
* Swedish
* Turkish
* Ukrainian
</div>

{{Box|text=
'''1.''' Platform specific notice.

* [[{{project_name_short}}|{{project_name_short}}]]: No special notice.
* [[Qubes|{{q_project_name_short}}]]: In Template.

'''2.''' {{Open a product ws terminal}}

'''3.''' Install <code>ibus</code>.

{{CodeSelect|code=
sudo apt install ibus
}}

'''4.''' Launch <code>ibus-setup</code> ([[Qubes|{{q_project_name_short}}]]: in Template so changes are permanent).

{{CodeSelect|code=
ibus-setup
}}

'''5.''' Add the preferred input method(s).

Multiple language input methods can be selected at this step.

'''Figure:''' ''Input Method Option''

[[File:Ibuslanguageselection.png]]

'''6.''' Select the preferred keyboard shortcut to change the input method.

'''Figure:''' ''Preferred Input Method Shortcut''

[[File:Languageinputshortcut.png]]

'''7.''' Reboot.

* {{project_name_short}}: No special notice.
* {{q_project_name_short}}: Shut down the Template and create a new AppVM based on the modified template.

Reboot {{project_name_workstation_short}}.

{{CodeSelect|code=
reboot
}}

'''8.''' Test the preferred input method(s) functionality.

* Open a terminal in {{project_name_workstation_short}}.
* Use either the language icon on the system tray or the keyboard shortcut to change the input method.
* If the procedure was successful, languages other than English will present correctly.

'''9.''' ''Optional:'' Asian input method(s).

Preliminary tests reveal additional Input Method Engine (IME) packages must be installed for Chinese and Korean functionality; refer to the Debian [https://wiki.debian.org/InputMethodBuster InputMethodBuster] entry for further information. After installation of IME packages, follow steps 3-7.

Be aware that this method seems it does not appear to work for Japanese and Thai. Additional libraries, IME packages or fonts are likely necessary; for instance [https://forums.whonix.org/t/adding-language-support/1757 one {{project_name_short}} user] has reported that [https://www.ubuntubuzz.com/2019/07/mozc-and-fcitx-for-japanese-writings-on-debian-10-buster.html installing <code>fcitx-mozc</code>] allows Japanese input. Readers who successfully configure functional Japanese and Thai input methods are encouraged to edit this wiki entry.
}}

= Firefox =

Using <u>one</u> of the methods below is sufficient to change the language in [https://www.mozilla.org/en-US/firefox/new/ Firefox].

== about:preferences Method ==

# Type <code>about:preferences</code> in the URL bar.
# Scroll down to the languages section and search for the preferred language: <code>Language</code> &rarr; <code>Search for more languages</code>
# Add the preferred language.
# Restart Firefox.

'''Figure:''' ''Firefox Language Selection''

[[File:Torbrowserlanguageselection.png]]

== Mozilla Firefox Language Pack Method ==

https://addons.mozilla.org/en-US/firefox/language-tools/

== Debian Firefox Language Pack Method ==
{{mbox
| type      = notice
| image   = [[File:Ambox_notice.png|40px|alt=Info]]
| text    = <u>Untested</u>. Please test and leave feedback.
}}
Complete these steps in {{project_name_workstation_short}}.

{{Box|text=
'''1.''' Update the package lists.

{{CodeSelect|code=
sudo apt update
}}

'''2.''' Search for available language packs.

{{CodeSelect|code=
apt-cache search firefox-esr-l10n-
}}

'''3.''' Install a language pack.

In the example below, replace <i>-de</i> with the preferred language.

{{CodeSelect|code=
sudo apt install firefox-esr-l10n-de
}}
}}

= See Also =
* [[Keyboard Layout]]

= Footnotes =
{{reflist|close=1}}

{{Footer}}

[[Category:Documentation]]