pleb
56 lines
2.1 KiB
Markdown
56 lines
2.1 KiB
Markdown
# ArrowVortex (Nix flake)
|
|
|
|
This flake packages [ArrowVortex](https://github.com/uvcat7/ArrowVortex) from the upstream Windows release zip and runs it with Wine. The default Wine prefix is `$XDG_DATA_HOME/arrowvortex/wine-<wine-version>` (or `~/.local/share/arrowvortex/wine-<wine-version>` when `XDG_DATA_HOME` is unset). Override with `WINEPREFIX` if you want a different prefix.
|
|
|
|
The versioned prefix deliberately leaves the old unversioned `arrowvortex/wine` prefix alone. It was created by an earlier Wine build and does not reliably show ArrowVortex's native file dialog. The new default starts with a clean compatible prefix; your Windows `Z:` drive still exposes your normal Linux files.
|
|
|
|
## Run from a local checkout
|
|
|
|
```bash
|
|
nix run .
|
|
```
|
|
|
|
```bash
|
|
nix build .
|
|
./result/bin/arrowvortex
|
|
```
|
|
|
|
Run directly from Git
|
|
|
|
```bash
|
|
nix run git+https://git.plebsaber.stream/arrowvortex-wine
|
|
```
|
|
|
|
## 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. The packaged Wine 11.0 launcher has been verified on KDE Plasma Wayland: **File → Open** opens Wine's `Open file` dialog.
|
|
|
|
## Debugging
|
|
|
|
The launcher defaults to quiet Wine logging, but respects `WINEDEBUG` when you set it. Use focused channels around dialogs, shell integration, and file APIs:
|
|
|
|
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
|
|
```
|