01. Overview & Architecture

Schema validatedSource pinned
Purpose
Modern animated SDDM theme with many presets.
Compatibility
Any distro (Server: BOTH)
Desktop Part
Login & greeters
Window Manager & Theme
Any WM / DE / Other

02. Installation & Deployment

Before you installThis changes your desktop configuration and installs packages. Run it as your normal user, never with sudo: it asks for sudo only where a step needs it (listed below).The guided installer shows its plan first. Files it would replace are kept unless you approve. Everything it copies, clones or appends to in your home folder is backed up and verified first, and --rollback restores it. Packages, sudo changes and the other commands listed under Impact are not undone.
IntegrityEach release from main builds the installers in GitHub Actions and signs them with a GitHub build attestation. Verify your download against the repository, not this website (Option B, step 2). If it does not verify, don't run it.
ImpactPackages: sddm-astronaut-theme (some from the Arch AUR)
RecoveryGuided: backups in ~/.local/state/0xtsoa/backups/, undo with bash install.sh --rollback.Manual: the steps below only write in the download folder or run listed commands.
Option A: manual installAdvanced
Read the source at the reviewed commit, back up, then run each step yourself.
$git clone https://github.com/Keyitdev/sddm-astronaut-theme ~/0xtsoa-review/keyitdev-sddm-astronaut-theme# 1. clone to a review folder
$git -C ~/0xtsoa-review/keyitdev-sddm-astronaut-theme checkout --detach abb3163c724935af888ba5ea9ac0c4f22afd8048# 2. the reviewed commit
Then the steps. Package commands are written for Arch; on other distros use your package manager.

Step-by-step deployment protocol

Step-by-step deployment
1Install sddm-astronaut-theme (AUR)
$yay -S sddm-astronaut-theme # AUR
$# Other distros: see the upstream README
2Enable on next boot
$# Set it as your display manager / greeter, then reboot
Option B: guided installerRecommended
The same steps as one script for any distro. It shows the plan first, keeps files you already have unless you approve replacing them, and backs up everything it changes in your home folder. Never pipe it into a shell.
$curl -fsSLo install.sh 'https://www.0xtsoa.dev/configs/keyitdev/sddm-astronaut-theme/install.sh'# 1. download
$gh attestation verify install.sh --repo nyharena25/0xTsoa --signer-workflow nyharena25/0xTsoa/.github/workflows/attest-installers.yml# 2. verify (GitHub CLI 2.49+, signed in)
$less install.sh# 3. read it
$bash install.sh --dry-run# 4. preview: changes nothing
$bash install.sh# 5. install (asks first)
$bash install.sh --rollback# undo the file changes
View script in browserOther options: --force (replace conflicts, backed up first), --yes, --help

03. Screenshot Gallery // SDDM Astronaut

Capture 01 // Fullscreen
SDDM Astronaut screenshot 1
01 / 11

04. Documentation & Guide

Source: Keyitdev/sddm-astronaut-themeRef: abb3163c72
README.md|GitHub Flavored Markdown

sddm-astronaut-theme

