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 a recent version of rust (run
rustup update
to be sure you have the latest version available) - 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=wayland
flags. - Make sure that you're not trying to use X11-specific features (these are (hopefully) explicitly specified as such in the documentation).
My configuration is not loaded correctly
- Make sure the
eww.yuck
andeww.(s)css
files are in the correct places. - Sometimes, eww might fail to load your configuration as a result of a configuration error. Make sure your configuration is valid.
Something isn't styled correctly!
Check the GTK-Debugger to get more insight into what styles GTK is applying to which elements.
General issues
You should try the following things before opening an issue or doing more specialized troubleshooting:
- Kill the eww daemon by running
eww kill
and re-open your window with the--debug
-flag to 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 structure of your widget and other information. - Update to the latest eww version.
- Sometimes hot reloading doesn't work. In that case, you can make use of
eww reload
manually.
Remember, if your issue isn't listed here, open an issue on the GitHub repo.