> ## 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.

# SDDM Astronaut Theme

> Beautiful SDDM login screen theme with multiple styles and animated wallpapers

The SDDM Astronaut Theme is a modern login screen theme for the SDDM display manager, created by [Keyitdev](https://github.com/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

<Steps>
  <Step title="Install Dependencies">
    Install the required packages for your distribution:

    <CodeGroup>
      ```bash Arch Linux theme={null}
      sudo pacman -S sddm qt6-svg qt6-virtualkeyboard qt6-multimedia-ffmpeg
      ```

      ```bash Void Linux theme={null}
      sudo xbps-install -S sddm qt6-svg qt6-virtualkeyboard qt6-multimedia
      ```

      ```bash Fedora theme={null}
      sudo dnf install sddm qt6-qtsvg qt6-qtvirtualkeyboard qt6-qtmultimedia
      ```

      ```bash OpenSUSE theme={null}
      sudo zypper install sddm-qt6 libQt6Svg6 qt6-virtualkeyboard qt6-multimedia
      ```

      ```bash Debian Unstable theme={null}
      sudo apt install sddm libqt6svg6 qt6-virtualkeyboard-plugin libqt6multimedia6 \
        qml6-module-qtquick-controls qml6-module-qtquick-effects libxcb-cursor0
      ```
    </CodeGroup>

    <Note>
      You may also want to install additional video codecs like h.264 for animated wallpapers.
    </Note>
  </Step>

  <Step title="Clone the Repository">
    Clone the theme to the SDDM themes directory:

    ```bash theme={null}
    sudo git clone -b master --depth 1 \
      https://github.com/keyitdev/sddm-astronaut-theme.git \
      /usr/share/sddm/themes/sddm-astronaut-theme
    ```
  </Step>

  <Step title="Install Fonts">
    Copy the theme fonts to the system fonts directory:

    ```bash theme={null}
    sudo cp -r /usr/share/sddm/themes/sddm-astronaut-theme/Fonts/* /usr/share/fonts/
    ```
  </Step>

  <Step title="Configure SDDM">
    Set the theme in the SDDM configuration:

    ```bash theme={null}
    echo "[Theme]
    Current=sddm-astronaut-theme" | sudo tee /etc/sddm.conf
    ```
  </Step>

  <Step title="Enable Virtual Keyboard">
    Configure the virtual keyboard support:

    ```bash theme={null}
    echo "[General]
    InputMethod=qtvirtualkeyboard" | sudo tee /etc/sddm.conf.d/virtualkbd.conf
    ```
  </Step>
</Steps>

## Automatic Installation

For a quick setup on supported distributions (Arch, Void, Fedora, OpenSUSE), use the automated installer:

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

<Note type="warning">
  Always review scripts before running them from the internet.
</Note>

## Selecting a Theme

The SDDM Astronaut Theme includes multiple pre-made themes. To switch between them:

1. Edit the metadata file:
   ```bash theme={null}
   sudo nano /usr/share/sddm/themes/sddm-astronaut-theme/metadata.desktop
   ```

2. Change the `ConfigFile` line to your preferred theme:
   ```ini theme={null}
   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:

```bash theme={null}
sddm-greeter-qt6 --test-mode --theme /usr/share/sddm/themes/sddm-astronaut-theme/
```

<Note>
  The preview may differ slightly from the actual login screen depending on your system configuration.
</Note>

## 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:

```bash theme={null}
cat /etc/sddm.conf
```

### Missing Fonts

Ensure fonts are properly installed:

```bash theme={null}
fc-cache -fv
```

### Animated Wallpapers Not Working

Check that you have the multimedia codecs installed:

```bash theme={null}
# Arch Linux
sudo pacman -S qt6-multimedia-ffmpeg
```

## Credits

* **Original Author**: [Keyitdev](https://github.com/Keyitdev)
* **Based on**: [MarianArlt's SDDM Sugar Dark](https://github.com/MarianArlt/sddm-sugar-dark)
* **License**: GPLv3+

<Note type="info">
  Support the original creator on [Ko-fi](https://ko-fi.com/keyitdev) or by starring the [GitHub repository](https://github.com/Keyitdev/sddm-astronaut-theme).
</Note>