Skip to content

Troubleshooting

Can Cellek edited this page Jan 9, 2024 · 11 revisions

Configuration Issues

If the app is not working on your end:

  • You either did something nasty and broke down the app through config file
  • Or updated the app but forgot to update your configuration to match with new goodies

The most common problem for this issue is your config file is not valid or became obsolete with a new update.

With the v2.3.0, we now have error handling for issues. Below is an example that shows wallpaper configuration is missing on your end, caused by your version of configuration does not include the new versions wallpaper support settings. Screenshot 2023-04-13 at 18 24 21

If you haven't made any changes besides testing things out, you can click Erase and Delete All Data to reset back to the default configuration.

Otherwise, please follow these steps before opening an issue

  1. On your browser, open Developer Tools. The shortcuts to open it can vary on browsers, so please check your browser documentation about how to open it.
  2. Locate Storage tab in the Developer Tools panel.
  3. Open Local Storage from the storage tree
  4. On the storage list, you should see key-value pairs. Locate settings key
  5. Check if the value of settings is set
    • Check if settings key is present in the list
    • Check if it is a valid JSON file
    • Open default settings file in new tab
      • You can copy your own config file and paste it into your code editor. From there, you can compare it with the latest default configuration. Your file is most probably has obsolete structure.
      • You can delete settings to reset back to default configuration. Beware, it will remove all your configurations if you haven't backed it up yet.
  6. After fixing your data, paste settings data back.

If you are still having trouble, you can open an issue with your configuration and ask for help.

Clone this wiki locally