Steam: Difference between revisions

From ArchWiki
m (replaced preventing with prevent in line 31, for it was a grammatical error)
 
(107 intermediate revisions by 40 users not shown)
Line 2: Line 2:
[[de:Steam]]
[[de:Steam]]
[[fi:Steam]]
[[fi:Steam]]
[[fr:Steam]]
[[ja:Steam]]
[[ja:Steam]]
[[pt:Steam]]
[[pt:Steam]]
[[ru:Steam]]
[[zh-hans:Steam]]
[[zh-hans:Steam]]
{{Related articles start}}
{{Related articles start}}
Line 11: Line 13:
{{Related|Gamepad}}
{{Related|Gamepad}}
{{Related|List of games}}
{{Related|List of games}}
{{Related|Gamescope}}
{{Related articles end}}
{{Related articles end}}
[https://store.steampowered.com/about/ Steam] is a popular game distribution platform by Valve.
[https://store.steampowered.com/about/ Steam] is a popular game distribution platform by Valve.


Line 18: Line 22:
== Installation ==
== Installation ==


Enable the [[multilib]] repository and [[install]] the {{Pkg|steam}} package.
Enable the [[multilib]] repository and [[install]] the {{Pkg|steam}} (recommended) or alternatively the {{Pkg|steam-native-runtime}} package for running Steam with native system libraries. See [[/Troubleshooting#Steam runtime]].


The following requirements must be fulfilled in order to run Steam on Arch Linux:
{{Note|If you are installing for the first time, you may be prompted for the 32-bit [[Vulkan]] driver package. By default [[pacman]] alphabetically chooses {{Pkg|lib32-amdvlk}}, which can introduce issues like being unable to use Vulkan at all when you install it by accident for different GPU vendor or launch games on AMD GPUs if not installed alongside {{Pkg|amdvlk}}. See [[Vulkan#Installation]] to choose the proper driver for your GPU.}}


* Installed 32-bit version [[Xorg#Driver installation|OpenGL graphics driver]].
In order to run Steam on Arch Linux:
* Generated [[Locale#Generating locales|en_US.UTF-8]] locale, preventing invalid pointer error.
 
* The GUI heavily uses the Arial font. See [[Microsoft fonts]]. An alternative is to use {{Pkg|ttf-liberation}} or [[Steam/Troubleshooting#Text is corrupt or missing|fonts provided by Steam]] instead.
* You must install the 32-bit version of the [[Xorg#Driver installation|OpenGL graphics driver]].
* Install {{Pkg|wqy-zenhei}} to add support for Asian languages.
* If not already done [[Installation guide#Localization|during installation]], you must [[Locale#Generating locales|generate the en_US.UTF-8 locale]] to prevent invalid pointer errors.
* If using [[systemd-networkd]] for network management, install {{Pkg|lib32-systemd}} in order for Steam to be able to connect to its servers.
* If you need to add library folders or add non-Steam games to your Steam library, install [[XDG Desktop Portal]] with a backend providing a file chooser.
* Since the GUI heavily uses the Arial font, you should either:
** Use a free alternative such as {{Pkg|ttf-liberation}}.
** Follow [[Microsoft fonts]] to install the original fonts.
** Apply the workaround at [[Steam/Troubleshooting#Text is corrupt or missing]] to use a different font face.
* If you need CJK support, [[install]] {{Pkg|wqy-zenhei}}.
* If using [[systemd-networkd]] for network management, [[install]] {{Pkg|lib32-systemd}} in order for Steam to be able to connect to its servers.
* If using [[systemd-resolved]] for DNS, follow [[systemd-resolved#DNS|the steps]] to fix {{ic|/etc/resolv.conf}} in order for Steam to be able to resolve hostnames.
* If using the Big Picture Mode (Steam Deck UI), [[NetworkManager]] may be required for the network-related panels to work correctly.
* {{ic|vm.max_map_count}} must be increased in order to run some games without crashing, see [[Gaming#Increase vm.max_map_count]].


=== SteamCMD ===
=== SteamCMD ===


Install {{AUR|steamcmd}} for [https://developer.valvesoftware.com/wiki/SteamCMD the command-line version of Steam].
[[Install]] {{AUR|steamcmd}} for [https://developer.valvesoftware.com/wiki/SteamCMD the command-line version of Steam].
 
=== Alternative Flatpak installation ===
 
Steam can also be installed with [[Flatpak]] as {{ic|com.valvesoftware.Steam}} from [https://flathub.org/ Flathub]. The easiest way to install it for the current user is by using the Flathub repository and flatpak command:
 
flatpak --user remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak --user install flathub com.valvesoftware.Steam
flatpak run com.valvesoftware.Steam
 
The Flatpak application currently does not support themes. Also you currently cannot run games via {{ic|optirun}}/{{ic|primusrun}}, see [https://github.com/flatpak/flatpak/issues/869 Issue#869] for more details.
 
Steam installed via Flatpak is not able to access your home directory and overriding this will cause Steam to not run because it is not safe. However, you can freely add directories outside the home directory. If you want to add an external library, run the following command to add it:
 
flatpak override --user com.valvesoftware.Steam --filesystem=/path/to/directory
 
==== Asian Font Problems with Flatpak ====
 
If you are having problem getting Asian fonts to show in game, it is because org.freedesktop.Platform does not include it. First try mounting your local font :
 
flatpak run --filesystem=~/.local/share/fonts --filesystem=~/.config/fontconfig  com.valvesoftware.Steam
 
If that does not work, consider this hack: make the fonts available by directly copying the font files into org.freedesktop.Platform's directories, e.g.
 
# replace ? with your version and hash
/var/lib/flatpak/runtime/org.freedesktop.Platform/x86_64/?/?/files/etc/fonts/conf.avail
/var/lib/flatpak/runtime/org.freedesktop.Platform/x86_64/?/?/files/etc/fonts/conf.d
/var/lib/flatpak/runtime/org.freedesktop.Platform/x86_64/?/?/files/share/fonts


== Directory structure ==
== Directory structure ==
Line 68: Line 54:


Steam installs games into a directory under {{ic|''LIBRARY''/steamapps/common/}}. {{ic|''LIBRARY''}} normally is  
Steam installs games into a directory under {{ic|''LIBRARY''/steamapps/common/}}. {{ic|''LIBRARY''}} normally is  
{{ic|~/.steam/root}} but you can also have multiple library folders (''Steam > Settings > Downloads > Steam Library Folders'').
{{ic|~/.steam/root}} but you can also have multiple library folders (''Steam > Settings > Storage > (+) Add Drive'').


In order for Steam to recognize a game it needs to have an
In order for Steam to recognize a game it needs to have an
Line 74: Line 60:
[https://developer.valvesoftware.com/wiki/KeyValues KeyValues] format and its {{ic|installdir}} property
[https://developer.valvesoftware.com/wiki/KeyValues KeyValues] format and its {{ic|installdir}} property
determines the game directory name.
determines the game directory name.
{{Note|In order to add additional drives to a Steam installation made through flathub, the user must first give the Steam Client authorization to access the mount-point of the additional drive manually through a tool such as {{AUR|flatseal}}.}}


== Usage ==
== Usage ==
Line 85: Line 73:
== Launch options ==
== Launch options ==


When you launch a Steam game, Steam executes its '''launch command''' in a [[Bash]] shell.
When you launch a Steam game, Steam executes its '''launch command''' with {{ic|/bin/sh}}.
To let you alter the launch command Steam provides '''launch options''',
To let you alter the launch command Steam provides '''launch options''',
which can be set for a game by right-clicking on it in your library, selecting Properties and clicking on ''Set Launch Options''.
which can be set for a game by right-clicking on it in your library, selecting Properties and clicking on ''Set Launch Options''.
Line 102: Line 90:
=== Start Minimized ===
=== Start Minimized ===


It is possible to have Steam start minimized to the system tray, rather than taking focus. Simply add {{ic|-silent}} to the list of arguments in the autostart file.
It is possible to have Steam start minimized to the system tray, rather than taking focus. Add {{ic|-silent}} to the list of command line arguments; see [[Desktop entries#Modify desktop files]] for doing this by default.


{{hc|~/.config/autostart/steam.desktop|<nowiki>
=== Small Mode ===
...
Exec=/usr/bin/steam -silent
...</nowiki>}}


=== fsync patch ===
Steam supports an alternative, minimal UI with just your game list - the store, community and cover collection views are hidden. You can switch to it with ''View'' > ''Small Mode''. To go back to the standard UI, select ''View'' > ''Large Mode''.
 
Valve's [https://steamcommunity.com/app/221410/discussions/0/3158631000006906163/ fsync patches] offer performance improvements to massively-threaded applications running via Proton or Wine. Since Linux kernel version 5.16, this has been merged into the vanilla kernel, with no further action necessary other than using a recent Proton build, or a patched Wine build. Earlier kernel versions with fsync support are available via one of the following methods:
 
* Install {{Pkg|linux-zen}} kernel that includes the fsync patches since the 5.2 release[https://github.com/zen-kernel/zen-kernel/commit/f39367fdbc68e8b1e623239d13db6efaa5a67ae1]
* Install {{AUR|linux-pf}} or {{AUR|linux-pf-git}} kernel.


=== Proton Steam-Play ===
=== Proton Steam-Play ===
Line 122: Line 102:
It is open-source and available on [https://github.com/ValveSoftware/Proton/ GitHub]. Steam will install its own versions of Proton when Steam Play is enabled.
It is open-source and available on [https://github.com/ValveSoftware/Proton/ GitHub]. Steam will install its own versions of Proton when Steam Play is enabled.


Proton needs to be enabled on Steam client: ''Steam > Settings > Steam Play''. You can enable Steam Play for games that have and have not been whitelisted by Valve in that dialog.
Proton needs to be enabled on Steam client: ''Steam > Settings > Compatibility''. You can enable Steam Play for games that have and have not been whitelisted by Valve in that dialog.
 
Proton supports ''E''asy ''A''nti ''C''heat integration if the developer activates it, however EAC may require a particular [https://github.com/ValveSoftware/Proton/issues/5214 patched version] of glibc: if a game is been reported to be working but is not in your machine, try using Steam Flatpak because it comes with glibc patched.
 
==== Force Proton usage ====
 
If needed, to force enable Proton or a specific version of Proton for a game, right click on the game, click ''Properties > Compatibility > Force the use of a specific Steam Play compatibility tool'', and select the desired version. Doing so can also be used to force games that have a Linux port to use the Windows version.
 
==== Use Proton outside of Steam ====
 
You can [[install]] {{AUR|proton}}, but extra setup is required to work with Steam. See the Proton GitHub for details on how Steam recognizes Proton installs.
 
=== Steam Input ===
 
When a controller is plugged in while Steam is running, Steam's default behavior is to leave it alone and let games use it as-is. The gamepad's evdev and joystick devices are exposed by the kernel, and games may use them using APIs such as [https://www.libsdl.org/ SDL2] as if Steam were not in the picture.
 
The [https://partner.steamgames.com/doc/features/steam_controller Steam Input] subsystem offers an abstraction layer which allows for more advanced functionality such as rebinding buttons and axes, having game-specific profiles, and doing higher-level button mappings based on in-game actions. The [https://partner.steamgames.com/doc/features/steam_controller/concepts Steam Input Configurator] (SIC) is the part of the system that implements this functionality. To enable Steam Input for a controller, go to ''Steam'' > ''Settings'' > ''Controller'' > ''General Controller Setting''. [https://partner.steamgames.com/doc/features/steam_controller/getting_started_for_players] This will open a menu from the Big Picture settings, where you can enable the ''Configuration Support'' option corresponding to your controller.
 
==== Steam Input Configurator ====
 
When SIC is enabled for a controller, there are a few different controller devices:
 
* The virtual Steam Controller, used by games that utilize the Steam Input API. All rebindings and Steam-specific features are functional.
** This is not to be confused with the [https://store.steampowered.com/app/353370/Steam_Controller/ Valve Steam Controller], the physical controller.
* An evdev device representing an emulated Xbox 360 controller, used by games that do not support Steam Input. Basic rebindings are in effect. [https://partner.steamgames.com/doc/features/steam_controller/steam_input_gamepad_emulation_bestpractices]
* The original controller evdev device, whose inputs are passed through the SIC. Rebindings are not in effect, but games should be defaulting to the 360 controller instead.
* The joystick analogues of the above two devices.
 
The SIC's behavior is context dependent:
 
* When launching a game that supports the Steam Input API, it is using the SIC in native mode. The game receives "actions" rather than raw inputs to handle.
** This works for games running in Proton that would be using Steam Input on Windows.
** Even though it's theoretically not needed, the emulated 360 controller is still present.
** A game may choose to provide both support for the Steam Input, and traditional input API libraries that defer to evdev and joystick under the hood. When the game is launched with Steam and with SIC enabled for the controller, Steam Input takes higher priority.
** A game can also choose to ''only'' support Steam Input. For example, in Among Us, a gamepad will not work unless you have the SIC running.
* When launching a game that does not support Steam Input, it is (unknowingly) using the SIC in legacy mode. The game receives its expected low-level raw inputs from what seems to be a 360 controller, but they are actually spoofed by the SIC to emulate the desired behavior of native mode.
** This is the case for native games that use evdev or joystick, as well as Windows games running through Proton that use DirectInput or XInput.
* When launching a game that supports neither Steam Input nor other gamepad APIs, SIC can activate a profile that emulates gamepad support as described below.
* When Big Picture has focus, the current Big Picture profile is in effect, configurable via ''Steam'' > ''Settings'' > ''Controller'' > ''Big Picture Configuration''.
* When anything else has focus, the current Desktop profile is in effect, configurable via ''Steam'' > ''Settings'' > ''Controller'' > ''Desktop Configuration''.
* When anything has focus, additional global bindings can be configured via ''Steam'' > ''Settings'' > ''Controller'' > ''Guide Button Chord Configuration''.
 
Games are rated on how comprehensive their gamepad support is. A game can have one of three icons in the Big Picture UI: [https://steamcommunity.com/sharedfiles/filedetails/?id=192523320]
 
* A full gamepad icon, indicating that the game has full controller support. This can be achieved even if the game does not use the Steam Input API; the focus is on accessibility regardless of API.
* A half-filled gamepad icon, indicating that the game has partial gamepad support. Even if the game is using the Steam Input API, there are instances like Team Fortress 2 where certain parts are still inaccessible to warrant this rating.
* A keyboard icon, indicating the game does not have native gamepad support.
 
In cases where the game does not have full gamepad support, SIC tries to fill the gaps. For example, in Bloons Tower Defense 5, a game that requires you to point and click, Steam will automatically activate the ''Keyboard (WASD) and Mouse'' profile, allowing you to use your gamepad to move and click.


If needed, to force enable Proton or a specific version of Proton for a game, right click on the game, click ''Properties > General > Force the use of a specific Steam Play compatibility tool'', and select the desired version. Doing so can also be used to force games that have a Linux port to use the Windows version.
==== Recommended Steam Input usage ====


You can also install Proton from AUR with {{AUR|proton}} or {{AUR|proton-git}}, but extra setup is required for them to work with Steam. See the Proton GitHub for details on how Steam recognizes Proton installs.
To summarize what this all means for usage:
 
* Enabling "Configuration Support" in the Big Picture settings is ''recommended'' for enhanced gamepad support such as rebinding to one's liking, or automated fixes like Nintendo-style button remapping or keyboard/mouse.
* For some games, enabling this is outright ''required'' if they do not support traditional gamepad APIs.
* By default, if you have enabled this, then the controller will not work with non-Steam games because the 360 controller takes precedence over the original controller device, but the default Desktop profile has the buttons disabled. To fix this, you can either:
** Set your Desktop profile to the template for ''Gamepad''. This will pass through the inputs to the 360 controller, making the default device usable for other programs.
** Have the other game use the original device if it supports this. Note that the game will not benefit from any Steam Input rebindings.
** Disable the whole feature for the controller so Steam does not create the 360 controller at all. Note that Steam games would then not benefit from the enhanced gamepad support.
** Close Steam when using the other games.
 
=== HiDPI ===
 
See [[HiDPI#Steam]].


=== Big Picture Mode without a window manager ===
=== Big Picture Mode without a window manager ===
{{Out of date|{{Pkg|gamescope}} is the successor to ''steamos-compositor''. Maybe some inspiration can be taken from [[HDR monitor support#Gamescope with Steam session]]?}}


To start Steam in Big Picture Mode from a [[Display manager]], you can either:
To start Steam in Big Picture Mode from a [[Display manager]], you can either:


* Install {{AUR|steamos-compositor}}
* [[Install]] {{AUR|steamos-compositor}}{{Broken package link|package not found}}
* Alternatively, install {{AUR|steamos-compositor-plus}}, which hides the annoying color flashing on startup of Proton games and adds a fix for games that start in the background
* Alternatively, install {{AUR|steamos-compositor-plus}}, which hides the annoying color flashing on startup of Proton games and adds a fix for games that start in the background
* Manually add a Steam entry (''but you lose the steam compositor advantages: mainly you '''cannot''' control Big Picture mode with keyboard or gamepad''):
* Manually add a Steam entry (''but you lose the steam compositor advantages: mainly you '''cannot''' control Big Picture mode with keyboard or gamepad''):
Line 149: Line 191:
=== Steam skins ===
=== Steam skins ===


The Steam interface can be customized using skins. Skins can overwrite interface-specific files in {{ic|~/.steam/root}}.
{{Note|A new Steam UI was released in June 2023. Skins not updated for this new UI will have no effect.}}
 
To install a skin:
 
# Place its directory in {{ic|~/.steam/root/skins}}.
# Open ''Steam > Settings > Interface'' and select it.
# Restart Steam.
 
An extensive list of skins can be found in [https://web.archive.org/web/20170528214751/http://forums.steampowered.com/forums/showthread.php?t=1161035 this Steam forums post].
 
{{Note|Using an outdated skin may cause visual errors.}}


==== Creating skins ====
The Steam interface can be customized using skins. Follow [https://steamcommunity.com/sharedfiles/filedetails/?id=3003438937 this Steam guide] for more information.


Nearly all Steam styles are defined in {{ic|~/.steam/root/resource/styles/steam.styles}} (the file is over 3,500 lines long). For a skin to be recognized it needs its own {{ic|resource/styles/steam.styles}}.
Some skins updated for the 2023 UI are:
When a Steam update changes the official {{ic|steam.styles}} your skin may become outdated, potentially resulting in visual errors.


See {{ic|~/.steam/root/skins/skins_readme.txt}} for a primer on how to create skins.
* [https://github.com/tkashkin/Adwaita-for-Steam Adwaita for Steam]
* [https://github.com/AikoMidori/SteamSkins Shiina's Steam Skins]
* [https://github.com/yurisuika/Zehn Zehn]
* More skins are available in the guide linked above.


=== Changing the Steam notification position ===
=== Changing the Steam notification position ===
Line 210: Line 244:
See [https://steamcommunity.com/sharedfiles/filedetails/?id=680514371 this Steam Community guide] on how to setup a headless streaming server on Linux.
See [https://steamcommunity.com/sharedfiles/filedetails/?id=680514371 this Steam Community guide] on how to setup a headless streaming server on Linux.


=== Steam Controller ===
=== Sharing games with Windows when using Proton ===
 
If you use Proton (Steam Play) for launching your games, and still keep a Windows installation for some reason (for example, if some game has problems with anti cheat or if you want to make a comparison tests with Windows), you may want to store your games in a common partition instead of keeping two copies of game one per OS.
 
To add another folder for library, click on ''Steam > Settings > Downloads > STEAM LIBRARY FOLDERS'', then on the ''⊕ (Plus)'' button.
 
There are three file systems, that can be read/write by both Windows and Linux.
 
==== NTFS ====
 
See https://github.com/ValveSoftware/Proton/wiki/Using-a-NTFS-disk-with-Linux-and-Windows for more information on how to configure that. To launch games from an NTFS drive, follow the steps from [[Steam/Troubleshooting#Steam Library in NTFS partition]].
 
Using ntfs has disadvantages. It happens often that shaders cache folder becomes corrupted. Messages saying {{ic|1=ntfs3: sdb6 ino=1921f, steamapprun_pipeline_cache Looks like your dir is corrupt.}} You cannot fix that from linux. You need to boot to Windows and use chkdsk for that.
 
==== EXFAT ====
 
This FS has disadvantage that it is case-insensitive. You will get such message: {{ic|SteamLibrary has both 'SteamApps' and 'steamapps' directories. This will cause problems. Please fix manually and only keep 'steamapps' }} See [https://github.com/ValveSoftware/steam-for-linux/issues/7665 issue #7665]
 
Also it is problematic to create symlinks on exfat, so you cannot use the method of symlinking compatdata as in ntfs method.
 
==== UDF ====
 
This file system can be used without a problem. The only thing to remember is that Linux has not yet write support to udf 2.50+. So just create a udf formatted partition in Gparded, and it will be 2.01.
 
=== Faster shader pre-compilation ===
 
In certain circumstances shader pre-compilation may only use one core, however this can be overridden by the user, example to use 8 cores:
 
{{hc|~/.steam/steam/steam_dev.cfg|
unShaderBackgroundProcessingThreads 8
}}
 
=== Compatibility layers other than Proton ===
 
There are compatibility tools other than Proton/Wine.
 
* {{App|Luxtorpeda|Run games using native Linux engines.|https://luxtorpeda-dev.github.io/|{{AUR|luxtorpeda-git}}}}
* {{App|Boxtron|Run DOS games using native Linux DOSBox|https://github.com/dreamer/boxtron|{{AUR|boxtron}}}}
 
You can also use {{AUR|protonup-qt}} to manage them:
 
# Close Steam
# [[Install]] {{AUR|protonup-qt}}
# Open protonup-qt and install desired tools
# Start Steam
# In the ''game properties'' window, select ''Force the use of a specific Steam Play compatibility tool'' and select the desired tool.
 
=== Disable HTTP2 for faster downloads ===
 
Some systems and configurations seem to have issues with HTTP2. Disabling HTTP2 will probably yield faster downloads on those configurations.
You can either use the console command {{ic|@nClientDownloadEnableHTTP2PlatformLinux 0}} or set it in {{ic|steam_dev.cfg}} like so:
{{hc|~/.steam/steam/steam_dev.cfg|
@nClientDownloadEnableHTTP2PlatformLinux 0
}}
 
=== Run games using discrete GPU ===
 
On [[hybrid graphics]] laptops, Steam runs games using the integrated GPU by default. See [[PRIME#PRIME GPU offloading]] to switch to the more powerful discrete GPU for specific games.
 
=== Flatpak ===
 
{{Note|Installing Steam from Flathub/Flatpak will fix many of the issues faced on the client but will require alternative, less documented forms of troubleshooting on the long run.}}
 
Steam can also be installed with [[Flatpak]] as {{ic|com.valvesoftware.Steam}} from [https://flathub.org/ Flathub]. The easiest way to install it for the current user is by using the Flathub repository:
 
$ flatpak --user remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
$ flatpak --user install flathub com.valvesoftware.Steam
$ flatpak run com.valvesoftware.Steam
 
The Flatpak application currently does not support themes. Also you currently cannot run games via {{ic|optirun}}/{{ic|primusrun}}, see [https://github.com/flatpak/flatpak/issues/869 Issue#869] for more details.
 
Steam installed via Flatpak is not able to access your home directory and overriding this will cause Steam to not run because it is not safe. However, you can freely add directories outside the home directory. If you want to add an external library, run the following command to add it:
 
$ flatpak override --user com.valvesoftware.Steam --filesystem=/path/to/directory
 
Launching Steam with Flatpak might warn you about installing the {{ic|steam-devices}} package. This package currently does not exist but {{aur|game-devices-udev}} can be installed instead, see [[Gamepad#Device permissions]].
 
==== Asian Font Problems with Flatpak ====
 
If you are having problem getting Asian fonts to show in game, it is because org.freedesktop.Platform does not include it. First try mounting your local font :
 
$ flatpak run --filesystem=~/.local/share/fonts --filesystem=~/.config/fontconfig com.valvesoftware.Steam
 
If that does not work, consider this hack: make the fonts available by directly copying the font files into org.freedesktop.Platform's directories, e.g.
 
/var/lib/flatpak/runtime/org.freedesktop.Platform/x86_64/''version''/''hash''/files/etc/fonts/conf.avail
/var/lib/flatpak/runtime/org.freedesktop.Platform/x86_64/''version''/''hash''/files/etc/fonts/conf.d
/var/lib/flatpak/runtime/org.freedesktop.Platform/x86_64/''version''/''hash''/files/share/fonts


Normally a Steam controller requires the use of the Steam-overlay.  In non-Steam native Linux games however the overlay may not be practical.  For that, while the Steam client is running it will maintain a "desktop configuration".  With your Steam controller, configure the desktop configuration for it as a generic XBOX controller.  As long as the Steam client is running you can then use your Steam controller in other games, such as GOG games, as an XBOX controller.  Make sure to select your type of controller to map to in "general controller settings".
==== Steam Flatpak start (run) issues ====


=== Sharing Games With Windows when using Proton ===
After launch, Steam will try to download files and you will see a progress bar. If it crashes, you may try to give additional permissions to the flatpak package:


If you use Proton (Steam Play) for launching your games, and still keep a Windows installation for some reason (for example, if some game has problems with anti cheat or if you want to make a comparison tests with Windows), you may want to store your games in a common partition instead of keeping two copies of game one per OS. See https://github.com/ValveSoftware/Proton/wiki/Using-a-NTFS-disk-with-Linux-and-Windows for more information on how to configure that.
  $ flatpak permission-set background background com.valvesoftware.Steam yes
$ flatpak run com.valvesoftware.Steam


To add another folder for library, click on Steam → Settings → Downloads → STEAM LIBRARY FOLDERS, Then ADD LIBRARY FOLDER.
For an alternative way to control permissions, install [https://flathub.org/apps/com.github.tchx84.Flatseal flatseal].


== Troubleshooting ==
== Troubleshooting ==
Line 228: Line 350:
* [[Gentoo:Steam]]
* [[Gentoo:Steam]]
* [https://pcgamingwiki.com/wiki/The_Big_List_of_DRM-Free_Games_on_Steam The Big List of DRM-Free Games on Steam] at PCGamingWiki
* [https://pcgamingwiki.com/wiki/The_Big_List_of_DRM-Free_Games_on_Steam The Big List of DRM-Free Games on Steam] at PCGamingWiki
* [https://steam.fandom.com/wiki/List_of_DRM-free_games List of DRM-free games] at Fandom
* [https://store.steampowered.com/browse/linux Steam Linux store]
* [https://store.steampowered.com/browse/linux Steam Linux store]
* [https://github.com/ValveSoftware/Proton/ Proton] Compatibility tool for Steam Play based on Wine and additional components.
* [https://github.com/ValveSoftware/Proton/ Proton] Compatibility tool for Steam Play based on Wine and additional components.
* [https://www.protondb.com/ ProtonDB] crowdsourced Linux compatibility reports.
* [https://areweanticheatyet.com/ are we anti cheat yet] A comprehensive and crowd-sourced list of games using anti-cheats and their compatibility with GNU/Linux or Wine/Proton.

Latest revision as of 21:55, 12 April 2024

Steam is a popular game distribution platform by Valve.

Note: Steam for Linux only supports Ubuntu LTS.[1] Thus, do not turn to Valve for support for issues with Steam on Arch Linux.

Installation

Enable the multilib repository and install the steam (recommended) or alternatively the steam-native-runtime package for running Steam with native system libraries. See /Troubleshooting#Steam runtime.

Note: If you are installing for the first time, you may be prompted for the 32-bit Vulkan driver package. By default pacman alphabetically chooses lib32-amdvlk, which can introduce issues like being unable to use Vulkan at all when you install it by accident for different GPU vendor or launch games on AMD GPUs if not installed alongside amdvlk. See Vulkan#Installation to choose the proper driver for your GPU.

In order to run Steam on Arch Linux:

SteamCMD

Install steamcmdAUR for the command-line version of Steam.

Directory structure

The default Steam install location is ~/.local/share/Steam. If Steam cannot find it, it will prompt you to reinstall it or select the new location. This article uses the ~/.steam/root symlink to refer to the install location.

Library folders

Every Steam application has a unique AppID, which you can find by either looking at its Steam Store page path or visiting SteamDB.

Steam installs games into a directory under LIBRARY/steamapps/common/. LIBRARY normally is ~/.steam/root but you can also have multiple library folders (Steam > Settings > Storage > (+) Add Drive).

In order for Steam to recognize a game it needs to have an appmanifest_AppId.acf file in LIBRARY/steamapps/. The appmanifest file uses the KeyValues format and its installdir property determines the game directory name.

Note: In order to add additional drives to a Steam installation made through flathub, the user must first give the Steam Client authorization to access the mount-point of the additional drive manually through a tool such as flatsealAUR.

Usage

steam [ -options ] [ steam:// URL ]

For the available command-line options see the Command Line Options article on the Valve Developer Wiki.

Steam also accepts an optional Steam URL, see the Steam browser procotol.

Launch options

When you launch a Steam game, Steam executes its launch command with /bin/sh. To let you alter the launch command Steam provides launch options, which can be set for a game by right-clicking on it in your library, selecting Properties and clicking on Set Launch Options.

By default Steam simply appends your option string to the launch command. To set environment variables or pass the launch command as an argument to another command you can use the %command% substitute.

Examples

  • only arguments: -foo
  • environment variables: FOO=bar BAZ=bar %command% -baz
  • completely different command: othercommand # %command%

Tips and tricks

Start Minimized

It is possible to have Steam start minimized to the system tray, rather than taking focus. Add -silent to the list of command line arguments; see Desktop entries#Modify desktop files for doing this by default.

Small Mode

Steam supports an alternative, minimal UI with just your game list - the store, community and cover collection views are hidden. You can switch to it with View > Small Mode. To go back to the standard UI, select View > Large Mode.

Proton Steam-Play

Valve developed a compatibility tool for Steam Play based on Wine and additional components named Proton. It allows you to launch many Windows games (see compatibility list).

It is open-source and available on GitHub. Steam will install its own versions of Proton when Steam Play is enabled.

Proton needs to be enabled on Steam client: Steam > Settings > Compatibility. You can enable Steam Play for games that have and have not been whitelisted by Valve in that dialog.

Proton supports Easy Anti Cheat integration if the developer activates it, however EAC may require a particular patched version of glibc: if a game is been reported to be working but is not in your machine, try using Steam Flatpak because it comes with glibc patched.

Force Proton usage

If needed, to force enable Proton or a specific version of Proton for a game, right click on the game, click Properties > Compatibility > Force the use of a specific Steam Play compatibility tool, and select the desired version. Doing so can also be used to force games that have a Linux port to use the Windows version.

Use Proton outside of Steam

You can install protonAUR, but extra setup is required to work with Steam. See the Proton GitHub for details on how Steam recognizes Proton installs.

Steam Input

When a controller is plugged in while Steam is running, Steam's default behavior is to leave it alone and let games use it as-is. The gamepad's evdev and joystick devices are exposed by the kernel, and games may use them using APIs such as SDL2 as if Steam were not in the picture.

The Steam Input subsystem offers an abstraction layer which allows for more advanced functionality such as rebinding buttons and axes, having game-specific profiles, and doing higher-level button mappings based on in-game actions. The Steam Input Configurator (SIC) is the part of the system that implements this functionality. To enable Steam Input for a controller, go to Steam > Settings > Controller > General Controller Setting. [2] This will open a menu from the Big Picture settings, where you can enable the Configuration Support option corresponding to your controller.

Steam Input Configurator

When SIC is enabled for a controller, there are a few different controller devices:

  • The virtual Steam Controller, used by games that utilize the Steam Input API. All rebindings and Steam-specific features are functional.
  • An evdev device representing an emulated Xbox 360 controller, used by games that do not support Steam Input. Basic rebindings are in effect. [3]
  • The original controller evdev device, whose inputs are passed through the SIC. Rebindings are not in effect, but games should be defaulting to the 360 controller instead.
  • The joystick analogues of the above two devices.

The SIC's behavior is context dependent:

  • When launching a game that supports the Steam Input API, it is using the SIC in native mode. The game receives "actions" rather than raw inputs to handle.
    • This works for games running in Proton that would be using Steam Input on Windows.
    • Even though it's theoretically not needed, the emulated 360 controller is still present.
    • A game may choose to provide both support for the Steam Input, and traditional input API libraries that defer to evdev and joystick under the hood. When the game is launched with Steam and with SIC enabled for the controller, Steam Input takes higher priority.
    • A game can also choose to only support Steam Input. For example, in Among Us, a gamepad will not work unless you have the SIC running.
  • When launching a game that does not support Steam Input, it is (unknowingly) using the SIC in legacy mode. The game receives its expected low-level raw inputs from what seems to be a 360 controller, but they are actually spoofed by the SIC to emulate the desired behavior of native mode.
    • This is the case for native games that use evdev or joystick, as well as Windows games running through Proton that use DirectInput or XInput.
  • When launching a game that supports neither Steam Input nor other gamepad APIs, SIC can activate a profile that emulates gamepad support as described below.
  • When Big Picture has focus, the current Big Picture profile is in effect, configurable via Steam > Settings > Controller > Big Picture Configuration.
  • When anything else has focus, the current Desktop profile is in effect, configurable via Steam > Settings > Controller > Desktop Configuration.
  • When anything has focus, additional global bindings can be configured via Steam > Settings > Controller > Guide Button Chord Configuration.

Games are rated on how comprehensive their gamepad support is. A game can have one of three icons in the Big Picture UI: [4]

  • A full gamepad icon, indicating that the game has full controller support. This can be achieved even if the game does not use the Steam Input API; the focus is on accessibility regardless of API.
  • A half-filled gamepad icon, indicating that the game has partial gamepad support. Even if the game is using the Steam Input API, there are instances like Team Fortress 2 where certain parts are still inaccessible to warrant this rating.
  • A keyboard icon, indicating the game does not have native gamepad support.

In cases where the game does not have full gamepad support, SIC tries to fill the gaps. For example, in Bloons Tower Defense 5, a game that requires you to point and click, Steam will automatically activate the Keyboard (WASD) and Mouse profile, allowing you to use your gamepad to move and click.

Recommended Steam Input usage

To summarize what this all means for usage:

  • Enabling "Configuration Support" in the Big Picture settings is recommended for enhanced gamepad support such as rebinding to one's liking, or automated fixes like Nintendo-style button remapping or keyboard/mouse.
  • For some games, enabling this is outright required if they do not support traditional gamepad APIs.
  • By default, if you have enabled this, then the controller will not work with non-Steam games because the 360 controller takes precedence over the original controller device, but the default Desktop profile has the buttons disabled. To fix this, you can either:
    • Set your Desktop profile to the template for Gamepad. This will pass through the inputs to the 360 controller, making the default device usable for other programs.
    • Have the other game use the original device if it supports this. Note that the game will not benefit from any Steam Input rebindings.
    • Disable the whole feature for the controller so Steam does not create the 360 controller at all. Note that Steam games would then not benefit from the enhanced gamepad support.
    • Close Steam when using the other games.

HiDPI

See HiDPI#Steam.

Big Picture Mode without a window manager

This article or section is out of date.

Reason: gamescope is the successor to steamos-compositor. Maybe some inspiration can be taken from HDR monitor support#Gamescope with Steam session? (Discuss in Talk:Steam)

To start Steam in Big Picture Mode from a Display manager, you can either:

  • Install steamos-compositorAUR[broken link: package not found]
  • Alternatively, install steamos-compositor-plusAUR, which hides the annoying color flashing on startup of Proton games and adds a fix for games that start in the background
  • Manually add a Steam entry (but you lose the steam compositor advantages: mainly you cannot control Big Picture mode with keyboard or gamepad):

create a /usr/share/xsessions/steam-big-picture.desktop file with the following contents:

/usr/share/xsessions/steam-big-picture.desktop
[Desktop Entry]
Name=Steam Big Picture Mode
Comment=Start Steam in Big Picture Mode
Exec=/usr/bin/steam -bigpicture
TryExec=/usr/bin/steam
Icon=
Type=Application

Steam skins

Note: A new Steam UI was released in June 2023. Skins not updated for this new UI will have no effect.

The Steam interface can be customized using skins. Follow this Steam guide for more information.

Some skins updated for the 2023 UI are:

Changing the Steam notification position

The default Steam notification position is bottom right.

You can change the Steam notification position by altering Notifications.PanelPosition in

  • resource/styles/steam.styles for desktop notifications, and
  • resource/styles/gameoverlay.styles for in-game notifications

Both files are overwritten by Steam on startup and steam.styles is only read on startup.

Note: Some games do not respect the setting in gameoverlay.styles e.g. XCOM: Enemy Unknown.

Use a skin

You can create a skin to change the notification position to your liking. For example to change the position to top right:

$ cd ~/.steam/root/skins
$ mkdir -p Top-Right/resource
$ cp -r ~/.steam/root/resource/styles Top-Right/resource
$ sed -i '/Notifications.PanelPosition/ s/"[A-Za-z]*"/"TopRight"/' Top-Right/resource/styles/*

Live patching

gameoverlay.styles can be overwritten while Steam is running, allowing you to have game-specific notification positions.

~/.steam/notifpos.sh
sed -i "/Notifications.PanelPosition/ s/\"[A-Za-z]*\"/\"$1\"/" ~/.steam/root/resource/styles/gameoverlay.styles

And the #Launch options should be something like:

~/.steam/notifpos.sh TopLeft && %command%

Steam Remote Play

Note: Steam In-Home Streaming has become Steam Remote Play.

Steam has built-in support for remote play.

See this Steam Community guide on how to setup a headless streaming server on Linux.

Sharing games with Windows when using Proton

If you use Proton (Steam Play) for launching your games, and still keep a Windows installation for some reason (for example, if some game has problems with anti cheat or if you want to make a comparison tests with Windows), you may want to store your games in a common partition instead of keeping two copies of game one per OS.

To add another folder for library, click on Steam > Settings > Downloads > STEAM LIBRARY FOLDERS, then on the ⊕ (Plus) button.

There are three file systems, that can be read/write by both Windows and Linux.

NTFS

See https://github.com/ValveSoftware/Proton/wiki/Using-a-NTFS-disk-with-Linux-and-Windows for more information on how to configure that. To launch games from an NTFS drive, follow the steps from Steam/Troubleshooting#Steam Library in NTFS partition.

Using ntfs has disadvantages. It happens often that shaders cache folder becomes corrupted. Messages saying ntfs3: sdb6 ino=1921f, steamapprun_pipeline_cache Looks like your dir is corrupt. You cannot fix that from linux. You need to boot to Windows and use chkdsk for that.

EXFAT

This FS has disadvantage that it is case-insensitive. You will get such message: SteamLibrary has both 'SteamApps' and 'steamapps' directories. This will cause problems. Please fix manually and only keep 'steamapps' See issue #7665

Also it is problematic to create symlinks on exfat, so you cannot use the method of symlinking compatdata as in ntfs method.

UDF

This file system can be used without a problem. The only thing to remember is that Linux has not yet write support to udf 2.50+. So just create a udf formatted partition in Gparded, and it will be 2.01.

Faster shader pre-compilation

In certain circumstances shader pre-compilation may only use one core, however this can be overridden by the user, example to use 8 cores:

~/.steam/steam/steam_dev.cfg
unShaderBackgroundProcessingThreads 8

Compatibility layers other than Proton

There are compatibility tools other than Proton/Wine.

  • Luxtorpeda — Run games using native Linux engines.
https://luxtorpeda-dev.github.io/ || luxtorpeda-gitAUR
  • Boxtron — Run DOS games using native Linux DOSBox
https://github.com/dreamer/boxtron || boxtronAUR

You can also use protonup-qtAUR to manage them:

  1. Close Steam
  2. Install protonup-qtAUR
  3. Open protonup-qt and install desired tools
  4. Start Steam
  5. In the game properties window, select Force the use of a specific Steam Play compatibility tool and select the desired tool.

Disable HTTP2 for faster downloads

Some systems and configurations seem to have issues with HTTP2. Disabling HTTP2 will probably yield faster downloads on those configurations. You can either use the console command @nClientDownloadEnableHTTP2PlatformLinux 0 or set it in steam_dev.cfg like so:

~/.steam/steam/steam_dev.cfg
@nClientDownloadEnableHTTP2PlatformLinux 0

Run games using discrete GPU

On hybrid graphics laptops, Steam runs games using the integrated GPU by default. See PRIME#PRIME GPU offloading to switch to the more powerful discrete GPU for specific games.

Flatpak

Note: Installing Steam from Flathub/Flatpak will fix many of the issues faced on the client but will require alternative, less documented forms of troubleshooting on the long run.

Steam can also be installed with Flatpak as com.valvesoftware.Steam from Flathub. The easiest way to install it for the current user is by using the Flathub repository:

$ flatpak --user remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
$ flatpak --user install flathub com.valvesoftware.Steam
$ flatpak run com.valvesoftware.Steam

The Flatpak application currently does not support themes. Also you currently cannot run games via optirun/primusrun, see Issue#869 for more details.

Steam installed via Flatpak is not able to access your home directory and overriding this will cause Steam to not run because it is not safe. However, you can freely add directories outside the home directory. If you want to add an external library, run the following command to add it:

$ flatpak override --user com.valvesoftware.Steam --filesystem=/path/to/directory

Launching Steam with Flatpak might warn you about installing the steam-devices package. This package currently does not exist but game-devices-udevAUR can be installed instead, see Gamepad#Device permissions.

Asian Font Problems with Flatpak

If you are having problem getting Asian fonts to show in game, it is because org.freedesktop.Platform does not include it. First try mounting your local font :

$ flatpak run --filesystem=~/.local/share/fonts --filesystem=~/.config/fontconfig com.valvesoftware.Steam

If that does not work, consider this hack: make the fonts available by directly copying the font files into org.freedesktop.Platform's directories, e.g.

/var/lib/flatpak/runtime/org.freedesktop.Platform/x86_64/version/hash/files/etc/fonts/conf.avail
/var/lib/flatpak/runtime/org.freedesktop.Platform/x86_64/version/hash/files/etc/fonts/conf.d 
/var/lib/flatpak/runtime/org.freedesktop.Platform/x86_64/version/hash/files/share/fonts

Steam Flatpak start (run) issues

After launch, Steam will try to download files and you will see a progress bar. If it crashes, you may try to give additional permissions to the flatpak package:

$ flatpak permission-set background background com.valvesoftware.Steam yes
$ flatpak run com.valvesoftware.Steam

For an alternative way to control permissions, install flatseal.

Troubleshooting

See Steam/Troubleshooting.

See also