https://github.com/rushiimachine/osu-safe
A POC minifilter driver that blocks osu! from loading backgrounds
https://github.com/rushiimachine/osu-safe
Last synced: about 1 year ago
JSON representation
A POC minifilter driver that blocks osu! from loading backgrounds
- Host: GitHub
- URL: https://github.com/rushiimachine/osu-safe
- Owner: rushiiMachine
- Created: 2024-05-04T21:59:48.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-05-09T23:55:36.000Z (about 2 years ago)
- Last Synced: 2025-03-19T22:11:32.341Z (about 1 year ago)
- Language: C
- Size: 22.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# osu-safe
A proof of concept Windows
[FS minifilter driver](https://learn.microsoft.com/en-us/windows-hardware/drivers/ifs/about-file-system-filter-drivers)
that dynamically blocks osu! map backgrounds from loading on the fly.
Note that this requires
[TESTSIGNING](https://learn.microsoft.com/en-us/windows-hardware/drivers/install/the-testsigning-boot-configuration-option)
to be enabled in order to load the driver, which is incompatible with osu! score submission, and the anti-cheats of
many games for as long as TESTSIGNING is enabled. (ie, Vanguard, BE, EAC all refuse to launch)
You can technically use kdmapper or an EFI based mapper with Secure Boot disabled, but I heavily don't recommend doing
this. This is just a POC when playing offline (and in which case it's much easier to just patch the game directly)
## Details
Once the driver has been loaded, it will listen to all file handle opens and find any from a process named `osu!.exe`,
and if the file is inside the `Songs` folder while being a JPG or PNG, it blocks access to the file.
The advantage of this is that you do not need to alter any map files, or do mass file renames every single time you
want to disable backgrounds, which is error-prone and very slow with thousands of maps.