⚠️ Important Update!

Steam has updated and if you accidentally update your Steam client to a version after 10/03/2026 then GreenLuma won't work! Use this command to revert your Steam version:

"C:\Program Files (x86)\Steam\steam.exe" -forcesteamupdate -forcepackagedownload -overridepackageurl http://web.archive.org/web/20260122074724if_/media.steampowered.com/client -exitsteam

---

SteaMidra (Education purposes only)

"Made/modified" by Midrag (me) and my brother!

Quick thing before we start remember to exclude the SteaMidra folder from Windows Security or at least the folder in this path for Creaminstaller Resources to work! sff\dlc_unlockers\resources

SteaMidra helps you set up games to work with Steam using Lua scripts, manifests, and GreenLuma. It writes the right files into your Steam folder so games and DLC can run. It does not replace or crack Steam itself.

Need help? Check the documentation or reach out to me Merium0 on the Discord and we'll sort it out. Discord server: https://discord.gg/yp3UA6QdBC

Small video about SteaMidra: https://youtu.be/HwAKjOGBfCc

Quick start

Step 1: Install dependencies

pip install -r requirements.txt

If that fails with a grpcio-tools build error (common on Windows), use:

pip install -r requirements-consumer.txt

If you get dependency conflicts with other projects on your system, use a virtual environment:

python -m venv venv
venv\Scripts\activate
pip install -r requirements-consumer.txt

Step 2: Download gbe_fork_tools

Download gbe_fork_tools (compiled) and paste the generate_emu_config folder inside third_party\gbe_fork_tools.

Step 3: Run SteaMidra

With Python:

• CLI: python Main.py
• GUI: python Main_gui.py

With the EXE:

• CLI: Run build_simple.bat, then run SteaMidra.exe (administrator preferred).
• GUI: Run pip install -r requirements-consumer.txt (or requirements.txt), then build_simple_gui.bat, then run SteaMidra_GUI.exe.

Step 4: GreenLuma

Download GreenLuma and set it up: https://www.up-4ever.net/h3vt78x7jdap

Extract the ZIP and use the AppList folder from GreenLuma when SteaMidra asks for it. Full steps are in the Setup Guide.

Optional: Windows desktop notifications: pip install -r requirements-optional.txt

GUI Version

SteaMidra has a full graphical interface.

Run with Python: python Main_gui.py

Build the GUI EXE:

1. Install dependencies: pip install -r requirements-consumer.txt (or requirements.txt)
2. Run build_simple_gui.bat
3. Run dist\SteaMidra_GUI.exe

What the GUI gives you:

• Pick your game from a dropdown (all Steam libraries scanned) or set a path for games outside Steam.
• All actions as buttons: crack, DRM removal, DLC check, workshop items, multiplayer fix, DLC unlockers, and more.
• Lua/manifest processing, AppList management, Steam patching, and library tools all accessible from buttons.
• Full settings dialog where you can edit, delete, export, and import all settings.
• Light and dark themes.
• Log output shown in the window so you can see what's happening.
• Any prompts that would normally appear in the terminal show up as dialog boxes instead.

The CLI version (Main.py / SteaMidra.exe) still works exactly the same as before.

What SteaMidra can do

• Download and use Lua files for games, download manifests, and set up GreenLuma.
• Write Lua and manifest data into Steam's config so games work with or without an extra injector.
• Other features: multiplayer fixes (online-fix.me), DLC status check, cracking (gbe_fork), SteamStub DRM removal (Steamless), AppList management, and DLC Unlockers (CreamInstaller-style: SmokeAPI, CreamAPI, Koaloader, Uplay).
• Parallel downloads, backups, recent files, and settings export/import.

AppList profiles (GreenLuma limit workaround)

GreenLuma has a hard limit of 130–134 App IDs. To use more games, use AppList profiles:

1. Manage AppList IDs → AppList Profiles (CLI) or the profiles option in the GUI
2. Create profile – creates an empty profile. Switch to it before adding more games.
3. Switch to profile – loads that profile's IDs into the AppList folder (truncated to the limit).
4. Save current AppList to profile – saves your current IDs into a profile (new or existing).
5. Delete / Rename – manage profile names and remove unused profiles.

When you reach 130 IDs, SteaMidra will remind you to create a new profile. Create an empty profile, switch to it, then add more games.

What's new

See CHANGELOG.md for what changed in the latest update.

Documentation

Documentation index – Start here.

Setup Guide – What to install (including GreenLuma). User Guide – What each menu option does and how to add games.

Quick Reference – Commands and shortcuts.

Feature Guide – Parallel downloads, backups, library scanner, and more.

Multiplayer Fix – Using the online-fix.me multiplayer fix.

DLC Unlockers – Using DLC unlockers (CreamInstaller-style).

Requirements files

• requirements.txt – Full project (CLI, GUI, online-fix in one)
• requirements-consumer.txt – Runtime only, no grpcio-tools (use if grpcio-tools fails)

More details in INSTALL_DEPENDENCIES.md.

Troubleshooting

grpcio-tools build error – Use pip install -r requirements-consumer.txt instead.

Dependency conflicts – Use a virtual environment (see Step 1 above).

ModuleNotFoundError – Dependencies are not installed. Run pip install -r requirements-consumer.txt.

Credits

Made by Midrag and his brother.

Original SMD – SteaMidra is built on top of the original SMD (Steam Manifest Downloader) by jericjan. SMD remains the original project; SteaMidra extends it with more features.

GreenLuma – SteaMidra works alongside GreenLuma for AppList injection. GreenLuma is a separate tool and must be downloaded and set up independently.

gbe_fork – The "Crack a game" feature uses gbe_fork, a Steam emulator for running games offline. License in third_party_licenses/gbe_fork.LICENSE.

gbe_fork tools – Build and packaging tools for gbe_fork. License in third_party_licenses/gbe_fork_tools.LICENSE.

Steamless – The "Remove SteamStub DRM" feature uses Steamless by Atom0s for stripping Steam DRM from executables. License in third_party_licenses/steamless.LICENSE.

aria2 – Used internally for fast file downloads. License in third_party_licenses/aria2.LICENSE.

fzf – Used for fuzzy search in menus (CLI). License in third_party_licenses/fzf.LICENSE.

SteamAutoCrack – The SteamAutoCrack feature uses the SteamAutoCrack CLI by oureveryday. License in third_party_licenses/SteamAutoCrack.LICENSE.

CreamInstaller – The DLC Unlockers feature is inspired by and compatible with CreamInstaller. SteaMidra does not ship CreamInstaller; it provides its own implementation that follows similar behavior.

online-fix.me – The multiplayer fix feature downloads fixes from online-fix.me. SteaMidra is not affiliated with online-fix.me. An account on that site is required.

RedPaper – Credit to RedPaper for the Broken Moon MIDI cover, originally arranged by U2 Akiyama and used in Touhou 7.5: Immaterial and Missing Power. Touhou 7.5 and its assets are owned by Team Shanghai Alice and Twilight Frontier. SteaMidra is not affiliated with or endorsed by either party. All trademarks belong to their respective owners.

Use SteaMidra at your own risk.