# omavn

> Play Windows visual novels on Linux. omavn unwraps whatever was downloaded (nested zips, split RARs, installers), installs it, and launches it natively (Ren'Py) or through Proton in gamescope. Every command accepts --json.

Install: `curl -fsSL https://omavn.dev/install.sh | sh`, then `omavn install <download>` and `omavn run <game>`.

## Docs

- [Quickstart](https://omavn.dev/llms.mdx/docs/content.md): From "I bought a visual novel" to playing it on Linux in two commands.
- [Installing omavn](https://omavn.dev/llms.mdx/docs/installing/content.md): One command to install, then omavn fetches what it needs.
- [Commands](https://omavn.dev/llms.mdx/docs/commands/content.md): Every omavn command. Add --json to any of them for machine-readable output.
- [How it works](https://omavn.dev/llms.mdx/docs/how-it-works/content.md): What happens between "omavn install" and the title screen.
- [Omarchy](https://omavn.dev/llms.mdx/docs/omarchy/content.md): Visual novels as a first-class part of your Omarchy desktop.
- [Compatibility](https://omavn.dev/llms.mdx/docs/compatibility/content.md): Games tested against their raw downloads.
- [Catalog](https://omavn.dev/llms.mdx/docs/catalog/content.md): Teach omavn about a specific game.
- [Troubleshooting](https://omavn.dev/llms.mdx/docs/troubleshooting/content.md): Common problems and fixes.
- [Feedback](https://omavn.dev/llms.mdx/docs/feedback/content.md): Bugs, game reports, and ideas, in one command.
- [For agents and scripts](https://omavn.dev/llms.mdx/docs/agents/content.md): JSON output, stable exit codes, and docs as plain text.
- [Contributing](https://omavn.dev/llms.mdx/docs/contributing/content.md): Add a game to the catalog, fix a bug, or build something on omavn.

## Optional

- [Everything in one file](https://omavn.dev/llms-full.txt)
- [Source](https://github.com/Tetraslam/omavn)