r2modmac

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #cli #dsh #claude-code #codex #developer-tools #react

★ 57 Open GitHub ↗

A native macOS/Windows mod manager that uses the official Thunderstore API.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# r2modmac

## Description

r2modmac is a native mod manager for macOS/Windows 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.

## Supporting development

r2modmac is not ad-free: it can occasionally show a short, clearly labelled **text-only sponsored message** to help fund development. There are no banner images, pop-ups, video ads, or interruptions to installing, updating, syncing, or playing.

Sponsored messages are enabled by default and can be disabled at any time from **Settings → Support r2modmac**. Disabling them immediately stops future sponsor requests and removes cached messages; every core feature of the app continues to work exactly the same.

We do not send your installed mods, profiles, local files, paths, configuration, or other app content to the sponsor service. See [Sponsored messages](docs/sponsored-messages.md) for the full data boundary.

## Features

- **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)

## 📸 Screenshots

### Game Selection
![Game Selection](https://github.com/user-attachments/assets/936d2fe6-3fd9-4359-9ab3-ef5b3266e0c4)

### Profile Management
![Profile Management](https://github.com/user-attachments/assets/2961952b-5dac-4eda-967e-0c425774b030)

### Browse Mods
![Mod Browser](https://github.com/user-attachments/assets/680d8bf7-4bf3-4102-87bf-132655803a61)
</div>

## Mod loader compatibility

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](https://github.com/Zard-Studios/r2modmac/issues) before relying on it.

## 🛠️ Technologies Used

### Frontend
- **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

### Backend
- **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

### Key Libraries
- **@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

## 📥 Installation

### Download
Download the latest version from the [releases page](https://github.com/Zard-Studios/r2modmac/releases).

### Troubleshooting

#### "The application is damaged and can't be opened"
If you see this error when opening the app, it's because it hasn't been signed with an Apple Developer certificate.

**Quick fix:**
```bash
sudo find /Applications/r2modmac.app -exec xattr -c {} \;
```

Enter your password when prompted, then try opening the app again.

## 🚀 Development

### Prerequisites
- Node.js 18+
- Rust 1.77+
- Xcode Command Line Tools

### Setup
```bash
# 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 build
```

## 🤝 Contributing

Contributions are welcome! Feel free to:
- 🐛 Report bugs
- 💡 Propose new features
- 🔧 Submit pull requests

## 📝 License

This project is released under the MIT License. You can use, modify, and distribute it freely, as long as you maintain the original credits.

## 🙏 Acknowledgments

- [r2modman](https://github.com/ebkr/r2modmanPlus) - Inspiration for the project
- [Thunderstore](https://thunderstore.io/) - API for mods and community
- [OWML](https://github.com/ow-mods/owml) - Outer Wilds Mod Loader
- [Tauri](https://tauri.app/) - Framework for desktop applications

## ⭐ Star History

If you like the project, leave a star! ⭐

## Star History

---

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**

[Report Bug](https://github.com/Zard-Studios/r2modmac/issues) · [Request Feature](https://github.com/Zard-Studios/r2modmac/issues)

</div>

r2modmac

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README