Category | Option | Type | Default value | Possible values
--- | --- | --- | --- | ---
[General] | scale | real | 1.0 |
enable-animations | bool | true | `true` `false`
animated-background-placeholder | string |  | File in `backgrounds/`
background-fill-mode | string | fill | `fill` `fit` `stretch`
Category | Option | Type | Default value | Possible values
[LockScreen] | display | bool | true | `true` `false`
padding-top | int | 0 |
padding-right | int | 0 |
padding-bottom | int | 0 |
padding-left | int | 0 |
background | string | default.jpg | File in `backgrounds/`
use-background-color | bool | false | `true` `false`
background-color | color | #000000 | QColor
blur | int | 0 |
brightness | real | 0.0 | -1.0 ≤ R ≤ 1.0
saturation | real | 0.0 | -1.0 ≤ R ≤ 1.0
input-keystroke | bool | false | `true` `false`
ignore-shift-key | bool | false | `true` `false`
Category | Option | Type | Default value | Possible values
[LockScreen.Clock] | display | bool | true | `true` `false`
position | string | top-center | `top-left` `top-center` `top-right` `center-left` `center` `center-right` `bottom-left` `bottom-center` `bottom-right`
align | string | center | `left` `center` `right`
format | string | hh:mm | QTime format string
font-family | string | RedHatDisplay |
font-size | int | 70 |
font-weight | int | 900 |
color | color | #FFFFFF | QColor
Category | Option | Type | Default value | Possible values
[LockScreen.Date] | display | bool | true | `true` `false`
format | string | dddd, MMMM dd, yyyy | QDate format string
locale | string | en_US | QFormat
font-family | string | RedHatDisplay |
font-size | int | 14 |
font-weight | int | 400 |
color | color | #FFFFFF | QColor
margin-top | int | 0 |
Category | Option | Type | Default value | Possible values
[LockScreen.Message] | display | bool | true | `true` `false`
position | string | bottom-center | `top-left` `top-center` `top-right` `center-left` `center` `center-right` `bottom-left` `bottom-center` `bottom-right`
align | string | center | `left` `center` `right`
text | string | Press any key |
font-family | string | RedHatDisplay |
font-size | int | 12 |
font-weight | int | 400 |
display-icon | bool | true | `true` `false`
icon | string | enter.svg | File in `icons/`
icon-size | int | 16 |
color | color | #FFFFFF | QColor
paint-icon | bool | true | `true` `false`
spacing | int | 0 |
Category | Option | Type | Default value | Possible values
[LoginScreen] | background | string | default.jpg | File in `backgrounds/`
use-background-color | bool | false | `true` `false`
background-color | color | #000000 | QColor
blur | int | 0 |
brightness | real | 0.0 | -1.0 ≤ R ≤ 1.0
saturation | real | 0.0 | -1.0 ≤ R ≤ 1.0
Category | Option | Type | Default value | Possible values
[LoginScreen.LoginArea] | position | string | center | `left` `center` `right`
margin | int | 0 |
Category | Option | Type | Default value | Possible values
[LoginScreen.LoginArea.Avatar] | shape | string | circle | `circle` `square`
border-radius | int | 0 |
active-size | int | 120 |
inactive-size | int | 80 |
inactive-opacity | real | 0.35 | 0.0 ≤ R ≤ 1.0
active-border-size | int | 0 |
inactive-border-size | int | 0 |
active-border-color | color | #FFFFFF | QColor
inactive-border-color | color | #FFFFFF | QColor
always-active | bool | false | `true` `false`
Category | Option | Type | Default value | Possible values
[LoginScreen.LoginArea.Username] | font-family | string | RedHatDisplay |
font-size | int | 16 |
font-weight | int | 900 |
color | color | #FFFFFF | QColor
margin | int | 0 |
Category | Option | Type | Default value | Possible values
[LoginScreen.LoginArea.PasswordInput] | width | int | 200 |
height | int | 30 |
display-icon | bool | true | `true` `false`
font-family | string | RedHatDisplay |
font-size | int | 12 |
icon | string | password.svg | File in `icons/`
icon-size | int | 16 |
content-color | color | #FFFFFF | QColor
background-color | color | #FFFFFF | QColor
background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
border-size | int | 0 |
border-color | color | #FFFFFF | QColor
border-radius-left | int | 0 |
border-radius-right | int | 0 |
margin-top | int | 0 |
masked-character | string | ● |
Category | Option | Type | Default value | Possible values
[LoginScreen.LoginArea.LoginButton] | background-color | color | #FFFFFF | QColor
background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
active-background-color | color | #FFFFFF | QColor
active-background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
icon | string | arrow-right.svg | File in `icons/`
icon-size | int | 18 |
content-color | color | #FFFFFF | QColor
active-content-color | color | #FFFFFF | QColor
border-size | int | 0 |
border-color | color | #FFFFFF | QColor
border-radius-left | int | 0 |
border-radius-right | int | 0 |
margin-left | int | 0 |
show-text-if-no-password | bool | true | `true` `false`
hide-if-not-needed | bool | false | `true` `false`
font-family | string | RedHatDisplay |
font-size | int | 12 |
font-weight | int | 600 |
Category | Option | Type | Default value | Possible values
[LoginScreen.LoginArea.Spinner] | display-text | bool | true | `true` `false`
text | string | Logging in |
font-family | string | RedHatDisplay |
font-weight | int | 600 |
font-size | int | 12 |
icon-size | int | 32 |
icon | string | spinner.svg | File in `icons/`
color | color | #FFFFFF | QColor
spacing | int | 0 |
Category | Option | Type | Default value | Possible values
[LoginScreen.LoginArea.WarningMessage] | font-family | string | RedHatDisplay |
font-size | int | 11 |
font-weight | int | 400 |
normal-color | color | #FFFFFF | QColor
warning-color | color | #FFFFFF | QColor
error-color | color | #FFFFFF | QColor
margin-top | int | 0 |
Category | Option | Type | Default value | Possible values
[LoginScreen.MenuArea.Buttons] | margin-top | int | 0 |
margin-right | int | 0 |
margin-bottom | int | 0 |
margin-left | int | 0 |
size | int | 30 |
border-radius | int | 0 |
spacing | int | 0 |
font-family | string | RedHatDisplay |
Category | Option | Type | Default value | Possible values
[LoginScreen.MenuArea.Popups] | max-height | int | 300 |
item-height | int | 30 |
item-spacing | int | 0 |
padding | int | 0 |
display-scrollbar | bool | true | `true` `false`
margin | int | 0 |
background-color | color | #FFFFFF | QColor
background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
active-option-background-color | color | #FFFFFF | QColor
active-option-background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
content-color | color | #FFFFFF | QColor
active-content-color | color | #FFFFFF | QColor
font-family | string | RedHatDisplay |
border-size | int | 0 |
border-color | color | #FFFFFF | QColor
font-size | int | 11 |
icon-size | int | 16 |
Category | Option | Type | Default value | Possible values
[LoginScreen.MenuArea.Session] | display | bool | true | `true` `false`
position | string | bottom-left | `top-left` `top-center` `top-right` `center-left` `center-right` `bottom-left` `bottom-center` `bottom-right`
index | int | 0 |
popup-direction | string | up | `up` `down` `left` `right`
popup-align | string | center | `start` `center` `end` //
display-session-name | bool | true | `true` `false`
button-width | int | 200 |
popup-width | int | 200 |
background-color | color | #FFFFFF | QColor
background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
active-background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
content-color | color | #FFFFFF | QColor
active-content-color | color | #FFFFFF | QColor
border-size | int | 0 |
font-size | int | 10 |
icon-size | int | 16 |
Category | Option | Type | Default value | Possible values
[LoginScreen.MenuArea.Layout] | display | bool | true | `true` `false`
position | string | bottom-right | `top-left` `top-center` `top-right` `center-left` `center-right` `bottom-left` `bottom-center` `bottom-right`
index | int | 1 |
popup-direction | string | up | `up` `down` `left` `right`
popup-align | string | center | `start` `center` `end`
popup-width | int | 180 |
display-layout-name | bool | true | `true` `false`
background-color | color | #FFFFFF | QColor
background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
active-background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
content-color | color | #FFFFFF | QColor
active-content-color | color | #FFFFFF | QColor
border-size | int | 0 |
font-size | int | 10 |
icon | string | language.svg | File in `icons/`
icon-size | int | 16 |
Category | Option | Type | Default value | Possible values
[LoginScreen.MenuArea.Keyboard] | display | bool | true | `true` `false`
position | string | bottom-right | `top-left` `top-center` `top-right` `center-left` `center-right` `bottom-left` `bottom-center` `bottom-right`
index | int | 2 |
background-color | color | #FFFFFF | QColor
background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
active-background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
content-color | color | #FFFFFF | QColor
active-content-color | color | #FFFFFF | QColor
border-size | int | 0 |
icon | string | keyboard.svg | File in `icons/`
icon-size | int | 16 |
Category | Option | Type | Default value | Possible values
[LoginScreen.MenuArea.Power] | display | bool | true | `true` `false`
position | string | bottom-right | `top-left` `top-center` `top-right` `center-left` `center-right` `bottom-left` `bottom-center` `bottom-right`
index | int | 3 |
popup-direction | string | up | `up` `down` `left` `right`
popup-align | string | center | `start` `center` `end`
popup-width | int | 90 |
background-color | color | #FFFFFF | QColor
background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
active-background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
content-color | color | #FFFFFF | QColor
active-content-color | color | #FFFFFF | QColor
border-size | int | 0 |
icon | string | power.svg | File in `icons/`
icon-size | int | 16 |
Category | Option | Type | Default value | Possible values
[LoginScreen.VirtualKeyboard] | scale | real | 1.0 |
position | string | login | `login` `top` `bottom` `left` `right`
start-hidden | bool | true | `true` `false`
background-color | color | #FFFFFF | QColor
background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
key-content-color | color | #FFFFFF | QColor
key-color | color | #FFFFFF | QColor
key-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
key-active-background-color | color | #FFFFFF | QColor
key-active-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
selection-background-color | color | #CCCCCC | QColor
selection-content-color | color | #FFFFFF | QColor
primary-color | color | #000000 | QColor
border-size | int | 0 |
border-color | color | #000000 | QColor
restrict-input | string | none | `none` `digits`
Category | Option | Type | Default value | Possible values
[Tooltips] | enable | bool | true | `true` `false`
font-family | string | RedHatDisplay |
font-size | int | 11 |
content-color | color | #FFFFFF | QColor
background-color | color | #FFFFFF | QColor
background-opacity | real | 0.0 | 0.0 ≤ R ≤ 1.0
border-radius | int | 5 |
disable-user | bool | false | `true` `false`
disable-login-button | bool | false | `true` `false`
Category | Option | Type | Default value | Possible values
[User.<username>] | preferred-session | string |  |

