modiodirect 1.0.0

Crash-proof direct downloader for mod.io (official API only)

ModioDirect v1.0.0

**ModioDirect is a lightweight, single-file CLI that reliably downloads mods straight from mod.io via the official API—safe, fast, and free for use. It also allows manual downloads using an API key, bypassing the official game client. Supports games like Space Engineers, SnowRunner, and more.

Features

• Official mod.io API only
• Validates API key
• Supports real mod.io URLs
• Fallback search when slugs fail
• Safe downloads with retries
• Progress bar (tqdm optional)
• Works on Windows & Linux
• Optional --no-config for shared machines

Requirements

• Python 3.9+
• pip install requests tqdm

How To Use It

python modiodirect.py OR double click the modiodirect.py

Add Your Mod.io API Key E.g

0923d9369664ba08bd91c67.........

(optional) To avoid saving the API key to config.json:

python modiodirect.py --no-config

Paste a URL like:

https://mod.io/g/GAME/m/example-mod

:exclamation: Security Notice:

Your mod.io API key is private. Never share it or post it publicly. ModioDirect stores the key locally and only uses it to communicate with the official mod.io API.

SIMPLY WALKTHROUGH:

Why this exists

Most mod.io download tools are broken, outdated, or unsafe—and frankly, frustrating to use. ModioDirect was made to fix that: simple, reliable, and safe. It gives you full control, letting you manually download mods with an API key and even bypass the official game client when needed. No clutter, no crashes, just the mods you want, when you want them.

Legal

This tool uses the official mod.io API. Users are responsible for complying with mod.io's Terms of Service. This tool is not affiliated with, endorsed by, or officially supported by mod.io. Use at your own risk.

🔴Access limitations (important)🔴

Some games/mods are private, unlisted, or require OAuth access. In those cases, the mod.io API returns 404 even if the URL exists. This is an access restriction, not a bug in ModioDirect.

If you see:

[Error] Game not accessible (404). The game may be private, unpublished, or require OAuth access.

API Key Limitations Use a public game or mod to verify that your API key is working. API keys can only access publicly available content. Private or unlisted mods are not accessible using API keys alone, as they require OAuth-based authentication. OAuth support is not currently implemented in ModioDirect. Future updates may add OAuth support if permitted by mod.io’s policies.

Upcoming Features Updates

ModioDirect is actively maintained. The following features are planned for future releases:

• Batch mod downloads Download multiple mods in one run using a text file containing mod.io URLs.
• Optional auto-install to game mod folders Detect common game mod directories (opt-in only, user confirmation required).
• Windows standalone executable (.exe) A portable build for Windows users that does not require Python.
• PyPI package distribution Install ModioDirect using pip install modiodirect and run it as a system command.

🌟 Special Thanks

Thanks to @Diversion-CTF For helping with the logo

🤝 Contributions and feature requests are welcome

Please open an issue to discuss your ideas or suggestions.