Document wayland issue

README.md

@@ -13,29 +13,45 @@ nix build .
 ./result/bin/arrowvortex
 ```
 
-## Run directly from Git
-
-This flake lives at [https://git.plebsaber.stream/arrowvortex-wine](https://git.plebsaber.stream/arrowvortex-wine). Use a `git+https` flake reference (not the `github:` shorthand):
+Run directly from Git
 
 ```bash
 nix run git+https://git.plebsaber.stream/arrowvortex-wine
 ```
 
-Optional: install into your user profile:
-
-```bash
-nix profile install git+https://git.plebsaber.stream/arrowvortex-wine
-```
-
-Pin a branch or revision for reproducibility:
-
-```bash
-nix run 'git+https://git.plebsaber.stream/arrowvortex-wine?ref=main'
-nix run 'git+https://git.plebsaber.stream/arrowvortex-wine?rev=<commit-sha>'
-```
-
 ## Requirements
 
 - Nix with flakes enabled (`experimental-features = nix-command flakes`).
 
 Wine and GUI dependencies come from nixpkgs; you need a working display (X11 or Wayland) for the editor window.
+
+## Debugging
+
+Replace `-all` with focused Wine channels around dialogs, shell integration, and file APIs:
+
+```nix
+--set WINEDEBUG "+timestamp,+pid,+tid,+seh,+dialog,+commdlg,+shell,+ole,+file,+loaddll"
+```
+
+Most useful pieces:
+
+- `+commdlg`: common file dialog activity, likely the key one for `File > Open`.
+- `+dialog`: generic dialog/window creation.
+- `+shell`: shell folder / file picker integration.
+- `+ole`: COM/OLE calls, often involved in modern shell dialogs.
+- `+file`: filesystem open/stat failures after a path is chosen or dialog initializes.
+- `+seh`: exceptions that might be swallowed by the app.
+- `+loaddll`: missing DLL clues.
+- `+timestamp,+pid,+tid`: makes logs easier to follow.
+
+Run it from a terminal and capture stderr, for example:
+
+```bash
+WINEDEBUG="+timestamp,+pid,+tid,+seh,+dialog,+commdlg,+shell,+ole,+file,+loaddll" arrowvortex 2>&1 | tee /tmp/arrowvortex-wine.log
+```
+
+If that is too noisy, start with:
+
+```bash
+WINEDEBUG=+x11drv,+wayland,+commdlg 
+```