-- -- ## [General]
scale

Overall UI scale multiplier applied after Qt's automatic per-display high-DPI scale. This option can cause the UI to break, so it is recommended to use the individual width/height/size options instead.

Type | real
Default value | 1.0
Possible values |

enable-animations

Enable or disable all animations.

Type | bool
Default value | true
Possible values | `true` `false`

animated-background-placeholder

An image file to be used as a placeholder for the animated background while it loads.

Type | string
Default value |
Possible values | File in `backgrounds/`

background-fill-mode

Fill mode for LockScreen/background and LoginScreen/background.

Value | QML equivalent | Description
--- | --- | ---
fit | Image.PreserveAspectFit and VideoOutput.PreserveAspectFit | The image/video is scaled uniformly to fit without cropping.
fill | Image.PreserveAspectCrop and VideoOutput.PreserveAspectCrop | The image/video is scaled uniformly to fill, cropping if necessary.
stretch | Image.Stretch and VideoOutput.Stretch | The image/video is scaled to fit, stretching if necessary.

Type | string
Default value | fill
Possible values | `fill` `fit` `stretch`

-- -- ## [LockScreen]
display

Whether or not to display the lock screen. If false, the theme will load straight to the login screen.

Type | bool
Default value | true
Possible values | `true` `false`

padding-top

