Arch Linux Font Improvement Guide

Table of Contents

• Synopsis
  • Disclaimer
• Improving Font Rendering and Compatibility on Arch Linux
  • Step 1: Install Recommended Fonts
    • Recommended fonts
    • Optional but highly recommended fonts
    • Available on the AUR
    • Popular Monospaced Fonts
  • Step 2: Create XML Configuration File
    • Example XML file
  • Step 3: Disable Bitmap Fonts
  • Step 4: Configure X11 Settings (Only for X11)
  • Step 5: Create Symbolic Links
  • Step 6: Edit freetype2.sh File
  • Step 7: Refresh Font Cache
  • Step 8: Reboot
• Sources
• License

Synopsis

After installing Arch Linux, you may wonder why the fonts in Arch Linux look so bland compared to Windows and macOS. The reason is that out of the box, Arch Linux doesn't implement many font rendering techniques to make the fonts look clear and legible. Essentially, there isn't much happening behind the scenes, so the text appears rather plain. Additionally, some apps or websites may display tofu (□) due to missing font support. Fortunately, these issues are relatively easy to fix, and this guide will discuss the solutions.

Example of Tofu

Disclaimer

The following tweaks should work fine for most people, but as with anything in life, results may vary. If you need further assistance, feel free to leave a comment or consult the Arch Wiki. Furthermore, if you wish not to have any emoji support, be sure to ignore packages ending in or containing the word "emoji" and remove them if present.

Side Note: these tips were created specifically for Arch Linux, but they should work for other Linux distributions with slight modifications. If something doesn't work for your particular distro, please use your distro's official documentation or support forum(s).

Improving Font Rendering and Compatibility on Arch Linux

Step 1: Install Recommended Fonts

Download and install the recommended fonts.

Tip: If the fonts are not available in the main repositories, check the AUR.

Recommended fonts

sudo pacman -S noto-fonts
sudo pacman -S noto-fonts-cjk
sudo pacman -S noto-fonts-emoji
sudo pacman -S noto-fonts-extra

Optional but highly recommended fonts

sudo pacman -S ttf-liberation
sudo pacman -S ttf-dejavu
sudo pacman -S ttf-roboto

Available on the AUR

paru -S ttf-symbola

Popular Monospaced Fonts

sudo pacman -S ttf-jetbrains-mono
sudo pacman -S ttf-fira-code
sudo pacman -S ttf-hack
sudo pacman -S adobe-source-code-pro-fonts

Step 2: Create XML Configuration File

Create a local or global XML file to apply font rendering effects.

Global directory: /etc/fonts/local.conf

Per user directory: XDG_CONFIG_HOME/fontconfig/fonts.conf

Example XML file

Side note: Please make sure to include fallback fonts and address other necessary criteria, as this XML file is minimal and may not cover all potential use cases. Furthermore, this XML file adds emoji support to many apps (including the terminal) so feel free to modify the XML file if you don't need certain features.

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd">
<fontconfig>
  <!-- Apply text rasterization, hinting, and anti-aliasing -->
  <match target="font">
    <edit name="antialias" mode="assign">
      <bool>true</bool>
    </edit>
    <edit name="hinting" mode="assign">
      <bool>true</bool>
    </edit>
    <edit name="rgba" mode="assign">
      <const>rgb</const>
    </edit>
    <edit name="hintstyle" mode="assign">
      <const>hintslight</const>
    </edit>
    <edit name="lcdfilter" mode="assign">
      <const>lcddefault</const>
    </edit>
  </match>
  <!-- Configure default fonts & fallback fonts -->
  <!-- Replace fonts with preferred fonts -->
  <!-- Noto Emoji allows for emojis to render in all apps including the terminal, remove if not needed  -->
  <alias>
    <family>serif</family>
    <prefer>
      <family>Noto Serif</family>
      <family>Noto Color Emoji</family>
      <family>Noto Emoji</family>
    </prefer>
  </alias>
  <alias>
    <family>sans-serif</family>
    <prefer>
      <family>Noto Sans</family>
      <family>Noto Color Emoji</family>
      <family>Noto Emoji</family>
    </prefer>
  </alias>
  <alias>
    <family>sans</family>
    <prefer>
      <family>Noto Sans</family>
      <family>Noto Color Emoji</family>
      <family>Noto Emoji</family>
    </prefer>
  </alias>
  <alias>
    <family>monospace</family>
    <prefer>
      <family>JetBrainsMono</family>
      <family>Noto Mono</family>
      <family>Noto Color Emoji</family>
      <family>Noto Emoji</family>
    </prefer>
  </alias>
  <alias>
    <family>mono</family>
    <prefer>
      <family>JetBrainsMono</family>
      <family>Noto Mono</family>
      <family>Noto Color Emoji</family>
      <family>Noto Emoji</family>
    </prefer>
  </alias>
</fontconfig>

Step 3: Disable Bitmap Fonts

Bitmap fonts are used as fallbacks for some fonts. This can lead to some very blurry, pixelated, or abnormally large fonts. Some users have reported Microsoft fonts being affected by this, and therefore it's recommended for users to disable bitmap fonts on a per font basis or globally. Be careful with disabling it globally as it may break some fonts (additional testing is required). According to the Arch Wiki, users may use the 70-no-bitmaps.conf preset to disable this behavior or use an XML file instead.

Path: ~/.config/fontconfig/conf.d/20-no-embedded.conf

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd">
<fontconfig>
  <match target="font">
    <edit name="embeddedbitmap" mode="assign">
      <bool>false</bool>
    </edit>
  </match>
</fontconfig>

Note: This excerpt was taken directly from the Arch Wiki so all credit goes to the Arch Wiki and all of its contributors.

Step 4: Configure X11 Settings (Only for X11)

Install xorg-xrdb (if needed).

sudo pacman -S xorg-xrdb

Edit the ~/.Xresources file OR create one if not present.

Tip: Backup the file just in case.

vim ~/.Xresources

Tip: Replace vim with your preferred text editor.

Add the following lines to that file and save changes.

Xft.lcdfilter: lcddefault
Xft.hintstyle: hintslight
Xft.hinting: 1
Xft.antialias: 1
Xft.rgba: rgb

Run this command when finished.

xrdb -merge ~/.Xresources

Step 5: Create Symbolic Links

Create required symbolic links for text rendering effects to work:

sudo ln -s /usr/share/fontconfig/conf.avail/10-sub-pixel-rgb.conf /etc/fonts/conf.d/
sudo ln -s /usr/share/fontconfig/conf.avail/10-hinting-slight.conf /etc/fonts/conf.d/
sudo ln -s /usr/share/fontconfig/conf.avail/11-lcdfilter-default.conf /etc/fonts/conf.d/

Step 6: Edit freetype2.sh File

Edit the freetype2.sh file.

sudo vim /etc/profile.d/freetype2.sh

Uncomment the following line from the file.

export FREETYPE_PROPERTIES="truetype:interpreter-version=40"

Step 7: Refresh Font Cache

Refresh the font cache files by running the following command.

sudo fc-cache -fv

Step 8: Reboot

Reboot your PC and enjoy better-looking fonts! 😁

Sources

https://wiki.archlinux.org/title/Font_configuration

https://wiki.manjaro.org/index.php/Improve_Font_Rendering

License

Attribution-NonCommercial-ShareAlike 4.0 International