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 游戏配置和管理工具:它会往你的 Steam 文件夹里写入 Lua 脚本、manifest 文件和 depot 密钥,让游戏和 DLC 能通过 Steam 运行。它不会破解 Steam 本身,作者也表明它仅供学习研究使用。
它是图形界面程序还是命令行工具?是一个桌面图形界面程序。它内置基于 QWebEngine 的 Modern UI(侧边栏有 7 个标签页),还带一个经典 Qt 界面、11 套以上的主题,以及系统托盘图标。
在 Windows 上怎么安装?先运行 Releases 里的安装包,然后在 Home 标签页点 Auto LC Setup 和 Install LumaCore,它会把 dwmapi.dll 和 LumaCore.dll 放进你的 Steam 文件夹。之后添加一个游戏,LumaCore 就能让它立刻出现在 Steam 库里。
我需要先装 .NET 或别的东西吗?主要的 Windows 流程什么都不用装——下载直接走 Steam 原生通道。只有 DepotDownloaderMod(用于旧版本游戏)才需要 .NET 9;在 Linux 上,Quick Tools 的安装流程会检查 PATH 里是否有 .NET 9 运行时。
杀毒软件报安装包有毒,这正常吗?正常——作者说一些杀毒软件会把加壳后的程序当成通用的误报,并不是恶意软件,建议把 SteaMidra 文件夹加入杀毒软件的白名单。源代码在 GitHub 上公开,想核实可以自己去查。
它能在 Linux 或 Steam Deck 上用吗?可以。LumaCore 是只适用于 Windows 的 DLL 劫持,Linux 上则改用 SLSsteam 的许可证注入加 SLScheevo;支持 CachyOS、Arch、Debian、Ubuntu、Fedora 以及 Steam Deck 桌面模式,可从 releases 下载 zip 或 AppImage。
授权协议方面有什么特别的吗?GPL 只覆盖 SteaMidra 自己的代码——捆绑的工具如 LumaCore、CreamAPI、SmokeAPI、Steamless、gbefork 和 DepotDownloaderMod 仍保留各自原来的许可证和条款。GitHub 上显示的许可证是自定义的(NOASSERTION)。
下载游戏主要用哪个入口?Store 标签页——README 称它是主要方式。你在 Hubcap 的 manifest 库里搜索,刷新 depot 密钥,然后下载:最新版本走 Steam 原生通道(速度快),旧版本或指定版本走 DepotDownloaderMod。Home 标签页的 Download Game 按钮走同样的快速通道,适用于 99% 的游戏。
它能备份我的存档吗?可以——Cloud Saves 标签页会扫描 Steam userdata 和 Ludusavi 的存档路径,把同一个 App ID 下的多个文件夹合并成一份备份,恢复时可以按来源单独还原,覆盖之前还会先做安全副本。备份可以存到本地文件夹、Google Drive,或通过 rclone 传到 70 多种后端,比如 Dropbox、OneDrive、MEGA 和 S3。
Fix Game 流程是干什么的?它自动完成游戏修复:应用来自 CrakFiles 仓库的社区修复补丁(无需 API 密钥或账号),用 Steamless 去除 SteamStub DRM,通过 gbefork 配合 SmokeAPI/CreamAPI/Uplay 解锁器检查并解锁 DLC,还会配置 Goldberg、ColdClient 或 ColdLoader 模拟器。这些修复号称不影响成就——只替换绕过用的 DLL,Steam API 保持原样。
联机修复是怎么工作的?SteaMidra 会到 online-fix.me 搜索你选中的游戏,并在浏览器里打开结果——它不再保存任何账号凭据,也不会从该网站下载任何东西。另外还有 LC Online Fix,它会先关闭 Steam,再在 localconfig.vdf 里为指定的 App ID 打开 -onlinefix 开关。
Creator
Midrags
Size
510.8 MB
Stars
1.9K
Age
7mo
Commits · 90 Days