Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/FraVelz/Config-Sway/llms.txt

Use this file to discover all available pages before exploring further.

The SDDM Astronaut Theme is a modern login screen theme for the SDDM display manager, created by Keyitdev. It features beautiful designs, animated wallpapers, virtual keyboard support, and easy customization.

​
Features

  • 10+ Pre-made Themes: Choose from astronaut, black hole, cyberpunk, and more
  • Animated Wallpapers: Support for video wallpapers
  • Virtual Keyboard: Built-in on-screen keyboard support
  • Qt6 Based: Built with the latest Qt6 framework
  • Easy Installation: Automated setup script included
  • 1080p Optimized: Designed for Full HD displays

​
Installation

1

Install Dependencies

Install the required packages for your distribution:
sudo pacman -S sddm qt6-svg qt6-virtualkeyboard qt6-multimedia-ffmpeg
You may also want to install additional video codecs like h.264 for animated wallpapers.
2

Clone the Repository

Clone the theme to the SDDM themes directory:
sudo git clone -b master --depth 1 \
  https://github.com/keyitdev/sddm-astronaut-theme.git \
  /usr/share/sddm/themes/sddm-astronaut-theme
3

Install Fonts

Copy the theme fonts to the system fonts directory:
sudo cp -r /usr/share/sddm/themes/sddm-astronaut-theme/Fonts/* /usr/share/fonts/
4

Configure SDDM

Set the theme in the SDDM configuration:
echo "[Theme]
Current=sddm-astronaut-theme" | sudo tee /etc/sddm.conf
5

Enable Virtual Keyboard

Configure the virtual keyboard support:
echo "[General]
InputMethod=qtvirtualkeyboard" | sudo tee /etc/sddm.conf.d/virtualkbd.conf

​
Automatic Installation

For a quick setup on supported distributions (Arch, Void, Fedora, OpenSUSE), use the automated installer: 
sh -c "$(curl -fsSL https://raw.githubusercontent.com/keyitdev/sddm-astronaut-theme/master/setup.sh)"
Always review scripts before running them from the internet.

​
Selecting a Theme

The SDDM Astronaut Theme includes multiple pre-made themes. To switch between them:
  1. Edit the metadata file: 
    sudo nano /usr/share/sddm/themes/sddm-astronaut-theme/metadata.desktop
  2. Change the ConfigFile line to your preferred theme: 
    ConfigFile=Themes/astronaut.conf

​
Available Themes

  • astronaut.conf - Classic astronaut theme
  • black_hole.conf - Dark space theme with black hole
  • japanese_aesthetic.conf - Japanese-inspired design
  • pixel_sakura_static.conf - Pixel art cherry blossom
  • purple_leaves.conf - Purple and nature theme
  • cyberpunk.conf - Neon cyberpunk style
  • post-apocalyptic_hacker.conf - Dark hacker theme
  • hyprland_kath.conf - Animated Hyprland theme
  • pixel_sakura.conf - Animated pixel sakura
  • jake_the_dog.conf - Adventure Time themed

​
Preview Theme

You can preview the theme without logging out: 
sddm-greeter-qt6 --test-mode --theme /usr/share/sddm/themes/sddm-astronaut-theme/
The preview may differ slightly from the actual login screen depending on your system configuration.

​
Integration with Config-Sway

This theme is included in Config-Sway and can be installed via the main installation script. The theme coordinates with your Sway desktop environment to provide a cohesive visual experience.

​
Troubleshooting

​
Theme Not Loading

Verify SDDM is using the correct theme: 
cat /etc/sddm.conf

​
Missing Fonts

Ensure fonts are properly installed: 
fc-cache -fv

​
Animated Wallpapers Not Working

Check that you have the multimedia codecs installed: 
# Arch Linux
sudo pacman -S qt6-multimedia-ffmpeg

​
Credits

Support the original creator on Ko-fi or by starring the GitHub repository.

Build docs developers (and LLMs) love

Get started for freeTalk to us