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 unsetinit 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.tomlApply it by name:
theme = "my-theme"Or via the CLI:
veila theme print my-theme
veila theme set my-themeUse 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 -fvCheck 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
| Limit | Value |
|---|---|
| Distinct family/weight/style requests | 32 |
| Selected font faces | 64 |
| Single font file | 64 MiB |
| Total selected font data | 128 MiB |
| Individual Fontconfig query | 1.5 seconds |
| Font selection budget | 3 seconds |