SFF README

The project's README from github.com/Midrags/SFF. As one markdown file: README.md.

SteaMidra Listed on r/FMHY FMHY and r/Piracy Piracy

Made by Midrag and his brother!

Educational use only. Use at your own risk.

⚠️ Antivirus Warning: some AVs flag the binary as a generic packed-exe false positive. it's not malware. if your AV keeps quarantining it, add the SteaMidra folder to your AV exclusion list. the source is open at github.com/Midrags/SFF if you want to verify.

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/steamidra

SteaMidra setup tutorial: Full walkthrough by @yensnc

API key tutorial: Step-by-step screenshots by @novoagain

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

Python setup tutorial: Python Tutorial


Features


Quick start

Step 1: SteaMidra

Download the latest installer from here and run it. The installer auto-creates the install folder, sets up file associations, and registers the uninstaller.

If the installer fails or your AV blocks it, grab the ZIP instead — SteaMidra-x.x.x-windows.zip. Extract anywhere, run SteaMidra_GUI.exe from inside the extracted folder.

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.


Linux quick start

LumaCore is a Steam-client DLL hijack and is Windows-only. On Linux, SteaMidra uses SLSsteam (license/family-share injection) plus SLScheevo (achievement-only Steam client) instead. Manifests, depot keys, and ACFs work the same as on Windows.

Step 1: Download the Linux build

Grab SteaMidra-x.x.x-linux.zip (or the AppImage) from the releases page and extract it. CachyOS, Arch, Debian, Ubuntu, Fedora, and Steam Deck Desktop Mode are all supported.

Step 2: Set up SLSsteam + SLScheevo

Launch SteaMidra, open Quick Tools, run Set up Linux tools (SLSsteam + .NET 9). SteaMidra installs SLSsteam into ~/.steam/steam/ (or whichever Steam install it found), drops SLSteam.so and library-inject.so, and verifies your .NET 9 runtime is on PATH (DepotDownloaderMod needs it).

If the GUI reports SLSteam libraries not found: SLSteam.so, library-inject.so, the install step has not run yet — open Quick Tools and run it.

Step 3: Add a game

Add a game on the Home tab the same way as Windows. SteaMidra writes the lua to config/stplug-in/, drops the manifests, registers depot keys, and writes the ACF. Restart Steam from inside SteaMidra so SLSsteam injects into the new Steam process — without injection, ownership and family bypass do not work.

For the full walkthrough (supported distros, troubleshooting, what files go where, Steam-Deck-specific notes), see docs/LINUX_SETUP.md.


GUI features

SteaMidra has a full graphical interface with a Modern UI and the classic Qt interface.

Modern UI — the new default interface, built with QWebEngine. Accessible from a clean sidebar with 7 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), 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:


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 – Searching online-fix.me and opening the result in your browser.

Fixes & Bypasses – Searching and applying community-maintained fixes from the CrakFiles repo. No API key, no account.

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.

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 and third-party notices

Made by Midrag and his brother.

SteaMidra uses, integrates with, downloads, is compatible with, or was originally influenced by several third-party projects and community tools. Third-party tools, binaries, unlockers, emulators, assets, APIs, services, and earlier project bases remain owned by their original authors and keep their original licenses/terms. They are not relicensed as SteaMidra code.

SteaMidra’s GPL license applies to SteaMidra’s own source code only. It does not claim ownership over third-party components.

SMD / Steam Manifest Downloader – SteaMidra originally started from an early SMD base/fork. Credit to Kur0 / the SMD project and contributors for the original project structure, early workflow, and inspiration. Since then, SteaMidra has been heavily reworked and expanded with its own workflows, LumaCore integration, GUI/web UI, Store/search features, online fix handling, DLC unlocker handling, fixes/bypasses, backups, library scanner, Linux-related work, updater changes, and many other modules. Any remaining SMD-derived parts remain credited to their original authors/contributors and are not claimed as original SteaMidra code.

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

CreamAPI – DLC unlocker by deadmau5. Used/handled only as a third-party unlocker component. CreamAPI remains owned by its original author and is not licensed as SteaMidra code.

SmokeAPI / ScreamAPI – DLC ownership emulation/unlocker projects by Acidicoala. Used/handled only as third-party unlocker components where applicable. These remain owned by their original author and are not licensed as SteaMidra code.

Uplay R1/R2 Unlocker – Uplay unlocker projects by Acidicoala. Used/handled only as third-party unlocker components where applicable. These remain owned by their original author and are not licensed as SteaMidra code.

CreamInstaller – The DLC Unlockers feature is inspired by and compatible with CreamInstaller-style behavior. SteaMidra does not ship CreamInstaller itself; it provides its own implementation for managing compatible unlocker setups. Credit to CreamInstaller and its maintainers for the original tool/flow inspiration.

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

DDMod / DepotDownloaderMod – The Direct Download via DDMod feature uses DepotDownloaderMod by oureveryday. License in third_party_licenses/DDMod.license.