Top padding of the lock screen.
See also: Clock/position, Message/position.

Type | int
Default value | 0
Possible values |

padding-right

Right padding of the lock screen.
See also: Clock/position, Message/position.

Type | int
Default value | 0
Possible values |

padding-bottom

Bottom padding of the lock screen.
See also: Clock/position, Message/position.

Type | int
Default value | 0
Possible values |

padding-left

Left padding of the lock screen.
See also: Clock/position, Message/position.

Type | int
Default value | 0
Possible values |

background

Background of the lock screen.
Supported formats: jpg, png, avi, mp4, mov, mkv, m4v, webm. .gifs are not supported as they may cause SDDM to crash.
See also: animated-background-placeholder

Type | string
Default value | default.jpg
Possible values | File in `backgrounds/`

use-background-color

Whether or not to use a plain color as background of the lock screen instead of an image/video file.

Type | bool
Default value | false
Possible values | `true` `false`

background-color

The color to be used as background of the lock screen.
See also: use-background-color

Type | color
Default value | #000000
Possible values | QColor

blur

Amount of blur to be applied to the background of the lock screen. 0 means no blur.

Type | int
Default value | 0
Possible values |

brightness

Brightness of the background of the lock screen. 0.0 leaves unchanged, -1.0 makes it black and 1.0 white.

Type | real
Default value | 0.0
Possible values | -1.0 ≤ R ≤ 1.0

saturation

Saturation of the background of the lock screen. 0.0 leaves unchanged, -1.0 makes it grayscale and 1.0 very saturated.

Type | real
Default value | 0.0
Possible values | -1.0 ≤ R ≤ 1.0

input-keystroke

If `true`, the key press used to unlock the screen will be registered in the password input.

Type | bool
Default value | false
Possible values | `true` `false`

ignore-shift-key

If enabled, the [shift] key will not unlock the screen. Useful with `input-keystroke` set to `true`, if your password's first character is uppercase or a symbol.

Type | bool
Default value | false
Possible values | `true` `false`

-- -- ## [LockScreen.Clock]
display

Whether or not to display the clock in the lock screen.

Type | bool
Default value | true
Possible values | `true` `false`

position

