Visuals Reference

Color Values

All color fields in the config accept the following formats:

color = "#202833"            # hex RGB
color = "#202833CC"          # hex RGBA (last two digits = alpha)
color = "rgb(32, 40, 51)"
color = "rgba(32, 40, 51, 0.8)"

All visual styling lives under [visuals.*] in config.toml.

Backdrop

Use one or more repeatable backdrop layers for blur panels, solid panels, widget anchoring and more

[[visuals.backdrop]]
name = "auth_panel"
enabled = true
show_when = "always"
mode = "blur"
color = "#00000040"
blur_strength = 12
radius = 24
border_color = "#FFFFFF18"
border_width = 1
width = 540
height = 600
full_width = false
full_height = true
inset_top = 110
inset_bottom = 110
inset_left = 0
inset_right = 0
halign = "right"
x = -100
z = 0

Key	What it does	Default
`name`	Backdrop name for `relative_to`	unset
`enabled`	Show or hide this backdrop layer	`true`
`show_when`	Conditional visibility. Supports `"always"`, `"battery"`, `"weather"` and `"now_playing"`	`"always"`
`mode`	Backdrop mode. Supports `"blur"` and `"solid"`	`"blur"`
`color`	Fill or blur tint color, including alpha	`"#080A0E6B"`
`blur_strength`	Blur amount for `mode = "blur"`	`12`
`radius`	Radius in pixels	`0`
`border_color`	Border color, including alpha	`"#FFFFFF"`
`border_width`	Border width in pixels	`0`
`width`	Backdrop width in pixels. Ignored when `full_width = true`	`560`
`height`	Backdrop height in pixels. Ignored when `full_height = true`	`600`
`rotate`	Clockwise rotation in degrees around the backdrop center	`0`
`full_width`	Expand the backdrop to the full output width	`false`
`full_height`	Expand the backdrop to the full output height	`false`
`inset_top`	Top trim in pixels when `full_height = true`	`0`
`inset_bottom`	Bottom trim in pixels when `full_height = true`	`0`
`inset_left`	Left trim in pixels when `full_width = true`	`0`
`inset_right`	Right trim in pixels when `full_width = true`	`0`
`halign`	Horizontal anchor for placement	`"center"`
`valign`	Vertical anchor for placement	`"top"`
`x`	Horizontal offset from `halign`	`0`
`y`	Vertical offset from `valign`	`0`
`z`	Layer order. Higher values draw above lower values	`0`

Large blurred backdrops can increase lock activation latency, especially on high-resolution or multi-monitor setups. If you want the fastest lock path, prefer smaller blur regions, lower blur_strength, or mode = "solid".

Use show_when = "battery" when a backdrop should only appear while battery data exists. Use show_when = "weather" when a backdrop should follow the weather widget, including hiding when [weather].enabled = false. Use show_when = "now_playing" when a backdrop only makes sense while media is showing. It follows the now-playing widget exactly.

By default, widgets are placed on the whole screen. Set relative_to to a backdrop name when you want a widget to line up inside that backdrop, which is useful for keeping text, clocks, or controls neatly grouped with their background panel.

rotate is a visual transform only. Widgets using relative_to still position themselves inside the backdrop's unrotated rectangle, so alignment stays stable while the panel itself can sit at an angle.

[[visuals.backdrop]]
name = "clock_backdrop" # Can be any unique name
width = 540
full_height = true
inset_top = 110
inset_bottom = 110
rotate = -4
halign = "right"
x = -100

[visuals.clock]
halign = "center"
valign = "top"
x = 0
y = 40
relative_to = "clock_backdrop" # Name of the backdrop to position relative to

Layer

Use one or more repeatable custom layers for simple text labels and Nerd Font icons

[[visuals.layer]]
name = "lock_icon"
enabled = true
kind = "icon"
text = "\uf023"
font_family = "Symbols Nerd Font"
font_weight = 700
font_style = "normal"
font_size = 64
color = "#FFFFFFEE"
background_color = "#00000040"
width = 120
height = 120
padding = 16
radius = 28
halign = "center"
valign = "center"
y = -180
z = 20

