CachyOS Locale and Language - ryzendew/Linux-Tips-and-Tricks GitHub Wiki

CachyOS Locale and Language Guide

Complete beginner-friendly guide to configuring locales and languages on CachyOS, including language settings, input methods, and keyboard layouts.

Table of Contents

  1. Understanding Locales
  2. Setting Locale
  3. Language Configuration
  4. Input Methods
  5. Keyboard Layouts
  6. Troubleshooting

Understanding Locales

What is a Locale?

Locale defines language and regional settings.

What it includes:

  • Language: System language
  • Region: Regional formats
  • Character encoding: Text encoding
  • Date/time format: Date and time display
  • Number format: Number formatting
  • Currency: Currency format

Why configure:

  • Language: Use system in your language
  • Formats: Regional date/number formats
  • Comfort: Better user experience
  • Compatibility: Proper text encoding

Setting Locale

List Available Locales

List locales:

locale -a

What this does:

  • Lists available locales
  • Shows installed locales
  • Helps find your locale

Generate locale:

sudo nano /etc/locale.gen

What this does:

  • Opens locale generation file
  • Uncomment desired locales
  • Enables locale generation

Uncomment locale:

#en_US.UTF-8 UTF-8

Change to:

en_US.UTF-8 UTF-8

Generate locales:

sudo locale-gen

What this does:

  • Generates locales
  • Makes locales available
  • Required for locale use

Set System Locale

Set locale:

sudo localectl set-locale LANG=en_US.UTF-8

What this does:

  • Sets system locale
  • Applies to all users
  • Updates locale configuration

Or edit config:

sudo nano /etc/locale.conf

Add:

LANG=en_US.UTF-8
LC_TIME=en_US.UTF-8
LC_MONETARY=en_US.UTF-8

What this does:

  • Sets locale variables
  • Configures locale settings
  • Applies at boot

Apply changes:

source /etc/locale.conf

Or reboot:

sudo reboot

Language Configuration

Desktop Environment Language

GNOME:

  1. Open Settings
  2. Go to "Region & Language"
  3. Select language
  4. Apply changes

KDE Plasma:

  1. Open System Settings
  2. Go to "Regional Settings"
  3. Select language
  4. Apply changes

XFCE:

  1. Open Settings
  2. Go to "Language"
  3. Select language
  4. Apply changes

Application Language

Set application language:

export LANG=en_US.UTF-8

What this does:

  • Sets language for session
  • Applies to applications
  • Temporary (current session)

Permanent:

  • Add to ~/.bashrc or ~/.zshrc
  • Applies to all sessions
  • Persistent setting

⌨ Input Methods

What are Input Methods?

Input methods allow typing in different languages.

What they do:

  • Non-Latin scripts: Chinese, Japanese, etc.
  • Special characters: Accented characters
  • Complex input: Multi-step input
  • Language support: Multiple languages

Installing Input Methods

Install IBus:

sudo pacman -S ibus ibus-gtk ibus-qt

What this does:

  • Installs IBus input method
  • GTK and Qt support
  • Makes input methods available

Install input method engines:

sudo pacman -S ibus-anthy ibus-mozc ibus-pinyin

What these do:

  • ibus-anthy: Japanese input
  • ibus-mozc: Japanese input (alternative)
  • ibus-pinyin: Chinese input

Start IBus:

ibus-daemon -drx

What this does:

  • Starts IBus daemon
  • Makes input methods available
  • Enables input method switching

Configuring Input Methods

Launch IBus settings:

ibus-setup

What this does:

  • Opens IBus configuration
  • Add input methods
  • Configure input methods

Add input method:

  1. Open IBus settings
  2. Go to "Input Method" tab
  3. Click "Add"
  4. Select input method
  5. Add to list

Switch input method:

  • Default: Super+Space
  • Or: Configure in IBus settings

⌨ Keyboard Layouts

Setting Keyboard Layout

List layouts:

localectl list-keymaps

What this does:

  • Lists available keyboard layouts
  • Shows all layouts
  • Helps find your layout

Set keyboard layout:

sudo localectl set-keymap us

What this does:

  • Sets keyboard layout
  • Applies to system
  • Updates keyboard

Set X11 keyboard:

sudo localectl set-x11-keymap us

What this does:

  • Sets X11 keyboard layout
  • Applies to X11 sessions
  • Updates X11 keyboard

Desktop Environment Keyboard

GNOME:

  1. Open Settings
  2. Go to "Keyboard"
  3. Select layout
  4. Add layouts if needed

KDE Plasma:

  1. Open System Settings
  2. Go to "Input Devices" → "Keyboard"
  3. Select layout
  4. Configure layouts

XFCE:

  1. Open Settings
  2. Go to "Keyboard"
  3. Select layout
  4. Apply changes

Multiple Layouts

Add multiple layouts:

  • Desktop environments support multiple layouts
  • Switch between layouts
  • Useful for multilingual use

Switch layouts:

  • GNOME: Settings → Keyboard → Layouts
  • KDE: System Settings → Keyboard
  • XFCE: Settings → Keyboard

Keyboard shortcut:

  • Usually Super+Space or Alt+Shift
  • Switch between layouts
  • Configure in settings

Troubleshooting

Locale Not Available

Generate locale:

sudo nano /etc/locale.gen

Uncomment locale:

en_US.UTF-8 UTF-8

Generate:

sudo locale-gen

What this does:

  • Generates missing locale
  • Makes locale available
  • Fixes locale issues

Wrong Language

Check current locale:

locale

What this does:

  • Shows current locale settings
  • Verifies configuration
  • Helps identify issues

Set correct locale:

sudo localectl set-locale LANG=correct_locale

What this does:

  • Sets correct locale
  • Updates system language
  • Fixes language issues

Input Method Not Working

Check IBus:

ibus-daemon -drx

What this does:

  • Starts IBus daemon
  • May fix input method issues
  • Enables input methods

Check input method:

ibus list-engine

What this does:

  • Lists installed input methods
  • Verifies installation
  • Helps troubleshoot

Additional Resources

Summary

This guide covered:

  1. Understanding locales - What locales are
  2. Setting locale - Configuring system locale
  3. Language configuration - Setting system language
  4. Input methods - Installing and configuring input methods
  5. Keyboard layouts - Setting keyboard layouts
  6. Troubleshooting - Common locale issues

Key Takeaways:

  • Generate locales in /etc/locale.gen
  • Set locale with localectl
  • Use desktop environment settings for easy configuration
  • Install input methods for non-Latin scripts
  • Configure keyboard layouts for your region
  • Multiple layouts supported for multilingual use
  • Check locale settings if issues occur

This guide is based on the CachyOS Wiki and Arch Linux Wiki and expanded with detailed explanations for beginners. For the most up-to-date locale information, always refer to the official documentation.