From 64ab718e88fc89956deea931b29b603952adf370 Mon Sep 17 00:00:00 2001
From: darealshinji <djcj@gmx.de>
Date: Tue, 19 Sep 2017 18:28:51 +0200
Subject: [PATCH] Generic infos about Steam Runtime and environment variables

---
 README.md | 39 +++++++++++++++++++++++++++++++++++++--
 1 file changed, 37 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 823a936..58d4e91 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,9 @@
 A collection of notes, configurations and other files for my Steam games.
 
 Linux
------
+=====
 You can download the Windows version of a game on Linux using steamcmd (install it using your package manager):
-```
+``` sh
 steamcmd +login USERNAME PASSWORD +@sSteamCmdForcePlatformType windows +force_install_dir DESTINATION +app_license_request APPID +app_update APPID validate +quit
 ```
 
@@ -11,6 +11,38 @@ steamcmd +login USERNAME PASSWORD +@sSteamCmdForcePlatformType windows +force_in
  * DESTINATION: full destination path without spaces in names, i.e. `$HOME/Half-Life_2_(Windows)`
  * APPID: the AppID of the game, i.e. 220 for Half-Life 2
 
+Steam or one of the games won't start
+-------------------------------------
+Some of libraries from the Steam Runtime can cause imcompatibility issues, resulting in a game or even the Steam client not starting.
+Run the following command to find and delete those libraries:
+``` sh
+find ~/.steam/root/ \( -name "libgcc_s.so*" -o -name "libstdc++.so*" -o -name "libxcb.so*" -o -name "libgpg-error.so*" \) -print -delete
+```
+
+Useful environment variables
+----------------------------
+``` sh
+# disable steam-runtime
+export STEAM_RUNTIME=0
+
+# Workaround for dbus fatal termination related coredumps (SIGABRT)
+# https://github.com/ValveSoftware/steam-for-linux/issues/4464
+export DBUS_FATAL_WARNINGS=0
+
+# force minimizing on close; temporary workaround for trayicon issues
+# https://github.com/ValveSoftware/steam-for-linux/issues/4812
+export STEAM_FRAME_FORCE_CLOSE=0
+```
+
+Native Runtime
+--------------
+On Debian/Ubuntu you can build a package with a "native runtime launcher" like this:
+``` sh
+git clone https://github.com/darealshinji/debian-packaging
+cd debian-packaging/games/steam-native
+make PBUILDER=0
+```
+
 libgcrypt.so.11
 ---------------
 Add libgcrypt.so.11 to the _bin_ directory of Source/Goldsource engine games to play with Steam Runtime disabled.
@@ -20,6 +52,9 @@ registry.vdf
 If auto-login doesn't work on Linux, set correct username, language and sourcemod path in `registry.vdf`,
 replace the original file in `~/.steam/` and mark the file as read-only.
 
+Windows
+=======
+
 remove-uninstall-links.bat
 --------------------------
 Removes uninstall entries of Steam games from _Programs and Features_.