Sangharsh OS

Documentation/Gaming

Steam & Proton

Steam runs natively on Sangharsh OS, and Proton runs most of the Windows-only library on top of it. This guide covers the launch options worth knowing and how to read what Proton is complaining about.

Proton is Valve's compatibility layer: it combines Wine with DXVK and VKD3D, which translate Direct3D calls into Vulkan. Most Windows games work without any input from you. The rest usually need one launch option, or a look at a log file.

Enable Proton for everything

  1. Open Steam and sign in.
  2. Go to Steam → Settings → Compatibility.
  3. Tick Enable Steam Play for supported titles (usually already on).
  4. Tick Enable Steam Play for all other titles and pick Proton Experimental in the dropdown.
  5. Restart Steam when it asks.

Games that previously showed “not available on your platform” now have an Install button.

Where launch options live

Right-click the game in your library → Properties → General → Launch Options. The box takes a single line of shell-style text.

ENV_VAR=value OTHER_VAR=value %command% --game-argument

Everything before %command% sets an environment variable. %command% is a placeholder for the real launch command — never remove it. Anything after it is passed to the game itself.

Change one variable at a time. Clear the box between tests, otherwise you will not know which one fixed the problem — or caused the new one. Launch options apply per game, so nothing here affects the rest of the library.

Proton troubleshooting variables

Log what Proton is doing

PROTON_LOG=1 %command%

Writes a log file to your home directory named steam-<APPID>.log. The app ID is the number in the game's store URL (store.steampowered.com/app/620 for Portal 2, so steam-620.log). This is the first thing to set when a game crashes or refuses to start, because it turns “it does not work” into a specific error.

Fall back from Vulkan to OpenGL

PROTON_USE_WINED3D=1 %command%

Switches rendering from DXVK (Vulkan) to WineD3D (OpenGL). Use it when Vulkan is the problem: the game starts and immediately dies, the screen stays black with sound playing, or the driver is older than the game expects. Expect lower frame rates — this is a diagnostic and a workaround, not an upgrade.

Turn off ESYNC

PROTON_NO_ESYNC=1 %command%

ESYNC is an eventfd-based synchronisation layer that reduces CPU overhead. It is stable on current kernels, but on some systems it causes a crash at launch or a hang on the loading screen. Disabling it costs a little performance and often buys a working game.

Turn off FSYNC

PROTON_NO_FSYNC=1 %command%

FSYNC uses futexes and is the newer of the two. If a game behaves strangely — audio stuttering, physics running at the wrong speed, freezes when a level loads — try this one. Both can be combined while you are narrowing things down:

PROTON_NO_ESYNC=1 PROTON_NO_FSYNC=1 %command%

NVIDIA users

__GL_SHADER_DISK_CACHE=1 %command%

Enables NVIDIA's on-disk shader cache. Compiled shaders are reused between runs, which removes most of the stutter during the first minutes of a game and after every driver update. The cache lives under ~/.nv/GLCache; deleting that directory is safe and only costs you one recompile.

__GL_THREADED_OPTIMIZATIONS=1 %command%

Lets the NVIDIA driver move OpenGL work onto extra threads. It helps some older OpenGL titles and, in a minority of games, makes things worse — so test it rather than leaving it on for everything. It has no effect on Vulkan titles, which is most of what Proton runs.

Reading the log

# the interesting lines, without the wall of noise
grep -iE "err|fail|warn" ~/steam-*.log | head -40

# what happened last, right before it died
tail -n 60 ~/steam-*.log

Look for err: lines mentioning vulkan, dxgi, d3d11 or a missing DLL. A Vulkan error points at the driver (see the NVIDIA guide); a missing DLL usually means the game needs a runtime the prefix does not have, which Protontricks can install.

Other launch options worth knowing

OptionWhat it does
gamemoderun %command%Runs the game through GameMode, which raises the CPU governor and prioritises the game process. Install gamemode first.
MANGOHUD=1 %command%Shows a performance overlay: frame rate, frame time graph, GPU and CPU load. Needs mangohud installed.
PROTON_ENABLE_NVAPI=1 %command%Enables NVIDIA's NVAPI layer on Proton builds that support it, which some titles need for DLSS.
DXVK_HUD=fps,frametimesDXVK's own overlay, useful when MangoHud is not installed.
WINE_FULLSCREEN_FSR=1AMD FidelityFX Super Resolution upscaling for fullscreen games.

When a game still will not run

  1. Verify the files. Properties → Installed Files → Verify integrity of game files. Corrupt downloads are more common than people expect.
  2. Try a different Proton. Proton Experimental, then a numbered release, then GE-Proton if you have installed it.
  3. Reset the prefix. The Windows environment for each game lives in ~/.steam/steam/steamapps/compatdata/<APPID>/. Rename that folder instead of deleting it, launch the game once, and a fresh prefix is built. Save games stored inside the prefix go with it, so back it up first.
  4. Clear the shader cache. Delete ~/.steam/steam/steamapps/shadercache/ to rule out stale compiled shaders.
  5. Ask ProtonDB. protondb.com has community reports per game, and usually someone has already hit your exact error.

Useful paths

PathWhat is in it
~/.steam/steam/steamapps/compatdata/One Proton prefix per game, named by app ID. Holds the fake C: drive.
~/.steam/steam/steamapps/common/The installed game files.
~/.steam/steam/steamapps/shadercache/Compiled shaders. Safe to delete.
~/steam-<APPID>.logProton log, created only when PROTON_LOG=1 is set.
~/.nv/GLCacheNVIDIA shader cache. Safe to delete.