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

• Uses only the official mod.io API
• Validates API keys before use
• Accepts standard mod.io URLs
• Fallback search when slugs fail to resolve
• Reliable downloads with automatic retries
• Optional progress bar via tqdm
• Runs on Windows and Linux
• --no-config flag for shared or temporary environments
• Batch mode for multiple mods
• Optional auto‑install on Windows (opt‑in)
• Available 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

❗ 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

Existing download tools for mod.io often suffer from stability issues, lack of maintenance, or security concerns. ModioDirect addresses these shortcomings by providing a reliable and transparent alternative. It enables manual mod downloads via API key and offers the option to bypass the official game client, giving users greater control without unnecessary complexity

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.