Skip to content

Customizing

Jump to bottom
Willian Santos edited this page Jan 3, 2026 · 26 revisions

Using presets

The preset configs are located in ./configs/. To change the active config, edit ./metadata.desktop and replace the value of ConfigFile=:

ConfigFile=configs/<your_preferred_config>.conf

Note

Changes to the login screen will only take effect when made in /usr/share/sddm/themes/silent/. If you've changed things in the cloned directory, copy them with sudo cp -rf SilentSDDM/. /usr/share/sddm/themes/silent/


configs/default.conf
default.mp4
configs/rei.conf
blue-light.mp4
configs/ken.conf
ken.mp4
configs/silvia.conf
Record_select-area_20250619210838.mp4
configs/catppuccin-latte.conf
configs/catppuccin-frappe.conf
configs/catppuccin-macchiato.conf
configs/catppuccin-mocha.conf

Create your own config

Simply create a new .conf file under configs/ and set it as the active config. If an empty/nonexistent file is provided, the default values will be used.

There are more than TWO HUNDRED options available for you to tweak. You can modify pretty much every part of the theme by changing their values. Options are divided into 21 categories. Each category represents an element in the screen (e.g., clock and username).

Categories are defined between [brackets], followed by their respective options in the option = value format. Here's an example:

[LockScreen.Date]
display = true
format = "dddd, MMMM dd, yyyy"
font-family = "RedHatDisplay"
font-size = 14
font-weight = 600
color = "#FFFFFF"
margin-top = -15

[LoginScreen.LoginArea.Avatar]
shape = "circle"
border-radius = 35
active-size = 120
inactive-size = 80
inactive-opacity = 0.35
active-border-size = 0
inactive-border-size = 0
active-border-color = "#FFFFFF"
inactive-border-color = "#FFFFFF"

Note

Although not required in most cases, it is recommended to surround strings with double quotes ("").

Here's the list of all available options. This list includes default values and brief descriptions for every option. You can also use the default config for reference.


Important

Don't forget to test the theme after every change by running ./test.sh, otherwise you might end up with a broken login screen.

There are some extra tips on how to customize the theme on the snippets page.

Clone this wiki locally