Skip to content

Bink-lab/SFF

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

259 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SteaMidra

Build and Package

Note

This is a fork of the original SteaMidra program with special enhancements designed to be feature-rich.

Original work by Midrag and his brother!

Downloads

Stable Releases

Download the latest stable version from the Releases page.

πŸŒ™ Nightly Builds (Experimental)

Get the absolute latest (potentially unstable) features by downloading the Nightly Release.

These builds are automatically updated on every commit to the main branch and are named using the short commit SHA (e.g., a1b2c3d):

  • Windows (Setup): SteaMidra-Windows-Setup-SHA.exe
  • Windows (Portable): SteaMidra-Windows-Portable-SHA.zip
  • Linux (AppImage): SteaMidra-Linux-AppImage-SHA.AppImage

Note: Nightly builds include automatic commit notes so you can see what changed since the last stable release.

Educational use only. Use at your own risk.

⚠️ Antivirus Warning: Before doing anything, add the entire SteaMidra folder (especially sff\dlc_unlockers\resources) to Windows Defender exclusions β€” the DLC unlocker tools inside trigger false positives.

To add exclusions: Windows Security β†’ Virus & threat protection β†’ Manage settings β†’ Exclusions β†’ Add or remove exclusions β†’ Add a folder.

SteaMidra helps you set up games to work with Steam using Lua scripts, manifests, and LumaCore. 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? Chat with us on our Discord server: https://discord.gg/V8aZqnbB84

Old SteaMidra setup tutorial (outdated): "Outdated" tutorial for new users

Python setup tutorial: Python Tutorial


Features

  • Download and use Lua files for games, download manifests, and set up LumaCore.
  • Write Lua and manifest data into Steam's config.
  • Multiplayer fixes: online-fix.me integration and game fixes/bypasses (Ryuu).
  • HyperVisor Cracks (HV Auto) β€” download HyperVisor bypasses for Denuvo-protected games. Includes VBS.cmd to prepare your system. See the HyperVisor Guide before use.
  • DLC status check, cracking (gbe_fork), SteamStub DRM removal (Steamless), and DLC Unlockers (CreamInstaller-style: SmokeAPI, CreamAPI, Koaloader, Uplay).
  • Multi-language GUI β€” English and Portuguese built-in; add more via sff/locales/.
  • Parallel downloads, backups, recent files, and settings export/import.
  • Linux support β€” SLSSteam ID management, platform-aware MIDI, and Linux-compatible auto-update.
  • Main tab "Download Game" β€” ⭐ THIS IS THE MAIN WAY TO DOWNLOAD GAMES. Downloads the latest version of a game directly from Steam (fast, no .NET required for Windows OS). Processes the Lua file, writes decryption keys, registers AppList/SLSsteam IDs, and triggers Steam to download the game files natively. Use this for 99% of games.
  • Store tab β€” browse Hubcap's manifest library to find games and download either using the Steam download function for downloading latest versions very quick or older or specific versions of a game via DepotDownloaderMod (.NET 9 required, slower). Use this only when you need a specific older version of a game, not the latest.

Quick start

Step 1: SteaMidra

Download the latest version from here. You will get a ZIP file (SteaMidra-x.x.x-windows.zip). Extract it anywhere β€” you will see a folder containing SteaMidra_GUI.exe and an _internal/ folder. Place this folder wherever you want (e.g. C:\SteaMidra\).

Do not run SteaMidra yet. Complete Steps 2 and 3 first so all folders exist before first launch.

Step 2: LumaCore

Open SteaMidra, go to the Home tab, click Auto LC Setup, then click Install LumaCore. SteaMidra downloads the latest LumaCore release from GitHub and installs dwmapi.dll + LumaCore.dll into the Steam folder, removing old GreenLuma files automatically.

If the install fails, ask on Discord.

Step 3: Launch Steam

Run SteaMidra_GUI.exe and add a game on the Home tab. LumaCore makes it appear in the Steam library immediately. See the User Guide for how to add games.

Running from source (Python)? See the Python Setup Guide.


GUI features

SteaMidra has a full graphical interface with a Modern UI (new in 5.5.0, updated in 6.0.0) and the classic Qt interface.