Position of the clock and date in the lock screen.
See also: LockScreen/padding-top

Type | string
Default value | top-center
Possible values | `top-left` `top-center` `top-right` `center-left` `center` `center-right` `bottom-left` `bottom-center` `bottom-right`

align

Relative alignment of the clock and date.

Type | string
Default value | center
Possible values | `left` `center` `right`

format

Format string used for the clock.

Type | string
Default value | hh:mm
Possible values | QTime format string

font-family

Font family used for the clock.

Type | string
Default value | RedHatDisplay
Possible values |

font-size

Font size of the clock.

Type | int
Default value | 70
Possible values |

font-weight

Font weight of the clock. 400 = regular, 600 = bold, 800 = black

Type | int
Default value | 900
Possible values |

color

Color of the clock.

Type | color
Default value | #FFFFFF
Possible values | QColor

-- -- ## [LockScreen.Date]
display

Whether or not to display the date in the lock screen.

Type | bool
Default value | true
Possible values | `true` `false`

format

Format string used for the date.

Type | string
Default value | dddd, MMMM dd, yyyy
Possible values | QDate format string

locale

Language of the date defined by lang_COUNTRY.
'lang' is a lowercase, two-letter, ISO 639 language code
'COUNTRY' is an uppercase, two-letter, ISO 3166 country code.

Type | string
Default value | en_US
Possible values | QFormat

font-family

Font family used for the date.

Type | string
Default value | RedHatDisplay
Possible values |

font-size

Font size of the date.

Type | int
Default value | 14
Possible values |

font-weight

Font weight of the date. 400 = regular, 600 = bold, 800 = black

Type | int
Default value | 400
Possible values |

color

Color of the date.

Type | color
Default value | #FFFFFF
Possible values | QColor

margin-top

Top margin from the clock

Type | int
Default value | 0
Possible values |

-- -- ## [LockScreen.Message]
display

Whether or not to display the custom message in the lock screen.

Type | bool
Default value | true
Possible values | `true` `false`

position

Position of the custom message in the lock screen.
See also: LockScreen/padding-top

Type | string
Default value | bottom-center
Possible values | `top-left` `top-center` `top-right` `center-left` `center` `center-right` `bottom-left` `bottom-center` `bottom-right`

align

Relative alignment of the custom message and its icon.

Type | string
Default value | center
Possible values | `left` `center` `right`

text

Text of the custom message.

Type | string
Default value | Press any key
Possible values |

font-family

Font family used for the custom message.

Type | string
Default value | RedHatDisplay
Possible values |

font-size

Font size of the custom message.

Type | int
Default value | 12
Possible values |

font-weight

Font weight of the date. 400 = regular, 600 = bold, 800 = black

Type | int
Default value | 400
Possible values |

display-icon

Show or hide the icon above the message.

Type | bool
Default value | true
Possible values | `true` `false`

icon

Icon above the custom message.

Type | string
Default value | enter.svg
Possible values | File in `icons/`

icon-size

Size of the custom message's icon.

Type | int
Default value | 16
Possible values |

color

Color of the custom message.

Type | color
Default value | #FFFFFF
Possible values | QColor

paint-icon

Whether or not to paint the icon with the same color as the text.

Type | bool
Default value | true
Possible values | `true` `false`

spacing

Spacing between the icon and the text in the custom message.

Type | int
Default value | 0
Possible values |

-- -- ## [LoginScreen]
background

Background of the login screen.
Supported formats: jpg, png, avi, mp4, mov, mkv, m4v, webm. .gifs are not supported as they may cause SDDM to crash.
See also: animated-background-placeholder

Type | string
Default value | default.jpg
Possible values | File in `backgrounds/`

use-background-color

Whether or not to use a plain color as background of the login screen instead of an image/video file.

Type | bool
Default value | false
Possible values | `true` `false`

background-color

The color to be used as background of the login screen.
See also: use-background-color

Type | color
Default value | #000000
Possible values | QColor

blur

Amount of blur to be applied to the background of the login screen. 0 means no blur.

Type | int
Default value | 0
Possible values |

brightness

Brightness of the background of the login screen. 0.0 leaves unchanged, -1.0 makes it black and 1.0 white.

Type | real
Default value | 0.0
Possible values | -1.0 ≤ R ≤ 1.0

saturation

Saturation of the background of the login screen. 0.0 leaves unchanged, -1.0 makes it grayscale and 1.0 very saturated.

Type | real
Default value | 0.0
Possible values | -1.0 ≤ R ≤ 1.0

-- -- ## [LoginScreen.LoginArea]
position

Position of the login area.

Type | string
Default value | center
Possible values | `left` `center` `right`

margin

Margin of the login area relative to its anchor point.
If position is set to `center`, this option specifies the top margin, left/right margin otherwise.
Set this option to `-1` to center the login area.

Type | int
Default value | 0
Possible values |

