RimModManager

The Ultimate Cross-Platform Mod Manager for RimWorld

Features • Download • Installation • Wiki • Contributing

---

🎯 Why RimModManager?

Managing 200+ RimWorld mods shouldn't be painful. RimModManager is a free, open-source mod manager that works on any platform and supports any installation type - Steam, GOG, Proton, Wine, Flatpak, or standalone.

• ✅ No Steam required - Works with cracked/standalone versions
• ✅ Non-destructive - Uses symlinks, never modifies your mods
• ✅ Cross-platform - Windows, macOS, Linux (including Steam Deck!)
• ✅ Workshop downloads - Download mods without owning the game on Steam
• ✅ Conflict detection - Know which mods break each other

---

📸 Screenshots

Click to view screenshots

Mod Manager

Workshop Browser

Downloads

Game Launcher

Keyboard Shortcuts

---

📥 Download

⬇️ Download Latest Release (v0.6.0)

Platform	File	Notes
🐧 Linux	RimModManager-Linux-x64	chmod +x && ./RimModManager-Linux-x64
🪟 Windows	RimModManager-Windows-x64.exe	Portable — double-click to run
🪟 Windows	RimModManager-*-Setup.exe	Installer — one-click setup
🍎 macOS	RimModManager-macOS-x64.app	.app bundle — drag to Applications

Build manually from source (see below).

Quick Start (Linux)

# Download from releases page
chmod +x RimModManager-Linux-x64
./RimModManager-Linux-x64

Or Run from Source

git clone https://github.com/MrXploisLite/RimModManager.git
cd RimModManager
pip install PyQt6
python main.py

Build Your Own

pip install PyQt6 PyInstaller
python build.py

Output:

• Linux: dist/RimModManager-Linux-x64
• Windows: dist/RimModManager-Windows-x64.exe (to build installer: iscc installer.iss)
• macOS: dist/RimModManager-macOS-x64.app

---

✨ Features

🎮 Universal Game Detection Windows: Steam, GOG, standalone macOS: Steam, GOG, standalone Linux: Steam native, Proton, Flatpak, Wine, Lutris, Bottles, Heroic, standalone Auto-Setup Wizard: First-run guided setup — zero manual config needed 📦 Mod Management Drag-and-drop load order Symlink-based activation (non-destructive) Hover buttons (➕/➖) for quick toggle Search and filter mods Auto-sort by dependencies Uninstall mods safely

🔧 Workshop Integration Embedded Steam Workshop browser One-click download queue Parse entire Collections Batch downloads (single SteamCMD session) Check for mod updates View subscriber counts & ratings 📋 Profiles & Backups Save/load mod profiles Auto-backup before changes Import/export ModsConfig.xml Per-installation mod lists

🛠️ Advanced Tools

Tool	Description
Update Checker	Compare local mods vs Workshop versions
Conflict Resolver	Detect conflicts with fix suggestions
Enhanced Info	View Workshop stats (subs, favs, views)
Smart Launcher	Auto-detects Steam vs standalone
Lightweight Mode	Use system browser to save 100MB+ RAM

---

🔨 Build from Source

You can build a standalone executable that doesn't require Python to run.

1. Install Requirements

   pip install pyinstaller

2. Build

   python build.py

3. Result The executable will be in the dist/ folder.

   • Size: ~60-70MB (Lightweight)
   • Compression: Automatically uses UPX if installed
   • Portable: No installation required

---

🚀 Installation

Requirements

• Python 3.10+
• PyQt6 (required)
• PyQt6-WebEngine (optional, only for embedded Workshop browser)
• steamcmd (optional, only for Workshop downloads)

Quick Start

git clone https://github.com/MrXploisLite/RimModManager.git
cd RimModManager
python -m pip install PyQt6
# Optional for embedded Workshop browser:
# python -m pip install PyQt6-WebEngine
python main.py

📦 Windows Installation

Option 1 — Installer (recommended):

1. Download RimModManager-*-Setup.exe from Releases
2. Double-click and follow the wizard
3. Launch from Start Menu or Desktop shortcut

Option 2 — Portable:

1. Download RimModManager-Windows-x64.exe
2. Double-click to run

Option 3 — From source:

python -m pip install PyQt6
python main.py

# SteamCMD (for Workshop downloads)
# choco install steamcmd

🍎 macOS Installation

1. Download RimModManager-macOS-x64.app from Releases
2. Drag to Applications folder
3. Right-click → Open (first launch only, Apple Gatekeeper)

From source:

python -m pip install PyQt6
python main.py
brew install steamcmd

🐧 Linux Installation

Arch / CachyOS / EndeavourOS / Manjaro:

sudo pacman -S python python-pyqt6
# Optional for embedded Workshop browser:
# sudo pacman -S python-pyqt6-webengine
yay -S steamcmd

Ubuntu / Debian:

python -m pip install PyQt6
# Optional for embedded Workshop browser:
# python -m pip install PyQt6-WebEngine
sudo apt install steamcmd

Fedora:

python -m pip install PyQt6
# Optional for embedded Workshop browser:
# python -m pip install PyQt6-WebEngine
sudo dnf install steamcmd

🎮 Steam Deck Installation

# Switch to Desktop Mode
# Open Konsole and run:
python -m pip install --user PyQt6
# Optional for embedded Workshop browser:
# python -m pip install --user PyQt6-WebEngine
git clone https://github.com/MrXploisLite/RimModManager.git
cd RimModManager
python main.py

---

📖 Usage

First Launch

1. Run python main.py or the executable
2. The Auto-Setup Wizard guides you through setup
3. RimWorld installations are auto-detected
4. SteamCMD is auto-installed if needed

###日常管理

1. Select your RimWorld installation from dropdown
2. Manage mods with drag-and-drop or hover buttons
3. Apply changes with "Apply Load Order"
4. Play with the built-in launcher

Config Locations

Platform	Path
Windows	%APPDATA%/RimModManager/
macOS	~/Library/Application Support/RimModManager/
Linux	~/.config/rimmodmanager/

---

🔧 Troubleshooting

SteamCMD not found

Platform	Solution
Windows	Download from Steam or choco install steamcmd
macOS	brew install steamcmd
Arch Linux	yay -S steamcmd
Ubuntu	sudo apt install steamcmd

No installations detected

On first launch, the Auto-Setup Wizard will automatically scan your system. You can also:

• Click "🔄 Detect" to re-scan
• Click "➕ Add Custom" and browse to your RimWorld folder
• Supported: Steam, GOG, Lutris, Bottles, Heroic, and standalone installs

Mods not showing in game

1. Make sure you clicked "Apply Load Order"
2. Check if symlinks were created in your game's Mods folder
3. On Windows, you may need to run as Administrator for symlinks

---

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

• 🐛 Report bugs
• 💡 Request features
• 🔧 Submit PRs

---

📜 License

GPL-3.0 License - See LICENSE for details.

If you fork or distribute this code, you must:

• Keep the source code open
• Include the original license
• State your changes
• Use GPL-3.0 license

---

⭐ Star this repo if you find it useful!