modiodirect 1.0.1

Direct mod.io downloader (official API only)

ModioDirect v1.0.1

**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, Deep Rock Galactic 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
• Batch mode support
• Optional auto‑install on Windows (opt‑in)
• Released on PyPI

Requirements

• Python 3.9+
• pip install requests tqdm

Install From PyPI

pip install modiodirect

Run:

modiodirect

How To Use It

python 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

Auto‑Install (Windows Only)

Install directly to a detected game mod folder (optional):

python ModioDirect.py <mod_url> --install

This will scan common Steam/Epic install locations and let you pick a mod folder.

Batch Download (Simple)

1. Create a text file (example: mods.txt)
2. Put one mod.io URL per line
3. In the app, type:

file:C:\path\to\mods.txt

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

• Windows standalone executable (.exe) A portable build for Windows users that does not require Python.

🌟 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.