ii-sddm-theme

video-showcase.mp4

Overview

ii-sddm-theme is a custom theme for the SDDM display manager that tries to replicate the lockscreen aesthetic and settings of illogical impulse. It can be used with ii dotfiles, with Matugen only, or as a standalone theme.

I only have a basic understanding of Qt QML, so this project is a learning experience and mostly about together code from various sources while figuring things out along the way. I also get a ton of help from ai models.

Currently supports: Arch Linux + Hyprland, to be extended

---

Acknowledgements

This theme wouldn't exist without these projects:

• illogical impulse – All the widgets code, the design and the creativeness comes from end-4 repo
• win11-sddm-theme – An amazing win 11 sddm theme, which i used for the waffle implementation
• sddm-astronaut-theme – The starting point for this theme
• SilentSDDM – Custom virtual keyboard implementation and various improvements
• matugen - Material You color palette generator
• qt/qtvirtualkeyboard – Default virtual keyboard style template

---

Features

Depending on your setup, you can choose from one to three different installation modes:

ii + Matugen Integration

Settings, wallpaper, and colors automatically synced from ii configuration

Matugen Integration Only

Wallpaper and colors generated via Matugen, with manual settings configuration

No Matugen Integration

Manually configure your background, colors, and settings

---

Installation

Install Script

The script will detect your configuration and guide you through the installation:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/3d3f/ii-sddm-theme/main/setup.sh)"

Note: Only Arch Linux + Hyprland is supported. Non-standard folder structures will require manual installation. If something goes wrong or you have some questions, please open an issue.

---

Manual Installation

Follow these steps for a manual installation. You'll choose your integration method after completing the initial setup.

1. Install Dependencies

Arch Linux:

yay -S --needed sddm qt6-svg qt6-virtualkeyboard qt6-multimedia-ffmpeg

2. Clone the Repository

git clone -b main --depth=1 https://github.com/3d3f/ii-sddm-theme
cd ii-sddm-theme/

3. Test the Theme

./test.sh

Note: The test appearance is not exactly representative of the theme look. If something goes wrong, open an issue.

---

Choose Your Integration Method

Select one of the following installation types based on your needs:

ii + Matugen Integration

This option is for users who have both illogical impulse and matugen configured and want the SDDM theme to automatically match their Hyprland settings, wallpapers, and color schemes.

4. Copy Integration Files

