SCSKiller README

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

SCSKiller logo

SCSKiller

Shader Compilation Stutter Killer. SCSKiller compiles your games' shaders into your GPU driver's cache before you play, so the game doesn't stop to compile them mid-game. Free and open source, for Windows.

Latest release Downloads Licence: GPL-3.0-or-later Patreon Discord

Website · Download · Patreon · Discord · X · Report a bug · Request a game

[!WARNING] The only official downloads are this repository's Releases. See official links for the accounts and sites that belong to SCSKiller.

SCSKiller's library: games grouped by store, with shader and pipeline counts, cache size, compile time, a status such as Needs rebuilding or Warmed, and Play buttons.

Why

When a game meets a new effect, your GPU driver has to compile its shader right then, and the frame waits for it. That's the hitch you feel as shader compilation stutter.

SCSKiller reads the shaders a game ships with, works out the pipelines it will build, and compiles them into your driver's shader cache ahead of time, from its own process and with the game closed. When you launch the game, they're already there.

Results

About 5 minutes of play per game, cold driver cache → compiled with SCSKiller. A stutter is a shader compile the game had to wait 20 ms or more for.

GameGPUMeasurementColdWith SCSKiller
Final Fantasy VII RebirthNVIDIA
RTX 5090
Stutters (≥ 20 ms)190
Worst stall76 ms5 ms
AMD
Ryzen AI Max+ 395 (Strix Halo)
Stutters (≥ 20 ms)1620
Worst stall291 ms7 ms
Silent Hill: TownfallNVIDIA
RTX 5090
Stutters (≥ 20 ms)240
Worst stall347 ms8 ms
Hogwarts LegacyNVIDIA
RTX 5090
Stutters (≥ 20 ms)1,01487
Worst stall2,400 ms100 ms
AMD
Ryzen AI Max+ 395 (Strix Halo)
Stutters (≥ 20 ms)27,743206
Worst stall2,146 ms104 ms
Tiny Tina's WonderlandsNVIDIA
RTX 5090
Stutters (≥ 20 ms)5830
Worst stall315 ms13 ms
Star Wars Jedi: SurvivorNVIDIA
RTX 5090
Stutters (≥ 20 ms)9,03811

Measured with SCSKiller's pipeline recorder. Your numbers will vary by game, GPU and driver.

Features

Install

Requirement
OS Windows 10 (version 2004) or 11, 64-bit
GPU NVIDIA or AMD
Games DirectX 12; DirectX 11 on NVIDIA

Intel GPUs aren't supported yet: I don't have one to test on. If you'd like to sponsor an Intel Arc GPU, get in touch at [email protected].

Download SCSKiller-Setup.exe from Releases and run it. It installs for your user only, needs no admin rights, and keeps itself up to date.

Or take SCSKiller-<version>-Portable.zip, unzip it to any folder you can write to and run SCSKiller.exe: it updates itself the same way. Before deleting a portable folder, turn recording off for your games, so the recorder leaves the game folders.

[!IMPORTANT] Releases aren't code-signed yet, so Windows SmartScreen will probably show "Windows protected your PC" the first time you run it. Click More info, then Run anyway. You see it once per install: updates are downloaded by SCSKiller itself and never trigger it.

Code signing through the SignPath Foundation is in progress. To check a download, compare its SHA-256 with the one in the release notes (PowerShell: Get-FileHash <file>). Smart App Control (Windows 11) blocks unsigned apps outright; if it's on, wait for a signed release.

How to use it

  1. Open SCSKiller. It finds your games and the shaders they ship with.
  2. Queue games and press Compile. "Add all recommended" is a good start. Keep the game closed while it compiles.
  3. Play, from your store or with the game's Play button, which starts it through its store. You can close SCSKiller: the game reads the driver's cache on its own. Or leave it open while you play: it then checks that the compile reached the cache the game really uses, and with the recorder on, the game's page shows afterwards the frame times of your session and whether anything still compiled during it.

If a game says it needs a recording, turn on Record, play it for a few minutes, then compile it.

The compile queue: one game compiling with pipelines per second, games waiting, one finished. A game's page: the frame times of the last session, with shader compile stutters marked apart from other hitches and loading, and the list of slow frames.

FAQ

Is it safe with anti-cheat games? SCSKiller never launches them, injects into them or gives them the recorder. It only reads their files. The one exception is an offline session, for games that run offline without EasyAntiCheat when their exe is started directly (ELDEN RING, ARMORED CORE VI): allowed per game on its page, confirmed before every launch, and at your own risk. SCSKiller adds d3d12.dll, scskiller.ini, scskiller.armed and steam_appid.txt to the game's folder, starts the game's exe itself (offline, no EasyAntiCheat), and the recorder records only that process: started any other way, through Steam with EasyAntiCheat too, it records nothing. Steam must be running (offline mode is fine). The moment the game exits, SCSKiller takes those files out again, keeps the recording and the session's frame times, and checks the folder is as it was, also when SCSKiller itself was closed meanwhile; after a crash or power loss it does so at the next logon or start. If its files are still there when you start the game online, you could be banned.

