Themes
Default
Centered clock, avatar, and rounded input. Clean and minimal - the out-of-the-box look.
Background
Default uses a generated radial background.
Use This Theme
Set the theme in ~/.config/veila/config.toml:
theme = "default"Or from the CLI:
veila theme set defaultMinimal Overrides
Override individual settings in the same file:
theme = "default" # Use the bundled Default 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"
color = "#413249"
dim_strength = 0
[background.radial]
center = "#373057"
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(255, 255, 255, 0.4)"
font_size = 88
halign = "center"
valign = "top"
x = 0
y = 40
[visuals.date]
format = "long"
font_family = "Geom"
font_weight = 600
font_size = 18
color = "rgba(255, 255, 255, 0.4)"
halign = "center"
valign = "top"
x = 0
y = 140
[visuals.input]
placeholder = "Password"
background_color = "rgba(255, 255, 255, 0.04)"
width = 310
height = 54
radius = 10
mask_color = "#ffffff"
font_family = "Google Sans Flex"
font_weight = 400
font_size = 16
halign = "center"
valign = "center"
x = 0
y = 80
[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"
size = 150
background_color = "rgba(255, 255, 255, 0.04)"
placeholder_padding = 28
halign = "center"
valign = "center"
x = 0
y = -120
[visuals.username]
enabled = true
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
[visuals.keyboard]
background_size = 46
radius = 23
background_color = "rgba(255, 255, 255, 0.04)"
color = "rgba(255, 255, 255, 0.68)"
size = 16
halign = "right"
valign = "top"
x = -24
y = 21
[visuals.battery]
background_color = "rgba(255, 255, 255, 0.04)"
background_size = 46
radius = 23
color = "rgba(255, 255, 255, 0.68)"
size = 20
halign = "right"
valign = "top"
x = -78
y = 21
[visuals.weather.icon]
size = 40
opacity = 80
halign = "left"
valign = "bottom"
x = 40
y = -112
[visuals.weather.temperature]
font_size = 40
font_family = "Geom"
font_weight = 600
letter_spacing = 0
color = "rgba(255, 255, 255, 0.73)"
halign = "left"
valign = "bottom"
x = 40
y = -70
[visuals.weather.location]
font_size = 22
font_family = "Google Sans Flex"
font_weight = 400
color = "rgba(214, 227, 255, 0.58)"
halign = "left"
valign = "bottom"
x = 40
y = -44
[visuals.now_playing]
enabled = true
fade_duration_ms = 320
[visuals.now_playing.artwork]
size = 44
radius = 8
opacity = 90
halign = "left"
valign = "center"
x = 10
y = 0
relative_to = "now_playing"
[visuals.now_playing.artist]
width = 318
color = "rgba(255, 255, 255, 0.39)"
font_family = "Google Sans Flex"
font_size = 16
font_weight = 400
halign = "left"
valign = "top"
x = 65
y = 10
relative_to = "now_playing"
[visuals.now_playing.title]
width = 318
color = "rgba(255, 255, 255, 0.69)"
font_family = "Google Sans Flex"
font_size = 16
font_weight = 400
halign = "left"
valign = "bottom"
x = 65
y = -10
relative_to = "now_playing"
# Now playing backdrop
[[visuals.backdrop]]
enabled = true
name = "now_playing"
show_when = "now_playing"
mode = "blur"
color = "rgba(255, 255, 255, 0.02)"
blur_strength = 12
radius = 10
border_color = "#FFFFFF18"
width = 400
height = 60
halign = "right"
valign = "bottom"
x = -40
y = -40
z = 0To use a wallpaper, set [background].path. Veila selects file mode unless you set another mode.