[[visuals.layer]]
name = "custom_message"
enabled = true
kind = "text"
text = "locked"
font_family = "Inter"
font_size = 28
color = "#FFFFFFCC"
halign = "center"
valign = "center"
y = -90
z = 21

Key	What it does	Default
`name`	Layer name for easier theme organization.	unset
`enabled`	Show or hide this layer.	`true`
`kind`	Layer content type. Supports `"text"` and `"icon"`.	`"text"`
`text`	Text or Nerd Font glyph to render. Empty text hides the layer.	unset
`font_family`	Font family used for the layer. Use an installed Nerd Font for icons.	unset
`font_weight`	Font weight.	`400`
`font_style`	Font style. Supports `"normal"` and `"italic"`.	`"normal"`
`font_size`	Font size in pixels.	`24`
`color`	Text or icon color, including alpha.	palette foreground
`background_color`	Optional layer background color, including alpha.	unset
`width`	Optional layer box width in pixels. Expands if the content needs more space.	content width
`height`	Optional layer box height in pixels. Expands if the content needs more space.	content height
`padding`	Inner padding in pixels.	`0`
`radius`	Background radius in pixels.	`0`
`halign`	Horizontal anchor for placement.	`"center"`
`valign`	Vertical anchor for placement.	`"center"`
`x`	Horizontal offset from `halign`.	`0`
`y`	Vertical offset from `valign`.	`0`
`relative_to`	Optional named backdrop target.	unset
`z`	Layer order among custom layers. Higher values draw above lower values.	`0`

Avatar

[visuals.avatar]
enabled = true
image_path = "/path/to/avatar.jpg"
size = 150
radius = 75
background_color = "#FFFFFF14"
placeholder_padding = 28
ring_color = "#94B2FF"
ring_width = 0
icon_color = "#FFFFFF"
halign = "center"
valign = "center"
x = 0
y = -120

Key	What it does	Default
`enabled`	Show or hide the avatar.	`true`
`image_path`	Avatar image path.	none
`size`	Avatar diameter in pixels. Explicit sizes are preserved unless they would exceed the viewport safety limit.	`150`
`radius`	Avatar corner radius in pixels. Unset keeps it fully circular.	unset
`background_color`	Avatar fill color, including alpha.	`"#FFFFFF0F"`
`placeholder_padding`	Inner inset for the fallback icon.	`28`
`ring_color`	Ring color around the avatar.	`"#94B2FF"`
`ring_width`	Ring thickness in pixels. `0` disables it.	`0`
`icon_color`	Fallback icon color when no image is available.	`"#FFFFFF"`
`halign`	Horizontal anchor for placement.	unset
`valign`	Vertical anchor for placement.	unset
`x`	Horizontal offset from `halign`.	unset
`y`	Vertical offset from `valign`.	unset
`relative_to`	Optional named backdrop target.	unset

When image_path is unset, it falls back to ~/.face, then the bundled placeholder icon

Username

[visuals.username]
enabled = true
text = "anonymous"
font_family = "Google Sans Flex"
font_weight = 400
font_style = "normal"
color = "#FFFFFFD6"
font_size = 28
halign = "center"
valign = "center"
x = 0
y = 0

Key	What it does	Default
`enabled`	Show or hide the username label.	`true`
`text`	Optional display-only username override.	none
`font_family`	Font family.	`"Google Sans Flex"`
`font_weight`	Font weight.	`400`
`font_style`	Font style. Supports `"normal"` and `"italic"`.	`"normal"`
`color`	Text color, including alpha.	`"#FFFFFFD6"`
`font_size`	Username font size in pixels.	`28`
`halign`	Horizontal anchor for placement.	unset
`valign`	Vertical anchor for placement.	unset
`x`	Horizontal offset from `halign`.	unset
`y`	Vertical offset from `valign`.	unset
`relative_to`	Optional named backdrop target.	unset