-- -- ## [LoginScreen.LoginArea.Avatar]
shape

Shape of the avatar.
See also: border-radius

Type | string
Default value | circle
Possible values | `circle` `square`

border-radius

Border radius of the 'square' avatar.
See also: shape

Type | int
Default value | 0
Possible values |

active-size

Size of the selected user's avatar.

Type | int
Default value | 120
Possible values |

inactive-size

Size of the non-selected user avatars.

Type | int
Default value | 80
Possible values |

inactive-opacity

Opacity of the non-selected avatars.

Type | real
Default value | 0.35
Possible values | 0.0 ≤ R ≤ 1.0

active-border-size

Border size of the selected user's avatar.

Type | int
Default value | 0
Possible values |

inactive-border-size

Border size of the non-selected avatars.

Type | int
Default value | 0
Possible values |

active-border-color

Border color of the selected user's avatar.

Type | color
Default value | #FFFFFF
Possible values | QColor

inactive-border-color

Border color of the non-selected avatars.

Type | color
Default value | #FFFFFF
Possible values | QColor

always-active

Whether or not to always show the user selector.

Type | bool
Default value | false
Possible values | `true` `false`

-- -- ## [LoginScreen.LoginArea.Username]
font-family

Font family used for the username.

Type | string
Default value | RedHatDisplay
Possible values |

font-size

Font size of the username.

Type | int
Default value | 16
Possible values |

font-weight

Font weight of the username. 400 = regular, 600 = bold, 800 = black

Type | int
Default value | 900
Possible values |

color

Color of the username.

Type | color
Default value | #FFFFFF
Possible values | QColor

margin

Distance of the username from the avatar.

Type | int
Default value | 0
Possible values |

-- -- ## [LoginScreen.LoginArea.PasswordInput]
width

Width of the password field.

Type | int
Default value | 200
Possible values |

height

Height of the password field. This option also defines the size of the login button.

Type | int
Default value | 30
Possible values |

display-icon

Whether or not to display the icon in the password field.

Type | bool
Default value | true
Possible values | `true` `false`

font-family

Font family of the password field.

Type | string
Default value | RedHatDisplay
Possible values |

font-size

Font size of the password field.

Type | int
Default value | 12
Possible values |

icon

Icon in the password field.

Type | string
Default value | password.svg
Possible values | File in `icons/`

icon-size

Size of the icon inside the password field.

Type | int
Default value | 16
Possible values |

content-color

Color of text/icon in the password field.

Type | color
Default value | #FFFFFF
Possible values | QColor

background-color

Background color of the password field.

Type | color
Default value | #FFFFFF
Possible values | QColor

background-opacity

Opacity of the background of the password field.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

border-size

Size of the border of the password field.

Type | int
Default value | 0
Possible values |

border-color

Color of the border of the password field.

Type | color
Default value | #FFFFFF
Possible values | QColor

border-radius-left

Left border radius of the password field.

Type | int
Default value | 0
Possible values |

border-radius-right

Right border radius of the password field.

Type | int
Default value | 0
Possible values |

margin-top

Distance of the password field/login button from the username.

Type | int
Default value | 0
Possible values |

masked-character

Customized masked character of the password.

Type | string
Default value | ●
Possible values |

-- -- ## [LoginScreen.LoginArea.LoginButton]
background-color

Background color of the login button.

Type | color
Default value | #FFFFFF
Possible values | QColor

background-opacity

Opacity of the background of the login button.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

active-background-color

Background color of the login button when hovered/focused.

Type | color
Default value | #FFFFFF
Possible values | QColor

active-background-opacity

Opacity of the background of the login button when hovered/focused.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

icon

Icon in the login button

Type | string
Default value | arrow-right.svg
Possible values | File in `icons/`

icon-size

Size of the icon in the login button.

Type | int
Default value | 18
Possible values |

content-color

Color of the icon/text in the login button.

Type | color
Default value | #FFFFFF
Possible values | QColor

active-content-color

Color of the icon/text in the login button when hovered/focused.

Type | color
Default value | #FFFFFF
Possible values | QColor

border-size

Border size of the login button.

Type | int
Default value | 0
Possible values |

border-color

Border color of the login button.

Type | color
Default value | #FFFFFF
Possible values | QColor

border-radius-left

Left border radius of the login button.

Type | int
Default value | 0
Possible values |

border-radius-right

Right border radius of the login button.

Type | int
Default value | 0
Possible values |

margin-left

Distance of the login button from the password field.

Type | int
Default value | 0
Possible values |

show-text-if-no-password

Whether or not to show a label in the login button when the password field is not visible.

Type | bool
Default value | true
Possible values | `true` `false`

hide-if-not-needed

Whether or not to hide the login button if the password field is visible. You can still log-in with [enter].

Type | bool
Default value | false
Possible values | `true` `false`

font-family

Font family of the label of the login button/

