eww/docs/src/troubleshooting.md
2021-11-15 14:31:23 +01:00

35 lines
1.8 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.](https://github.com/elkowar/eww/issues)
## Eww does not compile
1. Make sure that you are compiling eww using the nightly Rust toolchain.
2. 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
1. Make sure you compiled eww with the `--no-default-features --features=wayland` flags.
2. 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
1. Make sure the `eww.yuck` and `eww.scss` files are in the correct places.
2. 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](working_with_gtk.md#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](https://github.com/elkowar/eww/issues).