Update troubleshooting doc

end-4 · Feb 27, 2025 · d8cb9f4 · d8cb9f4
1 parent 738abb8
commit d8cb9f4
Showing 1 changed file with 9 additions and 3 deletions.
diff --git a/src/content/docs/en/i-i/04.troubleshooting.md b/src/content/docs/en/i-i/04.troubleshooting.md
@@ -15,7 +15,7 @@ We've already given you related notice in `install.sh` but some users ignored it
 
 The environment variable `$ILLOGICAL_IMPULSE_VIRTUAL_ENV` must be set properly, else the AGS config will not work.
 
-We've made a default config in `~/.config/hypr/hyprland/env.conf` but you need to make sure the file is included and the config is applied properly. A restart for Hyprland is often required.
+We've made a default config in `~/.config/hypr/hyprland/env.conf` but you need to make sure this config file is included in `~/.config/hypr/hyprland.conf`. A restart for Hyprland is often required.
 
 You may run `./diagnose` to recheck its value. The output should contain something like this:
 ```
@@ -29,13 +29,19 @@ Where `myself` represents the actual username. It should not be something like b
 ./diagnose: line 30: declare: ILLOGICAL_IMPULSE_VIRTUAL_ENV: not found
 [---EXIT 1---]
 ```
-or
+For the case above:
+- It's very likely that you're still using old `~/.config/hypr/hyprland.conf`, and forgot to replace its content with `~/.config/hypr/hyprland.conf.new`. Just run `cd ~/.config/hypr;mv hyprland.conf{,.old};mv hyprland.conf{.new,}`.
+- Ensure you have restarted Hyprland.
+
+Or
 ```
 [===diagnose===] declare -p ILLOGICAL_IMPULSE_VIRTUAL_ENV
 declare -x ILLOGICAL_IMPULSE_VIRTUAL_ENV="\$XDG_STATE_HOME/ags/.venv"
 [---SUCCESS---]
 ```
-For the case above, the `$XDG_STATE_HOME` is not expanded, which seems really weird (maybe a Hyprland bug?). In such case you may directly specify its value in `~/.config/hypr/custom/env.conf` as:
+For the case above, the `$XDG_STATE_HOME` is not expanded, which seems really weird (maybe a Hyprland bug?).
+- Make sure you have properly executed the `install-python-packages()` in `install.sh` which gives you a non-empty `~/.local/state/ags/.venv`.
+- You may directly specify its value in `~/.config/hypr/custom/env.conf` as:
 ```conf
 env = ILLOGICAL_IMPULSE_VIRTUAL_ENV, /home/myself/.local/state/ags/.venv
 ```