troubleshooting.rst

🔌️ Troubleshooting

Here are described most common issues with Gradience and guides how to fix them

Gradience doesn't start

There are number of reasons for this, they include the following:

• There are error in gtk.css
• There are issue with current build
• There are issue with the package

To get more info on why this happens launch Gradience from terminal:

For Flatpak:

$ flatpak run com.github.GradienceTeam.Gradience

For System package:

$ GTK_DEBUG=all gradience

If there are no logs, try updating Gradience or reinstalling it, if you are using system package try using Flatpak version instead

If the logs mention gtk.css, you can try removing both ~/.config/gtk-3.0/gtk.css and ~/.config/gtk-4.0/gtk.css using this command:

$ rm -rf .config/gtk-4.0 .config/gtk-3.0

Theme are reset after reboot or on next login

This issue is very common, it is caused either by Custom Accent Colors or Material You Color Theming extensions, this happens because they override the gtk.css theming file with their own, to solve that simply disable those extensions and re-apply the preset

Gradience looks broken

This can be caused by a lot of factors, some of them include:

• There are theme applied that are not compatible with Libadwaita
• There are set hardcoded theme in environment or in Flatpak override
• Your distribution are shipping custom theme out-of-the-box

To fix it try the following:

Set system theme to default Adwaita using:

• GNOME Tweaks
• This command:

$ gsettings set org.gnome.desktop.interface gtk-theme 'Adwaita'

Check the settings.ini files and remove lines that contain gtk-theme

$ cat ~/.config/gtk-3.0/settings.ini

$ cat ~/.config/gtk-4.0/settings.ini

Check if there are theme override in environment:

$ cat ~/.bash_profile

$ cat ~/.bashrc

Remove GTK_THEME=<THEME_NAME> if present

Check if there are theme overrides for Flatpak:

User:

$ cat ~/.local/share/flatpak/overrides/global

System:

$ cat /var/lib/flatpak/overrides/global

If the file are something like this:

[Context]
filesystems=/home/JohnDoe/.themes;/home/JohnDoe/.icons;/home/JohnDoe/.local/share/themes;/home/JohnDoe/.local/share/icons;

[Environment]
GTK_THEME=<THEME_NAME>

Then remove the GTK_THEME=<THEME_NAME>, in some cases adding unset-environment=GTK_THEME; to [Context] is required

My issue are not described here, what I can do?

You can ask for help in our Matrix or Discord rooms, we will try our best to help you