ModUpdater

Keep your Minecraft mods up to date — with one click.

---

ModUpdater is a desktop application that scans your Minecraft mods folder, reads metadata from .jar files, and checks for updates via Modrinth or CurseForge APIs.

Built with Python and customtkinter for a modern, clean interface.

Features

• Scan any mods folder (auto-detects mods subdirectory)
• Reads mod metadata from fabric.mod.json, META-INF/mods.toml, META-INF/neoforge.mods.toml, mcmod.info
• Falls back to filename-based version detection
• Modrinth support — no API key required
• CurseForge support — requires a free API key from console.curseforge.com
• Dark / light theme toggle with smooth animation
• Clean card-based UI with rounded corners
• One-click download links to mod pages

Download

Pre-built executables are available on the Releases page.

Just download ModUpdater.exe, run it, and you're ready to go.

Usage

1. Launch the application
2. Click Browse and select your Minecraft mods folder (e.g. %appdata%\.minecraft\mods)
3. Set your Minecraft version and mod loader (Fabric / Forge / NeoForge / Quilt)
4. Choose the source: Modrinth (no key needed) or CurseForge (API key required)
5. Click Check for Updates
6. Download updates directly from the mod page links

Note: CurseForge uses name-based search — it may occasionally point to the wrong mod.

Build from Source

Prerequisites

• Python 3.10 or newer
• pip

Setup

pip install -r requirements.txt
python main.py

Build a standalone .exe

pip install pyinstaller
python -m PyInstaller --noconfirm --onefile --windowed --collect-all customtkinter --add-data "logo.ico;." --icon logo.ico --name ModUpdater main.py

Or use the build script:

.\build.ps1

The executable will be created at dist\ModUpdater.exe.

Project Structure

File	Description
main.py	Application entry point
ui.py	Graphical user interface (customtkinter)
mod_scanner.py	.jar scanning and metadata parsing
modrinth_api.py	Modrinth API client
curseforge_api.py	CurseForge API client
requirements.txt	Python dependencies
build.ps1	Build script for PyInstaller
logo.ico	Application icon

License

This project is licensed under the GNU General Public License v3.0 — see the LICENSE file for details.

---

Made by Arekmas