Skip to main content
Version: 0.3.0

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.

Ewwii does not compile​

  1. Make sure that you are compiling ewwii using a recent version of rust (run rustup update to be sure you have the latest version available)
  2. Make sure you have all the necessary dependencies. If there are compile-errors, the compiler will tell you what you're missing.

Ewwii does not work on Wayland​

  1. Make sure you compiled ewwii 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 ewwii.rhai and ewwii.(s)css files are in the correct places.
  2. Sometimes, ewwii 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 ewwii daemon by running ewwii 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 ewwii logs.
  • Use ewwii state to see the state of all variables.
  • Use ewwii debug to see the structure of your widget and other information.
  • Update to the latest ewwii version.
  • Sometimes hot reloading doesn't work. In that case, you can make use of ewwii reload manually.

Remember, if your issue isn't listed here, open an issue on the GitHub repo.