Skip to Content
Veila
Themes

Overview

Ready-made theme examples you can use as starting points.

Each bundled theme has a preview, override examples, and a full preset.

Using a Theme

Set a theme in config.toml:

theme = "normandy"

Or inspect and switch presets from the CLI:

veila init --theme normandy
veila theme list
veila theme current
veila theme print normandy
veila theme set normandy
veila theme unset

init creates a starter config; --force replaces an existing file. set creates the config if needed and requests a reload. unset removes only the theme selection. Edits preserve comments, ordering, and permissions.

list shows bundled themes, current shows the selected theme and source, and print outputs its TOML. Your config overrides the theme.

Custom Themes

Save a TOML config under ~/.config/veila/themes/ to create a custom theme:

~/.config/veila/themes/
  my-theme.toml
  another-theme.toml

Apply it by name:

theme = "my-theme"

Or via the CLI:

veila theme print my-theme
veila theme set my-theme

Use the filename without .toml. Custom themes override bundled themes with the same name.

Start by copying a bundled preset to ~/.config/veila/themes/my-theme.toml.

Fonts

Bundled fonts: Geom, Google Sans Flex, and Nunito. Themes using other fonts link to their downloads.

To install a downloaded font:

mkdir -p ~/.local/share/fonts
cp ~/Downloads/Japanola.ttf ~/.local/share/fonts/
fc-cache -fv

Check its family name, then use a matching weight and style:

fc-match Japanola
fc-list | rg -i japanola
[visuals.clock]
font_family = "Japanola"
font_weight = 400
font_style = "normal"

Install fontconfig for system fonts and fonts covering your languages. Unsupported characters may show placeholders until a suitable font loads.

Veila uses bundled fallbacks while system fonts load after lock confirmation. Missing, invalid, oversized, or slow fonts keep the fallback; password entry never waits. Previews use the same font selection. Check the lock logs if a font does not appear.

Font loading limits
LimitValue
Distinct family/weight/style requests32
Selected font faces64
Single font file64 MiB
Total selected font data128 MiB
Individual Fontconfig query1.5 seconds
Font selection budget3 seconds

Theme Examples

On this page