What does it write, and where? Its settings and per-game plans go in %LOCALAPPDATA%\SCSKiller\, and the compiled pipelines go in your driver's own shader cache. Game files are never modified. The one exception is the optional recorder: it adds d3d12.dll, scskiller.ini and scskiller.armed to the folder of the game you turn it on for, and turning it off removes exactly those files. scskiller.armed says the game's install was checked for anti-cheat; SCSKiller deletes it as soon as anything in the install changes. The recorder decides when the game starts: it records that session only if the file is there then, and a session already running keeps recording until the game exits. Uninstalling SCSKiller removes these files, and the recording it wrote there, from every game folder.

Does it touch my drivers or their settings? No. It compiles through DirectX, the way the game would.

Do I need an account? No. Everything the app does on your PC is free. Signing in with Patreon only adds the supporter features.

My game isn't detected, or something broke. Open an issue with the bug or game request template.

Support the project

The app is free, and stays free. Patreon pays for the servers behind the community database:

Tier You get
Patreon supporter The community shader hash database, and beta builds
Patreon backer All of that, plus alpha builds and priority on game requests

Sign in with Patreon in the app (Settings) to unlock your tier.

Build from source

Visual Studio 2022 (C++ desktop workload with CMake) and the .NET 10 SDK:

cmake -S proxy -B proxy/build -A x64
cmake --build proxy/build --config Release
dotnet build SCSKiller.slnx -c Release

build/publish.ps1 builds the whole distribution into dist\. How it works in depth: ARCHITECTURE.md. How to contribute: CONTRIBUTING.md. Changes: CHANGELOG.md. Security issues: SECURITY.md, never a public issue.

Anything else claiming to be SCSKiller isn't us. Please let us know if you find one.

Licence

GPL-3.0-or-later (LICENSE), with an additional permission for Oodle, the Windows App SDK and graphics driver libraries (LICENSE-EXCEPTION.txt). Third-party components: THIRD-PARTY-NOTICES.md. Code signing policy: CODE_SIGNING_POLICY.md.

Not affiliated with any GPU maker, engine maker or game publisher. All product names are trademarks of their owners.

Forks

Forks are welcome under the licence. Please give yours its own name, say it's unofficial and based on SCSKiller, and keep the SCSKiller copyright notices. The measurements and screenshots in this README are SCSKiller's own, so please don't present them as a fork's.

Official builds come only from this repository's Releases page. A fork's builds, bugs and anti-cheat behaviour are its author's: SCSKiller keeps its recorder out of anti-cheat games, and can't vouch for a fork that changes that.

Improvements are always welcome back here as pull requests. Fixes, games and ideas from forks make SCSKiller better for everyone.

SCSKiller (BlueHeisenberg/SCSKiller)

Searching Database…

What is this?SCSKiller is a free, open-source Windows tool that pre-compiles a game's shaders into your NVIDIA or AMD driver's cache before you play, so the game doesn't have to compile them mid-session and stutter.
How do I install and start using it?Download SCSKiller-Setup.exe from the Releases page and run it (installs for your user only, no admin rights needed), or grab the portable zip instead. Then open it, queue your games, press Compile, and launch the game as usual.
Which GPUs and games does it work with?It needs Windows 10 (2004+) or 11 64-bit with an NVIDIA or AMD GPU. It handles DirectX 12 games on both, and DirectX 11 games on NVIDIA only; Intel GPUs aren't supported yet.
Is it safe to use with anti-cheat protected games?SCSKiller never launches or injects into anti-cheat games and only reads their files. The sole exception is an opt-in, per-game offline session without EasyAntiCheat for ELDEN RING and ARMORED CORE VI, confirmed every time and at your own risk.
Does it modify my game files?No, except the optional recorder, which temporarily adds three small files (d3d12.dll, scskiller.ini, scskiller.armed) to a game's folder while recording and removes them again when turned off or the game exits.
What's the optional recorder for?For games whose shader pipelines can't be worked out from their files directly; you play a few minutes with recording on, then SCSKiller compiles what it captured, and it can graph the frame times of that session.
Do I need a Patreon account to use it?No, the whole app is free. Signing in with Patreon only unlocks extra features like the community shader-hash database and early beta/alpha builds.
Which game launchers does it detect automatically?It finds games installed through Steam, Epic Games, EA app, GOG, Ubisoft Connect, Xbox (PC), Battle.net, PURPLE, HoYoPlay and Gaijin.
Size
1.5 MB
Stars
3K
Age
19d
Commits · 90 Days