Type | string
Default value | RedHatDisplay
Possible values |

font-size

Font size of the label of the login button.

Type | int
Default value | 12
Possible values |

font-weight

Font weight of the label of the login button. 400 = regular, 600 = bold, 800 = black

Type | int
Default value | 600
Possible values |

-- -- ## [LoginScreen.LoginArea.Spinner]
display-text

Whether or not to display the text with the spinning icon.

Type | bool
Default value | true
Possible values | `true` `false`

text

Text to be displayed with the spinning icon.

Type | string
Default value | Logging in
Possible values |

font-family

Font family of the text to be displayed with the spinning icon.

Type | string
Default value | RedHatDisplay
Possible values |

font-weight

Font weight of the text to be displayed with the spinning icon. 400 = regular, 600 = bold, 800 = black

Type | int
Default value | 600
Possible values |

font-size

Font size of the spinner's text.

Type | int
Default value | 12
Possible values |

icon-size

Size of the spinning icon.

Type | int
Default value | 32
Possible values |

icon

Spinning icon.

Type | string
Default value | spinner.svg
Possible values | File in `icons/`

color

Color of the spinning icon and its text.

Type | color
Default value | #FFFFFF
Possible values | QColor

spacing

Spacing between the spinning icon and its text.

Type | int
Default value | 0
Possible values |

-- -- ## [LoginScreen.LoginArea.WarningMessage]
font-family

Font family of the warning message.

Type | string
Default value | RedHatDisplay
Possible values |

font-size

Font size of the warning message.

Type | int
Default value | 11
Possible values |

font-weight

Font weight of the warning message. 400 = regular, 600 = bold, 800 = black

Type | int
Default value | 400
Possible values |

normal-color

Color of the warning message for normal messages.

Type | color
Default value | #FFFFFF
Possible values | QColor

warning-color

Color of the warning message for warnings.

Type | color
Default value | #FFFFFF
Possible values | QColor

error-color

Color of the warning message for error messages.

Type | color
Default value | #FFFFFF
Possible values | QColor

margin-top

Distance of the warning message from the password field/login button.

Type | int
Default value | 0
Possible values |

-- -- ## [LoginScreen.MenuArea.Buttons]
margin-top

Top margin of the menu buttons.

Type | int
Default value | 0
Possible values |

margin-right

Right margin of the menu buttons.

Type | int
Default value | 0
Possible values |

margin-bottom

Bottom margin of the menu buttons.

Type | int
Default value | 0
Possible values |

margin-left

Left margin of the menu buttons.

Type | int
Default value | 0
Possible values |

size

Size of the menu buttons.

Type | int
Default value | 30
Possible values |

border-radius

Border radius of the menu buttons.

Type | int
Default value | 0
Possible values |

spacing

Spacing between menu buttons placed in the same position.

Type | int
Default value | 0
Possible values |

font-family

Font family of the menu buttons.

Type | string
Default value | RedHatDisplay
Possible values |

-- -- ## [LoginScreen.MenuArea.Popups]
max-height

Max height of the popups.

Type | int
Default value | 300
Possible values |

item-height

Height of the items inside a popup.

Type | int
Default value | 30
Possible values |

item-spacing

Spacing between items inside a popup.

Type | int
Default value | 0
Possible values |

padding

Padding of the popups.

Type | int
Default value | 0
Possible values |

display-scrollbar

Whether or not to display a scrollbar in the popups if its items don't fit.

Type | bool
Default value | true
Possible values | `true` `false`

margin

Distance of the popup from its button.

Type | int
Default value | 0
Possible values |

background-color

Background color of the popups.

Type | color
Default value | #FFFFFF
Possible values | QColor

background-opacity

Opacity of the background of the popups.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

active-option-background-color

Background color of the hovered/focused item in the popup.

Type | color
Default value | #FFFFFF
Possible values | QColor

active-option-background-opacity

Opacity of the background of the hovered/focused item in the popup.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

content-color

Color of the text of the non-selected items in the popup.

Type | color
Default value | #FFFFFF
Possible values | QColor

active-content-color

Color of the text of the hovered/focused item in the popup.

Type | color
Default value | #FFFFFF
Possible values | QColor

font-family

Font family of the popups.

Type | string
Default value | RedHatDisplay
Possible values |

border-size

Size of the border of the popups.

Type | int
Default value | 0
Possible values |

border-color

Color of the border of the popups.

Type | color
Default value | #FFFFFF
Possible values | QColor

font-size

Font size of the popups.

Type | int
Default value | 11
Possible values |

icon-size

Size of the icons in the popups.

Type | int
Default value | 16
Possible values |

-- -- ## [LoginScreen.MenuArea.Session]
display

Whether or not to display the session button.

Type | bool
Default value | true
Possible values | `true` `false`

position

Position of the session button.