Clock

[visuals.clock]
enabled = true
style = "standard"
format = "24h"
font_family = "Geom"
font_weight = 600
font_style = "normal"
color = "#FFFFFF66"
font_size = 88
meridiem_font_size = 22
meridiem_x = 6
meridiem_y = 7
halign = "center"
valign = "top"
x = 0
y = 40

Key	What it does	Default
`enabled`	Show or hide the clock.	`true`
`style`	Clock layout style. Supports `"standard"` and `"stacked"`.	`"standard"`
`format`	Time format. Supports `"24h"` and `"12h"`.	`"24h"`
`font_family`	Font family.	`"Geom"`
`font_weight`	Font weight.	`600`
`font_style`	Font style. Supports `"normal"` and `"italic"`.	`"normal"`
`color`	Text color, including alpha.	`"#FFFFFF66"`
`font_size`	Clock font size in pixels.	`88`
`meridiem_font_size`	AM/PM font size in pixels in `12h` mode.	`22`
`meridiem_x`	Horizontal offset for the meridiem marker.	`6`
`meridiem_y`	Vertical offset for the meridiem marker.	`7`
`halign`	Horizontal anchor for placement.	unset
`valign`	Vertical anchor for placement.	unset
`x`	Horizontal offset from `halign`.	unset
`y`	Vertical offset from `valign`.	unset
`relative_to`	Optional named backdrop target.	unset

Clock text is rendered as a single unbounded line. Large font_size values no longer wrap because of the password field width.

Date

[visuals.date]
format = "long"
enabled = true
font_family = "Geom"
font_weight = 600
font_style = "normal"
color = "#FFFFFF80"
font_size = 16
halign = "center"
valign = "top"
x = 0
y = 140

Key	What it does	Default
`enabled`	Show or hide the date.	`true`
`format`	Date format preset. Supports `"long"`, `"iso"`, `"dmy-dots"`, `"ymd-dots"`, `"mdy-slash"`, `"dmy-slash"`, and `"short"`.	`"long"`
`font_family`	Font family.	`"Geom"`
`font_weight`	Font weight.	`600`
`font_style`	Font style. Supports `"normal"` and `"italic"`.	`"normal"`
`color`	Text color, including alpha.	`"#FFFFFF80"`
`font_size`	Date font size in pixels.	`16`
`halign`	Horizontal anchor for placement.	unset
`valign`	Vertical anchor for placement.	unset
`x`	Horizontal offset from `halign`.	unset
`y`	Vertical offset from `valign`.	unset
`relative_to`	Optional named backdrop target.	unset

Available date formats:

Format	Example
`"long"`	`Wednesday, May 13`
`"iso"`	`2026-05-13`
`"dmy-dots"`	`13.05.2026`
`"ymd-dots"`	`2026.05.13`
`"mdy-slash"`	`05/13/2026`
`"dmy-slash"`	`13/05/2026`
`"short"`	`Wed, May 13`

Password Input

[visuals.input]
placeholder = "Password"
reveal_on_interaction = false
reveal_mode = "input"
font_family = "Google Sans Flex"
font_weight = 400
font_style = "normal"
font_size = 16
background_color = "#FFFFFF0D"
border_color = "#FFFFFF00"
width = 310
height = 54
radius = 10
border_width = 0
mask_color = "#FFFFFF"
halign = "center"
valign = "center"
x = 0
y = 80

