Ships with 5 total full visual systems.

4 static, and 1 dynamic.

Each one is a complete preset with its own palette and background.

Fully configurable, so you can also create your own.

Gilded	Blush

Malachite	Sakura

It supports video backgrounds.

Want a fast mental model of what this is, what SDDM is, what it changes, and how recovery works? Read this.

Clone the repo, then run the installer from the repo root.

./scripts/install

For non interactive installs, pass --yes.

./scripts/install --yes

The installer will install and setup everything for the following (through the manifests in scripts/data):

• Arch

• Fedora

• Ubuntu

  • Jammy / 22.04
  • Noble / 24.04
  • Resolute / 26.04

• Debian

  • Bookworm
  • Trixie
  • Forky
  • Sid

• Linux Mint

• Pop!_OS

• Zorin

• openSUSE Tumbleweed

• Gentoo

• Alpine Edge

If you use another distro, have a look at the generic package contract and map it through your package manager.

The installer is local, explicit, and idempotent. It validates the theme tree, installs missing runtime packages, checks required commands, stages the install atomically, writes the SDDM theme selection, and keeps the current session alive.

During setup, it prints the exact plan, asks for confirmation and sudo, installs end to end, and logs the run.

Thyx comes off as clean as if… it never got in.

Ships with a first-class uninstall script so you don’t brick your login screen or get left hanging.

It logs everything and prints a plan before proceeding.

Run it from the repo.

./scripts/uninstall

For non-interactive uninstall:

./scripts/uninstall --yes

When you’re ready to apply changes, restart SDDM from a TTY:

sudo systemctl restart sddm

Or reboot.

From the repo, run:

./scripts/preview

Runs the SDDM greeter in test mode. Your session is untouched.

Close the window when done (your compositor’s normal close shortcut, for example Alt+Q on Hyprland).

All settings live in theme.conf. Edit, preview, repeat.

From /usr/share/sddm/themes/thyx, copy any preset config from presets/ over the main theme.conf.

cp presets/malachite.conf theme.conf
./scripts/preview

When satisfied, restart SDDM or reboot.

You can create custom presets by duplicating an existing preset and modifying it.

cp presets/gilded.conf presets/my-custom.conf
cp presets/my-custom.conf theme.conf
./scripts/preview

Edit freely, keep as many presets as you want, and swap them by copying into theme.conf.

If you’re already in an editor, you can point SDDM at a preset directly through metadata.desktop.

[SddmGreeterTheme]
Theme-Id=thyx
ConfigFile=presets/gilded.conf

Point ConfigFile to any preset in presets/.

ConfigFile=presets/blush.conf
# or
ConfigFile=presets/malachite.conf
# or
ConfigFile=presets/sakura.conf

Save the file, then restart SDDM or reboot.

Ships with Plus Jakarta Sans, and the installer installs it system wide for SDDM.

The Font setting in theme.conf must match the font family name exactly as your system registers it.

Font="Plus Jakarta Sans"

Confirm availability:

fc-list -f "%{family}\n" | grep -i "Plus Jakarta Sans" || true

If you’ve installed additional fonts on your system, you can instruct the greeter to use a different one by updating the Font setting.

To see all available font families:

fc-list -f "%{family}\n" | sort -u

Then replace the Font value with the exact family name.

For example, if you have Inter already installed:

Font="Inter"

After changing fonts, rebuild the font cache if needed:

sudo fc-cache -f -v

All settings are in theme.conf. You can safely test edits using ./scripts/preview so you don’t get locked out and have to recover via TTY.

• DateTextColor - Date display color
• TimeTextColor - Time display color
• LoginFieldTextColor - Username text
• PasswordFieldTextColor - Password text
• PlaceholderTextColor - Input placeholder text
• LoginButtonTextColor - Login button text
• EnvironmentButtonTextColor - Environment selector text
• SystemButtonsIconsColor - Power, restart, and sleep button icons and labels

• FormBackgroundColor - Login form background
• LoginFieldBackgroundColor - Username input background
• PasswordFieldBackgroundColor - Password input background
• LoginButtonBackgroundColor - Login button background

• DropdownTextColor - Dropdown menu text
• DropdownSelectedTextColor - Selected item text
• DropdownBackgroundColor - Dropdown background
• DropdownSelectedBackgroundColor - Selected item background
• DropdownBorderColor - Dropdown border
• DropdownSelectedBorderColor - Selected item border

• HoverLoginButtonBackgroundColor - Login button on hover
• HoverSystemButtonsIconsColor - System buttons on hover
• HoverEnvironmentButtonTextColor - Environment button on hover

FormPosition="center"
# or
FormPosition="right"

DateTextColor="#e0e0e0"
TimeTextColor="#ffffff"
FormBackgroundColor="#1a1a1a"

AnimationDuration="50"
AnimationEasing="OutCubic"

Background="backgrounds/my-video.mp4"

Video backgrounds use the same Background setting as image backgrounds.

If your system uses PAM fingerprint authentication, it can start fingerprint login as soon as the screen appears.

AutoFingerprintOnLoad=true

When enabled, it automatically calls PAM’s fingerprint check on load and logs in as soon as the scan matches.

If fingerprint isn’t configured or fails, the greeter falls back to password login normally.

Having issues? Read this.

MIT © @rccyx