Type | string
Default value | bottom-left
Possible values | `top-left` `top-center` `top-right` `center-left` `center-right` `bottom-left` `bottom-center` `bottom-right`

index

This number is used to sort menu buttons placed in the same position.

Type | int
Default value | 0
Possible values |

popup-direction

Which direction to open the session popup to.

Type | string
Default value | up
Possible values | `up` `down` `left` `right`

popup-align

Alignment of the session popup.

Type | string
Default value | center
Possible values | `start` `center` `end` //

display-session-name

Whether or not to display the name of the current session in the session button.

Type | bool
Default value | true
Possible values | `true` `false`

button-width

Width of the session button. Set this to '-1' to make it the same as its contents.
This option is not applied if 'display-session-name' is set to true.

Type | int
Default value | 200
Possible values |

popup-width

Width of the session popup.

Type | int
Default value | 200
Possible values |

background-color

Background color of the session button.

Type | color
Default value | #FFFFFF
Possible values | QColor

background-opacity

Opacity of the background of the session button.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

active-background-opacity

Opacity of the background of the session button when hovered/focused.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

content-color

Color of the icon and text in the session button.

Type | color
Default value | #FFFFFF
Possible values | QColor

active-content-color

Color of the icon and text in the session button when hovered/focused.

Type | color
Default value | #FFFFFF
Possible values | QColor

border-size

Size of the border of the session button. The color of the border is defined by 'content-color' and 'active-content-color'.

Type | int
Default value | 0
Possible values |

font-size

Font size of the session button.

Type | int
Default value | 10
Possible values |

icon-size

Size of the icon in the session button.

Type | int
Default value | 16
Possible values |

-- -- ## [LoginScreen.MenuArea.Layout]
display

Whether or not to display the layout button.

Type | bool
Default value | true
Possible values | `true` `false`

position

Position of the layout button.

Type | string
Default value | bottom-right
Possible values | `top-left` `top-center` `top-right` `center-left` `center-right` `bottom-left` `bottom-center` `bottom-right`

index

This number is used to sort menu buttons placed in the same position.

Type | int
Default value | 1
Possible values |

popup-direction

Which direction to open the layout popup to.

Type | string
Default value | up
Possible values | `up` `down` `left` `right`

popup-align

Alignment of the session popup.

Type | string
Default value | center
Possible values | `start` `center` `end`

popup-width

Width of the layout popup.

Type | int
Default value | 180
Possible values |

display-layout-name

Whether or not to display the country code of the current layout in the layout button.

Type | bool
Default value | true
Possible values | `true` `false`

background-color

Background color of the layout button.

Type | color
Default value | #FFFFFF
Possible values | QColor

background-opacity

Opacity of the background of the layout button.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

active-background-opacity

Opacity of the background of the layout button when hovered/focused.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

content-color

Color of the icon and text in the layout button.

Type | color
Default value | #FFFFFF
Possible values | QColor

active-content-color

Color of the icon and text in the layout button when hovered/focused.

Type | color
Default value | #FFFFFF
Possible values | QColor

border-size

Size of the border of the layouts button. The color of the border is defined by 'content-color' and 'active-content-color'.

Type | int
Default value | 0
Possible values |

font-size

Font size of the layout button.

Type | int
Default value | 10
Possible values |

icon

Icon in the layout button.

Type | string
Default value | language.svg
Possible values | File in `icons/`

icon-size

Size of the icon in the layout button.

Type | int
Default value | 16
Possible values |

-- -- ## [LoginScreen.MenuArea.Keyboard]
display

Whether or not to display the virtual keyboard toggle button.

Type | bool
Default value | true
Possible values | `true` `false`

position

Position of the virtual keyboard toggle button.

Type | string
Default value | bottom-right
Possible values | `top-left` `top-center` `top-right` `center-left` `center-right` `bottom-left` `bottom-center` `bottom-right`

index

This number is used to sort menu buttons placed in the same position.

Type | int
Default value | 2
Possible values |

background-color

Background color of the virtual keyboard toggle button.

Type | color
Default value | #FFFFFF
Possible values | QColor

background-opacity

Opacity of the background of the virtual keyboard toggle button

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

active-background-opacity

Opacity of the background of the virtual keyboard toggle button when hovered/focused.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

content-color

Color of the icon in the virtual keyboard toggle button.

Type | color
Default value | #FFFFFF
Possible values | QColor

active-content-color

Color of the icon in the virtual keyboard toggle button when hovered/focused.

Type | color
Default value | #FFFFFF
Possible values | QColor

border-size

Border size of the virtual keyboard toggle button. The color of the border is defined by 'content-color' and 'active-content-color'.

Type | int
Default value | 0
Possible values |

icon

Icon in the virtual keyboard toggle button.

Type | string
Default value | keyboard.svg
Possible values | File in `icons/`

icon-size

Size of the icon in the virtual keyboard toggle button.

