doomemacs/modules/ui/doom

:ui doom

• Table of Contents
• Install
  • MacOS
  • Arch Linux
• Configuration
  • Changing fonts
• Troubleshooting
  • Strange font symbols

This module modifies Emacs' user interface.

Doom's look is loosely inspired by Atom's One Dark theme, and is largely contained in the] plugin.

• A colorscheme inspired by Atom's One Dark theme (now available in a separate plugin: doom-themes)
• Uses the Fira Mono and Fira Sans fonts, and DejaVu Sans Mono for unicode symbols.
• A custom folded-region indicator for hideshow
• "Thin bar" fringe bitmaps for git-gutter-fringe
• File-visiting buffers are slightly brighter (powered by solaire-mode)

Table of Contents   TOC

• Install

  • MacOS
  • Arch Linux

• Configuration

  • Changing fonts

• Troubleshooting

  • Strange font symbols

Install

This module optionally depends on:

• The Fira Mono family of fonts
• DejaVu Sans Mono

You don't have to install these if you use a different font.

MacOS

brew tap caskroom/fonts
brew cask install font-fira-{sans,mono} font-dejavu-sans

Arch Linux

sudo pacman --noconfirm --needed -S ttf-fira-{sans,mono} ttf-dejavu

Configuration

Changing fonts

There are four font settings you can change:

:font

the default font.

:big-font

the font to use when doom-big-font-mode is enabled.

:variable-font

the font to use when variable-pitch-mode is active (or where the variable-pitch face is used).

:unicode-font

the font used to display unicode symbols. This is ignored if the :ui unicode module is enabled.

;; These are the defaults of this module
(set! :font "Fira Mono" :size 12)
(set! :big-font "Fira Mono" :size 18)
(set! :variable-font "Fira Sans" :size 12)
(set! :unicode-font "DejaVu Sans Mono" :size 12)

Troubleshooting

Strange font symbols

If you're seeing strange unicode symbols, this is likely because you don't have all-the-icons's font icon installed. You can install them with M-x all-the-icons-install-fonts.