https://github.com/catppuccin/sddm
π Soothing pastel theme for SDDM
https://github.com/catppuccin/sddm
catppuccin hacktoberfest sddm theme
Last synced: 2 months ago
JSON representation
π Soothing pastel theme for SDDM
- Host: GitHub
- URL: https://github.com/catppuccin/sddm
- Owner: catppuccin
- License: mit
- Created: 2022-02-02T16:14:22.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-08-06T23:59:08.000Z (2 months ago)
- Last Synced: 2025-08-07T01:21:24.958Z (2 months ago)
- Topics: catppuccin, hacktoberfest, sddm, theme
- Language: Just
- Homepage:
- Size: 978 KB
- Stars: 445
- Watchers: 7
- Forks: 17
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - catppuccin/sddm - π Soothing pastel theme for SDDM (Just)
- awesome-starred - catppuccin/sddm - π Soothing pastel theme for SDDM (QML)
README
![]()
Catppuccin for SDDM
![]()
![]()
## Previews
π» Latte
πͺ΄ FrappΓ©
πΊ Macchiato
πΏ Mocha
## Usage
1. Ensure you have installed the [dependencies](#dependencies) for your operating system.
2. Download your chosen flavour + accent zip file from the [latest GitHub release](https://github.com/catppuccin/sddm/releases/latest).
3. Unzip the file and move the resulting directory to `/usr/share/sddm/themes/`. E.g. to copy `catppuccin-mocha-mauve`:```bash
sudo mv -v catppuccin-mocha-mauve-sddm /usr/share/sddm/themes/catppuccin-mocha-mauve
```4. Edit the `/etc/sddm.conf` file and change the theme to `catppuccin--`. For example, `catppuccin-mocha-mauve`.
If you don't have this file, create the `/etc/sddm.conf` file and add the following lines:
```conf
[Theme]
Current=catppuccin-mocha-mauve
```5. Unfortunately, the theme does not work properly if SDDM is run on X11 and not Wayland - follow the instructions [here](https://wiki.archlinux.org/title/SDDM#Wayland) here if there are issues.
## Dependencies
### Arch Based OS
```bash
pacman -Syu qt6-svg qt6-declarative qt5-quickcontrols2
```### Debian Based OS
```bash
apt install --no-install-recommends qml-module-qtquick-layouts qml-module-qtquick-controls2 qml-module-qtquick-window2 libqt6svg6
```### RPM Based OS
```bash
dnf install qt6-qtquickcontrols2 qt6-qtsvg
```### Solus OS
```bash
eopkg install qt6-quickcontrols2 qt6-svg
```### NixOS
This theme is available in nixpkgs [`catppuccin-sddm`](https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/ca/catppuccin-sddm/package.nix).
Add the package to systemPackages, you can customize the theme by overriding the attributes:
```nix
environment.systemPackages = [(
pkgs.catppuccin-sddm.override {
flavor = "mocha";
font = "Noto Sans";
fontSize = "9";
background = "${./wallpaper.png}";
loginBackground = true;
}
)];
```Then set it as the theme in the sddm configuration, change the suffix to the flavor you set in the package override:
```nix
displayManager.sddm = {
enable = true;
theme = "catppuccin-mocha";
package = pkgs.kdePackages.sddm;
};
```## Configuration
- `Font`: The chosen font
- `FontSize`: The text size
- `ClockEnabled`: Whether the clock is on or off, this should be set to either `true` or `false`
- `CustomBackground`: When this is `true` it will read from `Background` to render the custom background image, this should be set to either `true` or `false`
- `Background`: This is the location of the background image, it is recomended to use the provided `backgrounds/` directory to store the images
- `LoginBackground`: This is a extra background around the login panel, this should be set to either `true` or `false`
- `UserIcon`: When this is set to `true` the user icon will be displayed, this should be set to either `true` or `false`## π Thanks to
- [DonutDev](https://github.com/DonutDev)
- [Isabelinc](https://github.com/Isabelincorp)
- [Isabel Roses](https://github.com/isabelroses)
- [a9lim](https://github.com/a9lim)Β
Copyright Β© 2021-present Catppuccin Org