Common mistakes

Common mistakes

Wrapping the whole launcher

Wrong:

linuwux lutris
linuwux lutris lutris:rungameid/5
linuwux heroic
linuwux faugus-launcher

linuwux sets LD_PRELOAD and execs its arguments. If the argument is Lutris (or another frontend), every UI helper process loads liblinuwux.so. The game may never get a clean, intentional setup — and logs fill with [linuwux] v… loaded lines.

Right: apply LinUwUx only to the game command:

Launcher	Where
Steam	Per-game → Properties → Launch options
Lutris	That game → Configure → command prefix or env
Heroic	That game → settings → wrapper / env
Faugus	Per-game launch options / env

See Steam, Lutris, Heroic, Faugus.

Replacing LD_PRELOAD instead of appending

Steam injects the overlay via LD_PRELOAD. A bare:

LD_PRELOAD=/home/you/.local/lib/liblinuwux.so %command%

can replace that list and break the overlay.

Prefer the wrapper (appends for you):

~/.local/bin/linuwux %command%

If you set LD_PRELOAD by hand, append:

LD_PRELOAD=${LD_PRELOAD}:/home/you/.local/lib/liblinuwux.so %command%

MangoHud order

linuwux mangohud %command%     # OK
mangohud linuwux %command%     # often breaks

Better: enable MangoHud in the launcher’s own toggle when available (Faugus, Heroic, etc.).

Official Valve Proton

Not supported. Use GE-Proton or CachyOS Proton.

Gamescope on non-Steam launchers

Not smoothly supported yet — see Gamescope.