r2modmac

A modern and native mod manager for macOS, inspired by r2modman, redesigned from scratch

Description

r2modmac is a native mod manager for macOS that allows you to easily manage mods for Thunderstore supported games. Designed with a modern and intuitive interface, it offers a smooth experience to install, update, and organize your favorite mods.

Features

• Multi-Game Support: Manage mods for all games available on Thunderstore
• 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

Profile Management

Browse Mods

🛠️ 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.

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:

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

# 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 - Inspiration for the project
• Thunderstore - API for mods and community
• Tauri - Framework for desktop applications

⭐ Star History

If you like the project, leave a star! ⭐

---

Made with ❤️ for the modding community

Report Bug · Request Feature