Type | int
Default value | 16
Possible values |

-- -- ## [LoginScreen.MenuArea.Power]
display

Whether or not to display the power button.

Type | bool
Default value | true
Possible values | `true` `false`

position

Position of the power button.

Type | string
Default value | bottom-right
Possible values | `top-left` `top-center` `top-right` `center-left` `center-right` `bottom-left` `bottom-center` `bottom-right`

index

This number is used to sort menu buttons placed in the same position.

Type | int
Default value | 3
Possible values |

popup-direction

Which direction to open the power popup to.

Type | string
Default value | up
Possible values | `up` `down` `left` `right`

popup-align

Type | string
Default value | center
Possible values | `start` `center` `end`

popup-width

Width of the power popup.

Type | int
Default value | 90
Possible values |

background-color

Background color of the power button.

Type | color
Default value | #FFFFFF
Possible values | QColor

background-opacity

Opacity of the background of the power button.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

active-background-opacity

Opacity of the background of the power button when hovered/focused.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

content-color

Color of the icon in the power button.

Type | color
Default value | #FFFFFF
Possible values | QColor

active-content-color

Color of the icon in the power button when hovered/focused.

Type | color
Default value | #FFFFFF
Possible values | QColor

border-size

Border size of the power button. The color of the border is defined by 'content-color' and 'active-content-color'.

Type | int
Default value | 0
Possible values |

icon

Icon in the power button.

Type | string
Default value | power.svg
Possible values | File in `icons/`

icon-size

Size of the icon in the power button.

Type | int
Default value | 16
Possible values |

-- -- ## [LoginScreen.VirtualKeyboard]
scale

Scale of the virtual keyboard.

Type | real
Default value | 1.0
Possible values |

position

Initial position of the virtual keyboard. You can drag the keyboard using the middle mouse button.

Type | string
Default value | login
Possible values | `login` `top` `bottom` `left` `right`

start-hidden

Whether or not the virtual keyboard should start hidden.

Type | bool
Default value | true
Possible values | `true` `false`

background-color

Color of the background of the virtual keyboard.

Type | color
Default value | #FFFFFF
Possible values | QColor

background-opacity

Opacity of the background of the virtual keyboard.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

key-content-color

Color of the keys' text/icon in the virtual keyboard.

Type | color
Default value | #FFFFFF
Possible values | QColor

key-color

Color of the background of the keys in the virtual keyboard.

Type | color
Default value | #FFFFFF
Possible values | QColor

key-opacity

Opacity of the background of the keys in the virtual keybaord.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

key-active-background-color

Color of the background of the special keys in the virtual keyboard.

Type | color
Default value | #FFFFFF
Possible values | QColor

key-active-opacity

Opacity of the background of the special keys in the virtual keyboard.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

selection-background-color

Color of the background of the selected character in the virtual keyboard.

Type | color
Default value | #CCCCCC
Possible values | QColor

selection-content-color

Color of the text of the selected character in the virtual keyboard.

Type | color
Default value | #FFFFFF
Possible values | QColor

primary-color

Color of the icon/text in special keys when they're active.

Type | color
Default value | #000000
Possible values | QColor

border-size

Border size of the virtual keyboard and its keys.

Type | int
Default value | 0
Possible values |

border-color

Color of the border of the virtual keyboard and its keys.

Type | color
Default value | #000000
Possible values | QColor

restrict-input

Default layout of the virtual keyboard.
**Warning!** Make sure not to set this option to `digits` if you got a user whose password contains letters/symbols.

Type | string
Default value | none
Possible values | `none` `digits`

-- -- ## [Tooltips]
enable

Whether or not to show tooltips when hovering over buttons.

Type | bool
Default value | true
Possible values | `true` `false`

font-family

Font family of the tooltips.

Type | string
Default value | RedHatDisplay
Possible values |

font-size

Font size of the tooltips.

Type | int
Default value | 11
Possible values |

content-color

Color of the text in tooltips.

Type | color
Default value | #FFFFFF
Possible values | QColor

background-color

Color of the background of the tooltips.

Type | color
Default value | #FFFFFF
Possible values | QColor

background-opacity

Opacity of the background of the tooltips.

Type | real
Default value | 0.0
Possible values | 0.0 ≤ R ≤ 1.0

border-radius

Border radius of the tooltips.

Type | int
Default value | 5
Possible values |

disable-user

If false, disables only the tooltip for the user selector.

Type | bool
Default value | false
Possible values | `true` `false`

disable-login-button

If false, disabled only the tooltip for the login button.

Type | bool
Default value | false
Possible values | `true` `false`

-- -- ## [User.<username>]
preferred-session

Set the name of the preferred session for this user. The session will be selected automatically when the user is changed.
Example:
`preferred-session = "Hyprland (uwsm-managed)"`

Type | string
Default value |
Possible values |

-- --