headcrab / h3adcr-b – The Linux SLSsteam auto-setup uses headcrab by Deadboy666 (https://github.com/Deadboy666/h3adcr-b) as the primary installer. headcrab downloads and installs the latest SLSsteam release, patches Steam, and sets up the config. It is downloaded and run at setup time (not bundled). headcrab does not ship with a license; it remains owned by its original author.

ManifestHub – The ManifestHub source uses the manifest archive/API maintained by oureveryday.

rclone – Cloud Saves uses rclone for transfers to remote storage providers. License in third_party_licenses/rclone.LICENSE.

online-fix.me – The Multiplayer Fix feature searches online-fix.me for the selected game and opens the result in your browser. No credentials needed. SteaMidra is not affiliated with online-fix.me; files remain owned by their respective maintainers.

Ludusavi — The cloud save custom-path feature uses the Ludusavi manifest game-save-location database maintained by mtkennerly (https://github.com/mtkennerly/ludusavi-manifest). Bundled as sff/data/manifest.yaml.

Hubcap Manifest – Store browser and manifest library API provided by Hubcap Manifest. Community server: https://discord.gg/hubcapsmanifest

Ryuu – Lua and manifest download provider with reseller and premium API keys. Community server: https://discord.gg/manifests

DepotBox – Lua and manifest download provider. Also powers the Build ID lookup behind Download Older Version. Community server: https://discord.gg/depotbox

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.

Tutorials – Setup walkthrough by @yensnc. API key tutorial by @novoagain.

README editing help by itsphox.

See third_party_licenses/ and THIRD_PARTY_NOTICES.md for third-party license and provenance details.

License scope

SteaMidra is licensed under the GNU General Public License v3.0 for SteaMidra’s own source code.

This license does not relicense third-party tools, binaries, unlockers, emulators, assets, APIs, services, or external projects used by, bundled with, downloaded by, or integrated with SteaMidra. Those components remain under their original authorship, licenses, and terms.

If any third-party credit, license notice, or ownership note is missing or unclear, please open an issue with the exact file/component and it will be reviewed.

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.

SFF (Midrags/SFF)

Searching Database…

1.9K ·GitHub
Что это такое?SteaMidra — это инструмент для настройки и управления играми Steam: он записывает Lua-скрипты, манифесты и depot-ключи в папку Steam, чтобы игры и DLC запускались через Steam. Сам Steam он не взламывает, а автор позиционирует его как инструмент исключительно для образовательных целей.
Это программа с интерфейсом или консольная утилита?Настольное приложение с графическим интерфейсом. В нём есть современный интерфейс на QWebEngine с 7 вкладками в боковой панели плюс классический интерфейс на Qt, более 11 тем и значок в системном трее.
Как установить его на Windows?Запустите установщик из Releases, затем на вкладке Home нажмите Auto LC Setup и Install LumaCore — это скопирует файлы dwmapi.dll и LumaCore.dll в папку Steam. После этого добавьте игру, и LumaCore сразу покажет её в библиотеке Steam.
Нужно ли сначала установить .NET или что-то ещё?Для основного сценария на Windows ничего не нужно — загрузки идут напрямую через Steam. .NET 9 требуется только для DepotDownloaderMod (старые версии игр); на Linux настройка через Quick Tools проверяет, что среда .NET 9 доступна в PATH.
Это нормально, что антивирус ругается на установщик?Да — автор говорит, что некоторые антивирусы помечают упакованный бинарник как типичное ложное срабатывание, а не вредонос, и советует добавить папку SteaMidra в исключения антивируса. Исходный код открыт на GitHub, так что можно проверить всё самому.
Работает ли это на Linux или Steam Deck?Да. LumaCore — это подмена DLL, работающая только на Windows, поэтому на Linux используется внедрение лицензий через SLSsteam вместе с SLScheevo; поддерживаются CachyOS, Arch, Debian, Ubuntu, Fedora и Steam Deck в режиме рабочего стола, установка — zip-архивом или AppImage из релизов.
Есть ли что-то необычное в лицензии?Лицензия GPL распространяется только на собственный код SteaMidra — входящие в комплект инструменты вроде LumaCore, CreamAPI, SmokeAPI, Steamless, gbefork и DepotDownloaderMod сохраняют свои исходные лицензии и условия. На GitHub лицензия указана как кастомная (NOASSERTION).
Как основной способ скачать игру?Вкладка Store — README называет её основным способом. Вы ищете по библиотеке манифестов Hubcap, обновляете depot-ключи и скачиваете: последние версии — напрямую через Steam (быстро), старые или конкретные — через DepotDownloaderMod. Кнопка Download Game на вкладке Home делает то же самое по быстрому пути для 99% игр.
Умеет ли она бэкапить мои сохранения?Да — вкладка Cloud Saves сканирует Steam userdata и пути сохранений Ludusavi, объединяет несколько папок одного App ID в одну резервную копию с восстановлением по каждому источнику и делает страховочную копию перед перезаписью. Бэкапы сохраняются в локальную папку, на Google Drive или через rclone с более чем 70 бэкендами, включая Dropbox, OneDrive, MEGA и S3.
Что делает конвейер Fix Game?Он автоматизирует починку игры: применяет пользовательские фиксы из репозитория CrakFiles (без API-ключа и аккаунта), снимает DRM-защиту SteamStub через Steamless, проверяет и разблокирует DLC через gbefork плюс SmokeAPI/CreamAPI/Uplay-анлокеры, а также настраивает эмуляторы Goldberg, ColdClient или ColdLoader. Фиксы описываются как безопасные для достижений — подменяются только DLL, Steam API остаётся нетронутым.
Как работает фикс для мультиплеера?SteaMidra ищет выбранную игру на online-fix.me и открывает результат в браузере — программа больше не хранит учётные данные и ничего не скачивает с сайта. Есть также LC Online Fix, который добавляет параметр -onlinefix для выбранного App ID в localconfig.vdf, предварительно закрыв Steam.
Creator
Midrags
Size
510.8 MB
Stars
1.9K
Age
7mo
Commits · 90 Days