Key	What it does	Default
`placeholder`	Placeholder text inside the password field.	`"Password"`
`reveal_on_interaction`	Hide auth UI until the first keypress or pointer press.	`false`
`reveal_mode`	Hidden-auth scope. Supports `"input"` and `"full"`.	`"input"`
`reveal_hint`	Helper text fallback used by `[visuals.reveal]` when needed.	`"Press any key or click to continue"`
`font_family`	Input font family.	`"Google Sans Flex"`
`font_weight`	Input font weight.	`400`
`font_style`	Input font style. Supports `"normal"` and `"italic"`.	`"normal"`
`font_size`	Input font size in pixels.	`16`
`background_color`	Field fill color, including alpha.	`"#FFFFFF0D"`
`border_color`	Field border color, including alpha.	`"#FFFFFF00"`
`width`	Field width in pixels.	`310`
`height`	Field height in pixels.	`54`
`radius`	Field corner radius in pixels.	`10`
`border_width`	Field border width in pixels. `0` disables it.	`0`
`mask_color`	Bullet color for hidden password characters.	`"#FFFFFF"`
`halign`	Horizontal anchor for placement.	unset
`valign`	Vertical anchor for placement.	unset
`x`	Horizontal offset from `halign`.	unset
`y`	Vertical offset from `valign`.	unset
`relative_to`	Optional named backdrop target.	unset

reveal_mode = "input" keeps avatar and username visible while hiding only the input and status. reveal_mode = "full" hides the full auth stack.

Reveal

Use Reveal when you want the password area to stay hidden until someone interacts with the lock screen. It shows a small prompt, like “Press any key or click to continue”, so your theme can look clean while still making it obvious how to unlock.

[visuals.reveal]
mode = "shown"
text = "Press any key or click to continue"
color = "#FFFFFF99"
font_family = "Google Sans Flex"
font_weight = 400
font_style = "normal"
font_size = 16

Key	What it does	Default
`mode`	Reveal helper visibility. Supports `"shown"` and `"hidden"`.	`"shown"`
`text`	Text shown while auth UI is hidden.	`"Press any key or click to continue"`
`color`	Text color, including alpha.	falls back to `[visuals.placeholder]`
`font_family`	Font family.	falls back to `[visuals.input]`
`font_weight`	Font weight.	falls back to `[visuals.input]`
`font_style`	Font style.	falls back to `[visuals.input]`
`font_size`	Reveal font size in pixels.	falls back to `[visuals.input].font_size` when unset

Placeholder

Use Placeholder to style the hint text shown inside the password field before anything is typed.

[visuals.placeholder]
enabled = true
color = "#FFFFFF99"

Key	What it does	Default
`enabled`	Show or hide the placeholder text.	`true`
`color`	Placeholder color, including alpha.	`"#FFFFFF99"`

The placeholder text itself comes from [visuals.input].placeholder.

Status

Use Status to style the feedback shown while the password is being checked or when an attempt fails.

[visuals.status]
enabled = true
mode = "inline"
color = "#FFE0A0E0"
pending_color = "#ECECECE0"
rejected_color = "#FF5353E0"
halign = "center"
valign = "bottom"
x = 0
y = -24

Key	What it does	Default
`enabled`	Show or hide status output.	`true`
`mode`	Auth feedback mode. Supports `"inline"`, `"external"`, and `"hidden"`.	`"inline"`
`color`	General status text color, including alpha.	`"#FFE0A0E0"`
`pending_color`	Pending auth color override.	unset
`rejected_color`	Rejected auth color override.	unset
`halign`	Horizontal anchor for external placement.	unset
`valign`	Vertical anchor for external placement.	unset
`x`	Horizontal offset from `halign`.	unset
`y`	Vertical offset from `valign`.	unset
`relative_to`	Optional named backdrop target.	unset

mode = "inline" keeps auth feedback inside the password field. mode = "external" renders it as a separate widget. mode = "hidden" suppresses auth feedback entirely.

Eye icon

Use Eye icon to style the button that lets someone temporarily show or hide the password they typed.

[visuals.eye]
enabled = true
color = "#FFFFFFB8"

Key	What it does	Default
`enabled`	Show or hide the reveal toggle icon.	`true`
`color`	Icon color, including alpha.	`"#FFFFFFB8"`

Caps Lock icon

Use Caps Lock icon to style the warning shown when Caps Lock is on while typing a password.