Stars Forks ![Ko-fi](https://img.shields.io/badge/support_me_on_ko--fi-F16061?style=for-the-badge&logo=kofi&logoColor=f5f5f5)

sddm-astronaut-theme is a series of themes for the SDDM display manager made by Keyitdev.

It's written using the latest version of Qt, which is Qt6. Its key features include virtual keyboard support and an installation script. This theme also support animated wallpapers. You can easily change its appearance by choosing another of the ten pre-made themes or creating your own. Each of these themes was created by modifying just one file - config.

All themes were created for 1080p. However, they should work well in other resolutions.

Preview of all themes

all_themes.gif

Preview of animated themes

https://github.com/user-attachments/assets/2cfc947e-4621-4e98-b5f3-07d5e224b80c

Detailed previews

Astronaut Black hole
astronaut black_hole
Japanese aesthetic Pixel sakura static
japanese_aesthetic pixel_sakura_static
Purple leaves Cyberpunk
purple_leaves cyberpunk
Post-apocalyptic hacker xxx
post-apocalyptic_hacker

Hyprland Kath

https://github.com/user-attachments/assets/1d926e76-44f7-4d99-ac6d-d1abcd7ed688

Pixel sakura

https://github.com/user-attachments/assets/ea004765-7e84-4a0d-90cd-aaac97679f62

Jake the dog

https://github.com/user-attachments/assets/181d48c2-f152-45f5-b568-21145be180f6

Installation

Automatic Installation

bash -c "$(curl -fsSL https://raw.githubusercontent.com/keyitdev/sddm-astronaut-theme/master/setup.sh)"

Works on distributions using pacman, xbps-install, dnf, zypper.
Remember to always read the scripts you run from the internet.

NixOS Installation

Using System Configuration with Custom Overrides

While not officially packaged by the upstream maintainers, there is a community-maintained package maintained by @DaniD3v, @uxodb, and @qweered. You can install and customize the theme by creating an override of the package in your configuration.nix:

let
  sddm-astronaut = (pkgs.sddm-astronaut.override {
    embeddedTheme = "japanese_aesthetic";  # or any other theme
    themeConfig = {
      # Customize colors and settings
      HeaderTextColor = "#d5c4a1";
      Background = "Backgrounds/your-custom-background.png";
      # ... other theme configuration options
    };
  }).overrideAttrs (oldAttrs: {
    # Optional: Inject custom background image
    installPhase = oldAttrs.installPhase + ''
      chmod u+w $out/share/sddm/themes/sddm-astronaut-theme/Backgrounds/
      cp ${./relative/path/to/your-custom-background.png} \
        $out/share/sddm/themes/sddm-astronaut-theme/Backgrounds/your-custom-background.png
    '';
  });
in
{
  environment.systemPackages = [ sddm-astronaut ];
  
  services.displayManager.sddm = {
    enable = true;
    package = pkgs.kdePackages.sddm;
    extraPackages = with pkgs; [
      kdePackages.qtmultimedia # Required for video backgrounds/audio
    ];
    theme = "sddm-astronaut-theme";
  };
}

Manual Installation

  1. Install dependencies

`sddm >= 0.21.0`, `qt6 >= 6.8`, `qt6-svg >= 6.8`, `qt6-virtualkeyboard >= 6.8`, `qt6-multimedia >= 6.8`

You may also want to install additional video codecs like h.264.

sddm qt6-svg qt6-virtualkeyboard qt6-multimedia-ffmpeg     # Arch
sddm qt6-svg qt6-virtualkeyboard qt6-multimedia            # Void
sddm qt6-qtsvg qt6-qtvirtualkeyboard qt6-qtmultimedia      # Fedora
sddm-qt6 libQt6Svg6 qt6-virtualkeyboard qt6-virtualkeyboard-imports qt6-multimedia qt6-multimedia-imports        # OpenSUSE
sddm qt6-svg-dev qml6-module-qtquick-virtualkeyboard qt6-multimedia-dev qml6-module-qtquick-controls qml6-module-qtquick-effects libxcb-cursor0 # Debian trixie (13.5)
  1. Clone this repository
sudo git clone -b master --depth 1 https://github.com/keyitdev/sddm-astronaut-theme.git /usr/share/sddm/themes/sddm-astronaut-theme
  1. Copy fonts to /usr/share/fonts/
sudo cp -r /usr/share/sddm/themes/sddm-astronaut-theme/Fonts/* /usr/share/fonts/
  1. Edit /etc/sddm.conf
echo "[Theme]
Current=sddm-astronaut-theme" | sudo tee /etc/sddm.conf
  1. Edit /etc/sddm.conf.d/virtualkbd.conf
echo "[General]
InputMethod=qtvirtualkeyboard" | sudo tee /etc/sddm.conf.d/virtualkbd.conf

Selecting a theme

You can select theme by editing metadata (/usr/share/sddm/themes/sddm-astronaut-theme/metadata.desktop).

Just edit this line:

ConfigFile=Themes/astronaut.conf

All available configs are in Themes directory.

Previewing a theme

You can preview the set theme without logging out by runnning:

sddm-greeter-qt6 --test-mode --theme /usr/share/sddm/themes/sddm-astronaut-theme/

Note that depending on the system configuration, the preview may differ slightly from the actual login screen.

Sources

Initially the theme was independed fork of MarianArlt's theme but now the project has come a long way and started to significantly deviate from the original. Many of the wallpapers and fonts used in this project are very popular and copied from one user to another, so I don't know who the original creator is. I also redesigned many of them, but here are links to some of the orginal artists who created these wonderful wallpapers:

Supporting project

You can support me simply by dropping a star on github or giving a subscription on YouTube.

If you enjoyed it and would like to show your appreciation, you can make a donation using kofi.

![Ko-fi](https://img.shields.io/badge/support_me_on_ko--fi-F16061?style=for-the-badge&logo=kofi&logoColor=f5f5f5)

Distributed under the GPLv3+ License.
Copyright (C) 2022-2025 Keyitdev.

GitHub Flavored Markdown (github-markdown-css)README snapshot at abb3163c72