mkdir -p ~/.config/ii-sddm-theme/
cp -r iiMatugen/* ~/.config/ii-sddm-theme/
chmod +x ~/.config/ii-sddm-theme/sddm-theme-apply.sh
chmod +x ~/.config/ii-sddm-theme/generate_settings.py

5. Install the Theme

sudo mkdir -p /usr/share/sddm/themes/ii-sddm-theme
sudo cp -rf . /usr/share/sddm/themes/ii-sddm-theme/
sudo cp /usr/share/sddm/themes/ii-sddm-theme/fonts/ii-sddm-theme-fonts /usr/share/fonts/

6. Configure SDDM

Edit /etc/sddm.conf with your preferred editor:

sudo nano /etc/sddm.conf

Ensure these options are set:

[General]
InputMethod=qtvirtualkeyboard
GreeterEnvironment=QML2_IMPORT_PATH=/usr/share/sddm/themes/ii-sddm-theme/Components/,QT_IM_MODULE=qtvirtualkeyboard

[Theme]
Current=ii-sddm-theme

7. Configure Matugen

Add this block to ~/.config/matugen/config.toml:

[templates.iisddmtheme]
input_path = '~/.config/ii-sddm-theme/SddmColors.qml'
output_path = '~/.config/ii-sddm-theme/Colors.qml'
post_hook = 'python3 ~/.config/ii-sddm-theme/generate_settings.py && sudo ~/.config/ii-sddm-theme/sddm-theme-apply.sh &'

8. Configure Passwordless Sudo

Allow the apply script to run without a password prompt:

echo "$USER ALL=(ALL) NOPASSWD: /home/$USER/.config/ii-sddm-theme/sddm-theme-apply.sh" | sudo tee /etc/sudoers.d/sddm-theme-$USER > /dev/null
sudo chmod 0440 /etc/sudoers.d/sddm-theme-$USER

9. Apply the Theme

python3 ~/.config/ii-sddm-theme/generate_settings.py
sudo ~/.config/ii-sddm-theme/sddm-theme-apply.sh

10. Test the Theme

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

11. Reboot

Restart your system to see the theme in action.

Matugen Integration Only

This option uses matugen to generate color schemes from your wallpaper without illogical impulse. You'll manually manage theme settings.

4. Copy Integration Files

mkdir -p ~/.config/ii-sddm-theme/
cp -r Matugen/* ~/.config/ii-sddm-theme/
chmod +x ~/.config/ii-sddm-theme/sddm-theme-apply.sh

5. Install the Theme

sudo mkdir -p /usr/share/sddm/themes/ii-sddm-theme
sudo cp -rf . /usr/share/sddm/themes/ii-sddm-theme/

6. Configure SDDM

Edit /etc/sddm.conf with your preferred editor:

sudo nano /etc/sddm.conf

Ensure these options are set:

[General]
InputMethod=qtvirtualkeyboard
GreeterEnvironment=QML2_IMPORT_PATH=/usr/share/sddm/themes/ii-sddm-theme/Components/,QT_IM_MODULE=qtvirtualkeyboard

[Theme]
Current=ii-sddm-theme

7. Configure Matugen

Add this block to ~/.config/matugen/config.toml:

[templates.iisddmtheme]
input_path = '~/.config/ii-sddm-theme/SddmColors.qml'
output_path = '~/.config/ii-sddm-theme/Colors.qml'
post_hook = 'sudo ~/.config/ii-sddm-theme/sddm-theme-apply.sh &'

8. Configure Passwordless Sudo

echo "$USER ALL=(ALL) NOPASSWD: /home/$USER/.config/ii-sddm-theme/sddm-theme-apply.sh" | sudo tee /etc/sudoers.d/sddm-theme-$USER > /dev/null
sudo chmod 0440 /etc/sudoers.d/sddm-theme-$USER

9. Apply the Theme

sudo ~/.config/ii-sddm-theme/sddm-theme-apply.sh

10. Test the Theme

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

11. Reboot

Restart your system to see the theme in action.

No Matugen Integration

This option is for users who prefer full manual control over background, colors, and settings without any automation.

4. Copy Integration Files

mkdir -p ~/.config/ii-sddm-theme/
cp -r noMatugen/* ~/.config/ii-sddm-theme/
chmod +x ~/.config/ii-sddm-theme/sddm-theme-apply.sh

5. Install the Theme

sudo mkdir -p /usr/share/sddm/themes/ii-sddm-theme
sudo cp -rf . /usr/share/sddm/themes/ii-sddm-theme/

6. Configure SDDM

Edit /etc/sddm.conf with your preferred editor:

sudo nano /etc/sddm.conf

Ensure these options are set:

[General]
InputMethod=qtvirtualkeyboard
GreeterEnvironment=QML2_IMPORT_PATH=/usr/share/sddm/themes/ii-sddm-theme/Components/,QT_IM_MODULE=qtvirtualkeyboard

[Theme]
Current=ii-sddm-theme

7. Apply the Theme

sudo ~/.config/ii-sddm-theme/sddm-theme-apply.sh

8. Test the Theme

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

9. Reboot

Restart your system to see the theme in action.

---

Post-Installation

After installation, check the GUIDE.txt file in your ~/.config/ii-sddm-theme/ folder.

Uninstallation

Click to expand uninstallation instructions

To completely remove the theme from your system, follow these steps:

1. Remove Theme Files

sudo rm -rf /usr/share/sddm/themes/ii-sddm-theme
sudo rm -rf /usr/share/fonts/ii-sddm-theme-fonts

2. Remove Configuration Files

rm -rf ~/.config/ii-sddm-theme

3. Remove Sudo Permissions

sudo rm -f /etc/sudoers.d/sddm-theme-$USER

4. Remove Matugen Configuration

If you used Matugen integration, remove the theme configuration from ~/.config/matugen/config.toml:

nano ~/.config/matugen/config.toml

Remove the [templates.iisddmtheme] section.

5. Restore Default SDDM Theme

Edit /etc/sddm.conf:

sudo nano /etc/sddm.conf

Change or remove these lines:

[General]
InputMethod=
GreeterEnvironment=

[Theme]
Current=

Or set Current= to your preferred theme (you can check available themes in /usr/share/sddm/themes).

6. Optional: Remove Dependencies

Only remove sddm, qt6-svg, qt6-virtualkeyboard, and qt6-multimedia-ffmpeg if you're certain no other applications depend on them.

7. Reboot

Restart your system to apply the changes:

reboot

Cursor theme

This example is made with Bibata Modern Classic, but you can use any cursor theme. This workaround worked for me but may not work for everybody.

Install the cursor theme package (if you use ii you have it already)

yay -S bibata-cursor-theme-bin

Workaround

Backup and then edit /usr/share/icons/default/index.theme:

sudo nano /usr/share/icons/default/index.theme

Change or add these lines:

[Icon Theme]
Inherits=Bibata-Modern-Classic

• If this doesn't work for you Open an issue