[visuals.caps_lock]
enabled = true
color = "#FFD37AA3"

Key	What it does	Default
`enabled`	Show or hide the Caps Lock icon.	`true`
`color`	Icon color, including alpha.	unset

Keyboard

Use Keyboard to style the small chip that shows the active keyboard layout on the lock screen.

[visuals.keyboard]
enabled = true
background_color = "#FFFFFF0D"
background_size = 46
radius = 23
color = "#FFFFFFAD"
size = 16
halign = "right"
valign = "top"
x = -24
y = 17

Key	What it does	Default
`enabled`	Show or hide the keyboard layout	`true`
`background_color`	Background color	`"#FFFFFF0D"`
`background_size`	Height in pixels. `0` to hide background	`46`
`radius`	Radius in pixels	`23`
`color`	Text color	`"#FFFFFFAD"`
`size`	Keyboard label font size	`16`
`halign`	Horizontal anchor for placement	`"right"`
`valign`	Vertical anchor for placement	`"top"`
`x`	Horizontal offset from `halign`	`-24`
`y`	Vertical offset from `valign`	`17`
`relative_to`	Named backdrop target	unset

Battery

Use Battery to style the chip that shows the current battery level while the screen is locked.

[visuals.battery]
enabled = true
background_color = "#FFFFFF0D"
background_size = 46
radius = 23
color = "#FFFFFFAD"
size = 20
halign = "right"
valign = "top"
x = -78
y = 17

Key	What it does	Default
`enabled`	Show or hide the battery	`true`
`background_color`	Background color	`"#FFFFFF0D"`
`background_size`	Height in pixels. `0` to hide the chip background	`46`
`radius`	Radius in pixels	`23`
`color`	Icon and text color	`"#FFFFFFAD"`
`size`	Battery icon size	`20`
`halign`	Horizontal anchor for placement	`"right"`
`valign`	Vertical anchor for placement	`"top"`
`x`	Horizontal offset from `halign`	`-78`
`y`	Vertical offset from `valign`	`17`
`relative_to`	Named backdrop target	unset

Power Buttons

Use Power Buttons suspend, reboot and poweroff controls. Each button is configured independently under [visuals.power.<action>].

The UI only sends a typed request. The daemon performs the action through logind, so lock screen themes never run power commands directly.

[visuals.power.suspend]
enabled = true
background_color = "#FFFFFF0D"
background_size = 46
radius = 23
color = "#FFFFFFAD"
size = 20
confirm = false
halign = "right"
valign = "top"
x = -132
y = 21

[visuals.power.reboot]
enabled = false
confirm = true
x = -186
y = 21

[visuals.power.poweroff]
enabled = false
confirm = true
x = -240
y = 21

Key	What it does	Default
`enabled`	Show or hide this power button	`false`
`background_color`	Background color	`"#FFFFFF0A"`
`background_size`	Height in pixels. `0` to hide the chip background	`46`
`radius`	Radius in pixels	`23`
`color`	Icon color	`"#FFFFFFAD"`
`size`	Icon size	`20`
`confirm`	Require a second click before sending the action	`false` for suspend, `true` for reboot and poweroff
`halign`	Horizontal anchor for placement	`"right"`
`valign`	Vertical anchor for placement	`"top"`
`x`	Horizontal offset from `halign`	`-132`, `-186`, or `-240`
`y`	Vertical offset from `valign`	`21`
`relative_to`	Named backdrop target	unset

Available actions are suspend, reboot, and poweroff. When confirmation is enabled, the first click highlights the button for 5 seconds. Clicking the same highlighted button again sends the request.

Power Status

Use Power Status to style the chip shown during the countdown to a configured power action, such as suspend or shutdown.

This feature is not fully finished yet and might not work as expected.

[visuals.power_status]
enabled = false
halign = "right"
valign = "top"
x = -24
y = 17

