Themes
Catppuccin
Purple radial background with a central auth card, sidebar icon widgets, now-playing and weather widget
Background
Catppuccin uses a generated radial background.
Use This Theme
Set the theme in ~/.config/veila/config.toml:
theme = "catppuccin"Or from the CLI:
veila theme set catppuccinMinimal Overrides
Override individual settings in the same file:
theme = "catppuccin" # Use the bundled Catppuccin theme
[visuals.outputs]
ui_mode = "single" # Use "all" for the UI on every monitor
[visuals.avatar]
image_path = "/path/to/avatar.jpg" # Avatar image; falls back to ~/.face
[background]
mode = "file" # Wallpaper background
path = "/path/to/wallpaper.jpg" # Wallpaper path
[weather]
enabled = true # Fetch weather
location = "Riga" # Weather location
unit = "celsius" # "celsius" or "fahrenheit"
[visuals.now_playing]
enabled = true # Show media when available
[visuals.clock]
format = "24h" # "24h" or "12h"Unset keys keep the preset defaults. The UI appears on one monitor; all monitors stay locked. Use ui_mode = "all" for the UI everywhere. See Monitor Output.
Fonts
Uses the bundled Geom, Google Sans Flex, and Nunito fonts. See font setup to use a different font.
Preset Reference
Copy this preset to ~/.config/veila/themes/ to create a custom theme.
View full preset
[background]
mode = "radial"
# path = "/path/to/wallpaper.jpg"
color = "#403249"
dim_strength = 0
[background.radial]
center = "#cba6f7"
edge = "#1F1B2E"
center_x = 50
center_y = 50
radius = 80
[battery]
enabled = true
[weather]
enabled = false
[visuals.clock]
format = "24h"
meridiem_font_size = 22
meridiem_x = 6
meridiem_y = 7
font_family = "Geom"
font_weight = 600
color = "rgba(203, 166, 247, 1.0)"
font_size = 90
halign = "center"
valign = "bottom"
x = 0
y = -150
relative_to = "auth"
[visuals.date]
format = "long"
font_family = "Geom"
font_weight = 600
font_size = 18
color = "#94e2d5"
halign = "center"
valign = "bottom"
x = 0
y = -120
relative_to = "auth"
[visuals.input]
placeholder = "Password"
background_color = "rgba(255, 255, 255, 0.04)"
width = 360
height = 54
radius = 10
mask_color = "#ffffff"
font_family = "Google Sans Flex"
font_weight = 400
font_size = 16
halign = "center"
valign = "bottom"
x = 0
y = -30
relative_to = "auth"
[visuals.status]
mode = "inline"
rejected_color = "rgba(255, 213, 213, 0.98)"
pending_color = "rgba(236, 236, 236, 0.88)"
[visuals.eye]
color = "rgba(255, 255, 255, 0.72)"
[visuals.caps_lock]
color = "rgba(255, 255, 255, 0.52)"
[visuals.placeholder]
color = "rgba(255, 255, 255, 0.9)"
[visuals.avatar]
# image_path = "/path/to/avatar.jpg"
radius = 10
size = 360
background_color = "rgba(255, 255, 255, 0.04)"
placeholder_padding = 28
halign = "center"
valign = "center"
x = 0
y = -115
[visuals.username]
enabled = false
font_family = "Google Sans Flex"
font_weight = 400
color = "rgba(255, 255, 255, 0.84)"
font_size = 28
halign = "center"
valign = "center"
x = 0
y = 0
relative_to = "username"
[visuals.keyboard]
background_size = 0
color = "#f5c2e7"
size = 30
halign = "center"
valign = "center"
x = 0
y = 0
relative_to = "keyboard"
[visuals.battery]
background_size = 0
color = "#a6e3a1"
size = 40
halign = "center"
valign = "center"
x = 0
y = 0
relative_to = "battery"
[visuals.weather.icon]
size = 60
opacity = 100
halign = "center"
valign = "center"
x = 0
y = 0
relative_to = "weather_icon"
[visuals.weather.temperature]
font_size = 30
font_family = "Geom"
font_weight = 600
letter_spacing = 0
color = "#f9e2af"
halign = "center"
valign = "center"
x = 0
y = 0
relative_to = "weather_temperature"
[visuals.weather.location]
enabled = false
[visuals.now_playing]
enabled = true
fade_duration_ms = 320
[visuals.now_playing.artwork]
size = 175
radius = 8
opacity = 100
halign = "center"
valign = "center"
x = 0
y = 0
relative_to = "now_playing_artwork"
[visuals.now_playing.artist]
width = 318
color = "#a6e3a1"
font_family = "Google Sans Flex"
font_size = 20
font_weight = 400
halign = "left"
valign = "top"
x = 20
y = 23
relative_to = "now_playing_artist_title"
[visuals.now_playing.title]
width = 600
color = "#74c7ec"
font_family = "Google Sans Flex"
font_size = 23
font_weight = 400
halign = "left"
valign = "bottom"
x = 20
y = -23
relative_to = "now_playing_artist_title"
[visuals.power.poweroff]
enabled = true
background_size = 0
color = "#f38ba8"
size = 40
confirm = true
halign = "center"
valign = "center"
x = 0
y = 0
relative_to = "poweroff"
[visuals.power.reboot]
enabled = true
background_size = 0
color = "#fab387"
size = 40
confirm = true
halign = "center"
valign = "center"
x = 0
y = 0
relative_to = "reboot"
[visuals.power.suspend]
enabled = true
background_size = 0
color = "#b4befe"
size = 40
confirm = true
halign = "center"
valign = "center"
x = 0
y = 0
relative_to = "suspend"
# Auth
[[visuals.backdrop]]
enabled = true
name = "auth"
mode = "solid"
color = "rgba(24, 24, 37, 1.0)"
radius = 20
width = 420
height = 650
halign = "center"
valign = "center"
x = 0
y = 0
z = 0
# OS Nerd Icon
[[visuals.layer]]
enabled = true
name = "os_icon"
kind = "icon"
text = ""
font_family = "Symbols Nerd Font"
font_weight = 700
font_style = "normal"
font_size = 64
color = "#8caaee"
background_color = "rgba(24, 24, 37, 1.0)"
width = 100
height = 100
padding = 16
radius = 20
halign = "center"
valign = "center"
y = -275
x = -290
z = 0
# Keyboard Layout
[[visuals.backdrop]]
name = "keyboard"
mode = "solid"
enabled = true
color = "rgba(24, 24, 37, 1.0)"
radius = 20
width = 100
height = 100
halign = "center"
valign = "center"
y = -150
x = -290
z = 0
# Battery
[[visuals.backdrop]]
name = "battery"
show_when = "battery"
mode = "solid"
enabled = true
color = "rgba(24, 24, 37, 1.0)"
radius = 20
width = 100
height = 100
halign = "center"
valign = "center"
y = -25
x = -290
z = 0
# Poweroff
[[visuals.backdrop]]
enabled = true
name = "poweroff"
mode = "solid"
color = "rgba(24, 24, 37, 1.0)"
radius = 20
width = 100
height = 100
halign = "center"
valign = "center"
y = -225
x = 290
z = 0
# Reboot
[[visuals.backdrop]]
enabled = true
name = "reboot"
mode = "solid"
color = "rgba(24, 24, 37, 1.0)"
radius = 20
width = 100
height = 100
halign = "center"
valign = "center"
y = -100
x = 290
z = 0
# Suspend
[[visuals.backdrop]]
enabled = true
name = "suspend"
mode = "solid"
color = "rgba(24, 24, 37, 1.0)"
radius = 20
width = 100
height = 100
halign = "center"
valign = "center"
y = 25
x = 290
z = 0
# Weather Icon
[[visuals.backdrop]]
name = "weather_icon"
show_when = "weather"
mode = "solid"
enabled = true
color = "rgba(24, 24, 37, 1.0)"
radius = 20
width = 100
height = 100
halign = "center"
valign = "center"
y = 150
x = 290
z = 0
# Weather Temperature
[[visuals.backdrop]]
name = "weather_temperature"
show_when = "weather"
mode = "solid"
enabled = true
color = "rgba(24, 24, 37, 1.0)"
radius = 20
width = 100
height = 100
halign = "center"
valign = "center"
y = 275
x = 290
z = 0
# Now Playing Artwork
[[visuals.backdrop]]
name = "now_playing_artwork"
show_when = "now_playing"
mode = "solid"
enabled = true
color = "rgba(24, 24, 37, 1.0)"
radius = 20
width = 200
height = 200
halign = "center"
valign = "center"
y = 225
x = -340
z = 0
# Now Playing Artist/Title
[[visuals.backdrop]]
name = "now_playing_artist_title"
show_when = "now_playing"
mode = "solid"
enabled = true
color = "rgba(24, 24, 37, 1.0)"
radius = 20
width = 650
height = 100
halign = "center"
valign = "center"
y = 405
x = -115
z = 0To use a wallpaper, set [background].path. Veila selects file mode unless you set another mode.