r2modmac is a native mod manager for macOS/Windows/Linux that allows you to easily manage mods for Thunderstore supported games and Outer Wilds (via OWML). Designed with a modern and intuitive interface, it offers a smooth experience to install, update, and organize your favorite mods.
- Multi-Game Support: Browse Thunderstore communities and manage mods for supported game loaders
- Outer Wilds Support: Full support for Outer Wilds mods via OWML — browse, install and launch directly from the app
- Profile Management: Create and manage multiple profiles for different mod setups
- Browse Mode: Explore and discover mods without creating a profile first
- Import/Export: Share your profiles with friends via codes or files
- Custom Profile Images: Add custom images to your profiles
- Fast Search: Intelligent caching system for instant searches
- Modern Interface: Clean and intuitive design optimized for macOS
- Dependency Management: Automatic installation of required dependencies
- Smart Install Modes:
- New Mode (Default): Install adds mods to your profile list. Download only when you click "Apply to Game" (saves disk space)
- Legacy Mode: Mods download immediately to a local cache when you click Install (faster but uses more storage)
These are the loaders currently handled by r2modmac. Other Thunderstore communities can still be browsed, but their mods may not install correctly.
| Loader | Status | Notes |
|---|---|---|
| BepInEx | ✅ Supported | Standard Thunderstore packages. |
| Lovely | ✅ Supported | Balatro mods and runtime. |
| ReturnOfModding | ✅ Supported | Risk of Rain Returns mods and runtime. |
| OWML | ✅ Supported | Outer Wilds; separate from the standard Thunderstore flow. |
| MelonLoader | ❌ Not supported | Loader-specific install and launch are not implemented. |
| Northstar | ❌ Not supported | Titanfall 2/Northstar integration is not implemented. |
| GDWeave | ❌ Not supported | WEBFISHING/GDWeave integration is not implemented. |
| Other custom loaders | ❌ Not supported | Requires a dedicated integration. |
If a loader is missing from this list, please open an issue before relying on it.
- React 19 - Modern UI framework with the latest features
- TypeScript - Type safety and better developer experience
- Tailwind CSS - Utility-first styling for consistent design
- Zustand - Lightweight and performant state management
- Vite - Lightning fast build tool for development and production
- Tauri 2 - Framework for native desktop applications using Rust
- Rust - Safe and performant language for backend logic
- Reqwest - HTTP client for communicating with Thunderstore API
- Tokio - Asynchronous runtime for non-blocking operations
- Serde - JSON serialization/deserialization
- @tanstack/react-virtual - List virtualization for optimal performance
- adm-zip - ZIP archive management for mods
- js-yaml - Profile configuration file parsing
- regex - Pattern matching for parsing and validation
Download the latest version from the releases page.
If you see this error when opening the app, it's because it hasn't been signed with an Apple Developer certificate.
Quick fix:
sudo find /Applications/r2modmac.app -exec xattr -c {} \;Enter your password when prompted, then try opening the app again.
- Node.js 18+
- Rust 1.77+
- Xcode Command Line Tools
# Clone the repository
git clone https://github.com/Zard-Studios/r2modmac.git
cd r2modmac
# Install dependencies
npm install
# Start in development mode
npm run dev
# Build for production
npm run tauri buildContributions are welcome! Feel free to:
- 🐛 Report bugs
- 💡 Propose new features
- 🔧 Submit pull requests
This project is released under the MIT License. You can use, modify, and distribute it freely, as long as you maintain the original credits.
- r2modman - Inspiration for the project
- Thunderstore - API for mods and community
- OWML - Outer Wilds Mod Loader
- Tauri - Framework for desktop applications
If you like the project, leave a star! ⭐
r2modmac is and will always remain open-source. It has no analytics or telemetry, and it does not share personal data or application content. Optional text-only sponsored messages help support development and can always be disabled in Settings. I dedicate all my free time to it as a student and independent developer. If this tool has saved you hours of configuration and headaches, please consider supporting its development with a micro donation!
Made with ❤️ for the modding community