Key	What it does	Default
`enabled`	Show or hide the power countdown/status chip.	`false`
`halign`	Horizontal anchor for placement.	`"right"`
`valign`	Vertical anchor for placement.	`"top"`
`x`	Horizontal offset from `halign`.	`-24`
`y`	Vertical offset from `valign`.	`17`
`relative_to`	Optional named backdrop target.	unset

The power status chip only appears while the lockscreen is visible and at least one configured power timer is active.

Weather

Use Weather visuals to style the weather widget on the lock screen. The main weather module still needs to be enabled and configured in Weather settings

Weather icon

[visuals.weather.icon]
enabled = true
size = 40
opacity = 80
halign = "left"
valign = "bottom"
x = 40
y = -122

Key	What it does	Default
`enabled`	Show or hide the weather icon.	`true`
`size`	Icon size in pixels.	`40`
`opacity`	Icon opacity percentage.	`50`
`halign`	Horizontal anchor for placement.	`"left"`
`valign`	Vertical anchor for placement.	`"bottom"`
`x`	Horizontal offset from `halign`.	`30`
`y`	Vertical offset from `valign`.	`-112`
`relative_to`	Optional named backdrop target.	unset

Temperature

[visuals.weather.temperature]
enabled = true
font_size = 40
font_family = "Geom"
font_weight = 600
font_style = "normal"
letter_spacing = 0
color = "#FFFFFF74"
halign = "left"
valign = "bottom"
x = 30
y = -66

Key	What it does	Default
`enabled`	Show or hide the temperature text.	`true`
`font_size`	Temperature font size in pixels.	`40`
`font_family`	Font family.	`"Geom"`
`font_weight`	Font weight.	`600`
`font_style`	Font style.	`"normal"`
`letter_spacing`	Extra letter spacing.	`0`
`color`	Text color, including alpha.	`"#FFFFFF74"`
`halign`	Horizontal anchor for placement.	`"left"`
`valign`	Vertical anchor for placement.	`"bottom"`
`x`	Horizontal offset from `halign`.	`30`
`y`	Vertical offset from `valign`.	`-66`
`relative_to`	Optional named backdrop target.	unset

Location

[visuals.weather.location]
enabled = true
font_size = 22
font_family = "Google Sans Flex"
font_weight = 400
font_style = "normal"
color = "#D6E3FF5C"
halign = "left"
valign = "bottom"
x = 30
y = -34

Key	What it does	Default
`enabled`	Show or hide the location text.	`true`
`font_size`	Location font size in pixels.	`22`
`font_family`	Font family.	`"Google Sans Flex"`
`font_weight`	Font weight.	`400`
`font_style`	Font style.	`"normal"`
`color`	Text color, including alpha.	`"#D6E3FF5C"`
`halign`	Horizontal anchor for placement.	`"left"`
`valign`	Vertical anchor for placement.	`"bottom"`
`x`	Horizontal offset from `halign`.	`30`
`y`	Vertical offset from `valign`.	`-34`
`relative_to`	Optional named backdrop target.	unset

Now Playing

Use Now Playing to show the current media artwork, artist, and title on the lock screen when music or video is playing

[visuals.now_playing]
enabled = true
fade_duration_ms = 320

Key	What it does	Default
`enabled`	Master switch for the now-playing widget.	`true`
`fade_duration_ms`	Cross-fade duration for metadata transitions.	`320`

Artwork

[visuals.now_playing.artwork]
enabled = true
size = 44
radius = 8
opacity = 90
halign = "right"
valign = "bottom"
x = -388
y = -56

Key	What it does	Default
`enabled`	Show or hide the artwork block.	`true`
`size`	Artwork size in pixels. Explicit sizes are preserved unless they would exceed the viewport safety limit.	`44`
`radius`	Artwork corner radius. Clamped to half the resolved artwork size.	`8`
`opacity`	Artwork opacity percentage.	`90`
`halign`	Horizontal anchor for placement.	`"right"`
`valign`	Vertical anchor for placement.	`"bottom"`
`x`	Horizontal offset from `halign`.	`-388`
`y`	Vertical offset from `valign`.	`-56`
`relative_to`	Optional named backdrop target.	unset