Modern UI β€” the new default interface, built with QWebEngine. Accessible from a clean sidebar with 8 tabs: Home (game picker with auto-refresh), Store (search/browse Hubcap, grid/list, pagination), Library (installed games), Downloads (live progress + history), Fix Game (full emulator pipeline), Tools (GBE Token Generator, VDF Extractor, Workshop), Cloud Saves (scan/backup/restore, Google Drive, rclone with 17 provider shortcuts, All Save Locations), and Settings. Supports 11+ themes, tooltips, and toast notifications.

What the GUI gives you:

  • Tabbed interface β€” Main, Store, Downloads, Fix Game, Tools, and Cloud Saves tabs.
  • 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, Fixes/Bypasses (Ryuu), DLC unlockers, and more.
  • Store browser β€” search and browse the Hubcap Manifest library with pagination. Download button opens a version picker with full depot/manifest history (SteamDB + GitHub mirror sources). Force Refresh button bypasses cache to re-scrape all historical manifests.
  • Fix Game pipeline β€” automate emulator application (Goldberg, ColdClient, ColdLoader) with SteamStub unpacking.
  • GBE Token Generator β€” generate full Goldberg emulator configs with achievements, DLCs, stats, and icons.
  • Cloud Saves β€” Steam userdata save backup/restore. Scans Steam/userdata/<steam32id>/ for all games with saves, back up and restore with one click (safety backup created automatically). Supports local folder, Google Drive (sign in once), and rclone (Dropbox, OneDrive, MEGA, S3, Backblaze B2, SFTP, and 70+ other backends β€” click a provider shortcut to pre-fill the remote format, then hit Setup in Terminal to configure it without leaving the app). All Save Locations scans every known emu save path (CODEX, EMPRESS, RUNE, OnlineFix, Goldberg, GSE, Steam userdata) and backs them all up in one operation.
  • VDF Key Extractor β€” extract depot decryption keys from Steam's config.vdf.
  • Lua/manifest processing and library tools all accessible from buttons.
  • Full settings dialog where you can edit, delete, export, and import all settings.
  • 11+ themes including Dracula, Nord, Cyberpunk, and more.
  • System tray icon for quick show/hide and exit.
  • Multi-language support β€” switch between English and Portuguese in Settings (more locales can be added).
  • Log viewer β€” "Logs" button in the menu bar (right of Help) opens a floating window showing all log output from every tab (Fix Game, Store, Tools, and more). Filterable by level (DEBUG/INFO/WARNING/ERROR), with Clear and Copy All buttons.
  • Any prompts that would normally appear in the terminal show up as dialog boxes instead.

Full changelog: CHANGELOG.md


Documentation

Documentation index – Start here.

Setup Guide – What to install (including LumaCore).

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.

Fixes/Bypasses (Ryuu) – Using Ryuu as a free, no-account alternative fix source.

CrakFiles β€” Fixes & Bypasses source – What the CrakFiles repository is, how SteaMidra fetches and uses crackfiles.json, and a breakdown of every field in the fix list.

HyperVisor Guide – How HV cracks work, security implications, and step-by-step setup for Denuvo HyperVisor bypasses.

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

Troubleshooting – Common problems and solutions.

Python Setup – Running or building from source.


Troubleshooting

See docs/TROUBLESHOOTING.md for common problems and solutions.


Credits

Made by Midrag and his brother.

LumaCore – Windows DLL hook library bundled with SteaMidra. Injects into Steam at startup via a dwmapi.dll proxy, reads Lua files from Steam/config/stplug-in/, and patches Steam's in-memory license tables so games appear owned without AppList files or Steam restarts.

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.

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. Bundled in third_party/SteamAutoCrack/cli/. 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.

GBE Token Generator – Goldberg Emulator configuration generation based on work by Detanup01 (gbe_fork), NickAntaris, and Oureveryday (generate_game_info).

Hubcap Manifest – Store browser and manifest library API provided by Hubcap Manifest (hubcapmanifest.com). Formerly known as Morrenus / Solus.

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.

README rewrite assisted by itsphox.

SteaMidra is licensed under the GNU General Public License v3.0 (see LICENSE file).

Disclaimer

This project is provided for research and educational purposes only. You are responsible for complying with local laws, platform terms of service, and software licenses.

About

SteaMidra - Full-featured Steam manifest tool with GUI, DLC unlockers (CreamAPI / SmokeAPI), multiplayer fixes, GreenLuma AppList management, library scanner, backups, and more. Educational purposes only.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • C 42.7%
  • Python 35.5%
  • C# 5.9%
  • JavaScript 5.2%
  • C++ 5.2%
  • HTML 2.9%
  • Other 2.6%