mirror of
https://github.com/GradienceTeam/Docs.git
synced 2024-05-03 11:17:23 +00:00
127 lines
3.3 KiB
ReStructuredText
127 lines
3.3 KiB
ReStructuredText
.. highlight:: shell
|
|
|
|
===================
|
|
🔌️ 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:
|
|
|
|
.. code-block:: console
|
|
|
|
$ flatpak run com.github.GradienceTeam.Gradience
|
|
|
|
For System package:
|
|
|
|
.. code-block:: console
|
|
|
|
$ 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:
|
|
|
|
.. code-block:: console
|
|
|
|
$ 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:
|
|
|
|
.. code-block:: console
|
|
|
|
$ gsettings set org.gnome.desktop.interface gtk-theme 'Adwaita'
|
|
|
|
Check the `settings.ini` files and remove lines that contain `gtk-theme`
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
.. code-block:: console
|
|
|
|
$ cat ~/.config/gtk-3.0/settings.ini
|
|
|
|
.. code-block:: console
|
|
|
|
$ cat ~/.config/gtk-4.0/settings.ini
|
|
|
|
Check if there are theme override in environment:
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
.. code-block:: console
|
|
|
|
$ cat ~/.bash_profile
|
|
|
|
.. code-block:: console
|
|
|
|
$ cat ~/.bashrc
|
|
|
|
Remove `GTK_THEME=<THEME_NAME>` if present
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Check if there are theme overrides for Flatpak:
|
|
|
|
|
|
User:
|
|
|
|
.. code-block:: console
|
|
|
|
$ cat ~/.local/share/flatpak/overrides/global
|
|
|
|
System:
|
|
|
|
.. code-block:: console
|
|
|
|
$ cat /var/lib/flatpak/overrides/global
|
|
|
|
If the file are something like this:
|
|
|
|
.. code-block::
|
|
|
|
[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 <https://matrix.to/#/#Gradience:matrix.org>`_ or `Discord <https://discord.com/invite/4njFDtfGEZ>`_ rooms, we will try our best to help you
|