Artist

[visuals.now_playing.artist]
enabled = true
width = 318
color = "#FFFFFF63"
font_family = "Google Sans Flex"
font_size = 16
font_weight = 400
font_style = "normal"
halign = "right"
valign = "bottom"
x = -52
y = -88

Key	What it does	Default
`enabled`	Show or hide the artist line.	`true`
`width`	Maximum text width before truncation.	`318`
`color`	Text color, including alpha.	`"#FFFFFF63"`
`font_family`	Font family.	`"Google Sans Flex"`
`font_size`	Artist font size in pixels.	`16`
`font_weight`	Font weight.	`400`
`font_style`	Font style.	`"normal"`
`halign`	Horizontal anchor for placement.	`"right"`
`valign`	Vertical anchor for placement.	`"bottom"`
`x`	Horizontal offset from `halign`.	`-52`
`y`	Vertical offset from `valign`.	`-88`
`relative_to`	Optional named backdrop target.	unset

Title

[visuals.now_playing.title]
enabled = true
width = 318
color = "#FFFFFFAF"
font_family = "Google Sans Flex"
font_size = 16
font_weight = 400
font_style = "normal"
halign = "right"
valign = "bottom"
x = -52
y = -56

Key	What it does	Default
`enabled`	Show or hide the title line.	`true`
`width`	Maximum text width before truncation.	`318`
`color`	Text color, including alpha.	`"#FFFFFFAF"`
`font_family`	Font family.	`"Google Sans Flex"`
`font_size`	Title font size in pixels.	`16`
`font_weight`	Font weight.	`400`
`font_style`	Font style.	`"normal"`
`halign`	Horizontal anchor for placement.	`"right"`
`valign`	Vertical anchor for placement.	`"bottom"`
`x`	Horizontal offset from `halign`.	`-52`
`y`	Vertical offset from `valign`.	`-56`
`relative_to`	Optional named backdrop target.	unset

Artist and title lines are single-line and truncate with an ellipsis when they do not fit the configured width.

Monitor Output

Use Monitor Output to choose where the full lock UI appears when you have more than one monitor. By default, Veila creates a secure lock surface on every output and renders the password prompt on every connected monitor:

[visuals.outputs]
ui_mode = "all"

Use "single" if you prefer one prompt output and background-only secondary monitors:

[visuals.outputs]
ui_mode = "single"
ui_output = "DP-1"

Selecting a custom list of monitors, such as ui_output = ["DP-1", "DP-2"], is not supported yet. Use ui_mode = "all" if you want the full UI on every connected monitor.

Key	What it does	Default
`ui_mode`	Chooses whether the full UI is rendered on all outputs or only one. Supports `"all"` and `"single"`.	`"all"`
`ui_output`	Output name used when `ui_mode = "single"`.	focused output, then first available output

When ui_mode = "single", the selected output keeps the full lock UI and all other outputs remain background-only. If ui_output is set and exists, Veila pins the prompt to that output. If ui_output is missing, the prompt follows the surface that receives keyboard or pointer focus, with the first configured output used as the startup fallback.

Veila also listens for wp_fractional_scale_v1 when the compositor advertises it. Fractional-scale surfaces are presented through wp_viewport, while every secure surface still respects its own logical size and output scale.

Default Palette

Widgets fall back to these shared colors when their own explicit color keys are unset.

[visuals.palette]
foreground = "#F0F4FA"
muted = "#444E66"
pending = "#ECECEC"
rejected = "#FF5353"

Key	What it does	Default
`foreground`	Shared foreground text color.	`"#F0F4FA"`
`muted`	Shared muted text color.	`"#444E66"`
`pending`	Shared pending-state fallback color.	`"#ECECEC"`
`rejected`	Shared rejected-state fallback color.	`"#FF5353"`

On this page