2.3 KiB
2.3 KiB
+++ title = "Troubleshooting" slug = "troubleshooting" weight = 4 +++
Troubleshooting
Here you will find help if something doesn't work, if the issue isn't listed here please open an issue on the GitHub repo.
Eww does not compile
- Make sure that you are compiling eww using the nightly rust toolchain.
- Make sure you have all the necessary dependencies. If there are compile-errors, the compiler will tell you what you're missing.
Eww does not work on wayland
- Make sure you compiled eww with the
--no-default-features --features=waylandflags. - Make sure that you're not trying to use X11-specific features (these are (hopefully) explicitly specified as such in the documentation).
My scss isn't being loaded!
- You have not created a scss file
- The scss file isn't called correctly. (it should be called
eww.scssin the$HOME/.config/ewwfolder) - The scss file isn't placed in the correct location (check above)
If none of these fixed your problem open an issue on the GitHub repo, or check the GTK-Debugger.
Eww can't find my configuration file!
- It's incorrectly named or it's in the wrong place (it should be called
eww.xmlin the$HOME/.config/ewwfolder) - You haven't started eww correctly or you started it wrong.
Something isn't styled correctly!
- You have mistyped the CSS class.
- Check the GTK-Debugger
General issues
You should try the following things, before opening a issue or doing more specialized troubleshooting:
- Kill the eww daemon by running
eww killand restart it witheww --debug daemonto get additional log output. - Now you can take a look at the logs by running
eww logs. - use
eww state, to see the state of all variables - use
eww debug, to see the xml of your widget and other information - update to the latest eww version
- sometimes hot reloading doesn't work. restart the widget in that case
If you're experiencing issues printing variables, try to print them in quotes, so e.g.
onchange="notify-send '{}'"
Remember, if your issue isn't listed here, open an issue on the GitHub repo.