Troubleshooting

Clicks land in the wrong place, or the game looks stretchedCopy Anchor Link

The game's window was resized (tiling window managers do this) while the game kept its own resolution. Install gamescope and omavn uses it automatically:

sudo pacman -S gamescope   # or your distro's package; on Omarchy: omavn omarchy setup

If gamescope misbehaves on your GPU, fall back to a floating window with omavn set <game> display window and make sure your window manager doesn't tile it.

The game shows a settings dialog firstCopy Anchor Link

Many VNs open a launcher or config dialog before the game, on Windows too. Pick your options and start the game; most have a "don't show again" box.

An installer opened a windowCopy Anchor Link

omavn runs NSIS, Inno Setup, and MSI installers unattended. Other frameworks (InstallShield, custom installers) need you to click through. Any install location works; omavn finds the game afterwards.

Japanese text is garbledCopy Anchor Link

Untranslated Japanese releases often expect a Japanese system locale (their text is Shift-JIS):

omavn set <game> locale ja

The locale is generated inside Proton's container, so you don't need it installed on your system. Undo with omavn set <game> locale.

Use a different ProtonCopy Anchor Link

omavn runtime list
OMAVN_PROTON=GE-Proton11-9 omavn run <game>

See what's actually runningCopy Anchor Link

omavn run <game> --print

prints the full command, environment, and working directory, so you can run it by hand and read the output.

Still stuckCopy Anchor Link

omavn feedback --kind game --game <game> "what happened"