https://github.com/shiroblank/cvrmelonassistantlinux
Funny cvr mod manager for linux
https://github.com/shiroblank/cvrmelonassistantlinux
chilloutvr linux melonloader
Last synced: about 1 month ago
JSON representation
Funny cvr mod manager for linux
- Host: GitHub
- URL: https://github.com/shiroblank/cvrmelonassistantlinux
- Owner: ShiroBlank
- License: other
- Created: 2026-04-25T18:44:00.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-04-25T23:34:13.000Z (about 1 month ago)
- Last Synced: 2026-04-26T01:21:02.609Z (about 1 month ago)
- Topics: chilloutvr, linux, melonloader
- Language: Rust
- Homepage:
- Size: 560 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> [!NOTE]
> This project contains **vibe coded** code using [Claude](https://claude.ai) by Anthropic.
> It may contain bugs or behave unexpectedly. Use at your own risk, and please report issues on GitHub.
# CVR MelonLoader Assistant — Linux Port
A Linux port of [CVRMelonAssistant](https://github.com/Nirv-git/CVRMelonAssistant) by Nirv-git & knah, rewritten in Rust with a GTK4 GUI.
Ported and maintained by **[Kneesox](https://kneesox.moe)**.
---
## Features
- 🔍 Auto-detects ChilloutVR via Steam
- 📦 Browse, install, and uninstall mods from the CVRMG mod repository
- ⬆️ Detect and update outdated mods
- 🔗 Automatically resolves and installs mod dependencies on install
- ⬇️ Install / update / remove MelonLoader
- 🚫 Automatically quarantines mods marked **broken** or **retired** on update
- 👤 Detects user-installed mods not listed in CVRMG — shown separately, never auto-updated
- 🔎 Collapsible categories, search, and mod filtering
- 🐛 Log scanner — parses MelonLoader logs to diagnose issues and missing dependencies
- 🎨 Dark-themed GTK4 GUI
---
## Installation
### Arch Linux, Manjaro, EndeavourOS, Steam Deck, and other Arch-based distros
Install from the AUR — the package always tracks the latest commit, so no manual version updates are needed:
```bash
paru -S cvr-melon-assistant-git
# or
yay -S cvr-melon-assistant-git
```
### AppImage — any distro
Pre-built AppImages are available on the [Releases page](https://github.com/ShiroBlank/CVRMelonAssistantLinux/releases):
```bash
chmod +x CVRMelonAssistant-x86_64.AppImage
./CVRMelonAssistant-x86_64.AppImage
```
### Build from source
**Requirements:** Rust 1.85+, GTK4 dev libraries, OpenSSL dev libraries.
Ubuntu / Debian
```bash
sudo apt install libgtk-4-dev pkg-config libssl-dev build-essential
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
cargo build --release
```
Fedora / RHEL
```bash
sudo dnf install gtk4-devel pkgconf openssl-devel
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
cargo build --release
```
Arch Linux (manual build)
```bash
sudo pacman -S gtk4 pkgconf openssl base-devel
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
cargo build --release
```
The binary will be at `target/release/cvr-melon-assistant`.
---
## MelonLoader + Proton
ChilloutVR is a **Windows-only** game running via **Steam Play (Proton)** on Linux. Add this to ChilloutVR's Steam launch options to enable MelonLoader:
```
WINEDLLOVERRIDES="version=n,b" %command%
```
---
## Credits
| | |
|---|---|
| Original Windows app | [Nirv-git & knah](https://github.com/Nirv-git/CVRMelonAssistant) |
| Linux port | [Kneesox](https://kneesox.moe) |
| AI assisted via | [Claude](https://claude.ai) by Anthropic |
| Log scanner ported from | [Lumbot](https://github.com/Slaynash/Lumbot) by Slaynash |
| Mod repository | [CVRMG](https://api.cvrmg.com/v1/mods) |
| Mod loader | [MelonLoader](https://melonwiki.xyz) by LavaGang |