eww/docs/content/main/troubleshooting.md

+++ 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.

My scss isn't being loaded!

1. You have not created a scss file
2. The scss file isn't called correctly. (it should be called eww.scss in the $HOME/.config/eww folder)
3. 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!

1. It's incorrectly named or it's in the wrong place (it should be called eww.xml in the $HOME/.config/eww folder)
2. You haven't started eww correctly or you started it wrong. (See Starting Eww)

Something isn't styled correctly!

1. You have mistyped the CSS class.
2. Check the GTK-Debugger

General issues

You should try the following things, before opening a issue or doing more specialized troubleshooting:

• Try killing the eww daemon with eww kill and run again
• If you're running with -d, run without -d to see output, or run eww logs to see the logs written by eww. These logs are stored in ~/.cache/eww.log.
• 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.