-
Notifications
You must be signed in to change notification settings - Fork 7
Common Issues & Compatibility
I know most of you love this theme, and I truly appreciate your support! However, making it compatible with every setup is a challenging task. Currently, the theme is mostly compatible with Arch and Debian-based systems. This wiki page covers the most common issues and their fixes. In the future, I'll also migrate configuration settings from the README to this page for better accessibility.
Thank you for using my theme and motivating me to keep improving it! <3
If the door animation video and background video are playing slowly, this issue is likely caused by using an older version of Qt. To fix this:
Add the following line to the end of your /etc/sddm.conf
file:
MinimumQtVersion=6.2.0
This ensures that SDDM will use a compatible version of Qt for better video playback.
Run the following command to verify that you have Qt6 installed:
qmake6 --version
If the command fails or shows an older version, proceed to install Qt6 as described below.
Arch Linux users can easily install Qt6 via the official repositories:
sudo pacman -Syu
sudo pacman -S qt6-base
qmake6 --version
For Debian or Ubuntu-based systems, you may need to add the appropriate repository and then install Qt6:
sudo apt update
sudo apt upgrade
sudo apt install qt6-base-dev
qmake6 --version
Older versions of Qt (pre-6.2) lack support for certain features and optimizations that modern SDDM themes utilize. These older versions can cause video playback to lag or stutter. By specifying MinimumQtVersion=6.2.0
, you are instructing SDDM to use a Qt version that includes the required enhancements for smooth video playback.
If you still encounter issues after updating Qt and the configuration file, ensure that your system's hardware acceleration is properly configured for Wayland or Xorg.
If you're unable to log in, there could be several reasons for the problem. Here's a breakdown of the most likely causes and solutions:
The most common reason for login issues is entering the wrong username or password. Double-check what you've entered.
If you downloaded the theme from the KDE Store, first, thank you for reading the warning and visiting this page! As mentioned in the warning, you can log in using the default credentials provided below:
Default username:churchy
Default password:123123
These credentials are only for users who installed the theme via the KDE Store.
For those who can't log in and want to verify or update their credentials, follow these steps:
/usr/share/sddm/themes/genshin-sddm-theme/components/credentials.txt
Add or update the username and password in this file. Here’s an example of how the file looks:
username1:password1
username2:password2
I understand that storing credentials in plain text without encoding is neither safe nor ideal. Unfortunately, QML currently doesn't support encoding, but I'm working on a better solution to address this limitation.
For now:
- Credentials stored in
credentials.txt
are safe since they require sudo permissions to access or modify. - Rest assured that I will release an update as soon as I find a more secure method for handling credentials.
I apologize for any inconvenience this may have caused. Thank you for your patience and understanding as I work to improve the theme! 😊
Unfortunately, this theme is mostly compatible with Arch and Debian-based systems.
You are free to manually install the dependencies for your distribution and try it out, but the installation script currently supports only these two families of Linux distributions.
I understand the importance of broader compatibility, and I plan to expand support for more distributions in the future. However, this may take some time as I’m working solo on this project while also managing my studies as a university student.
Thank you for your understanding and patience! 😊
The Column/Row error issue arises because the theme I created was based on another theme that had serious issues with columns and rows. As a result, this theme is optimized to work best with a resolution of 1920x1080 and resolutions close to that.
However, don't worry—the installation script already checks for your screen resolution and prompts you to adjust it if necessary.
Keep in mind that the installation script only changes the resolution specifically for the SDDM theme. It will set the theme to fullscreen no matter what resolution you're using, ensuring that the theme runs correctly.
For optimal results, it's recommended to use a resolution that fits your display's aspect ratio:
- For 16:9 aspect ratio, the best resolution is 1920x1080.
- For 16:10 aspect ratio, the best resolution is 1920x1200.
While it’s possible to manually adjust the resolution for SDDM, I don't recommend doing it manually through xrandr commands in your Xorg scripts. This could lead to significant issues. Instead, use the theme installer to change the resolution for the theme, or simply add your own custom xrandr settings to your Xorg script if you prefer.
Column and row errors mostly don’t affect functionality and are being addressed in ongoing optimization fixes. As of today, most of these errors have already been resolved, but I may rewrite the entire theme based on a different, more compatible one in the future to improve compatibility even further.
However, as I mentioned earlier, I don’t have a lot of time recently, so this may take some time.
Thank you for your patience and support while I continue to improve the theme! 😊
This issue occurs when the module hasn’t been registered properly. It’s usually related to incorrect dependencies, especially if you installed them manually.
The "Cannot protect module" error is often caused by faulty installations of Qt plugins, especially when dependencies aren’t installed correctly or are missing. This issue typically arises when dependencies are installed manually rather than through the proper package manager.
To fix this issue, you can force reinstall the Qt plugin that's causing the problem. For example, if the error is related to QtQuickControls 2, you can use the following command on Arch-based systems:
sudo pacman -S qt5-quickcontrols2 --overwrite '*'
This command forces the reinstallation of the qt5-quickcontrols2
package, ensuring that all necessary files are correctly installed. The --overwrite '*'
flag ensures that any conflicting or missing files are replaced.