<WRAP group>
<WRAP round box twothirds column>
{{ https://raw.githubusercontent.com/fabricecaruso/es-theme-carbon/master/art/logos/steam.svg?nolink&300 }}

====== Steam ======

You can only install Steam on //x86_64// platforms (unfortunately we aren't magic).

<WRAP center round important>
If intending on running Windows-only games, it is recommended to use **btrfs** or **ext4** for ''/userdata/'' as WINE [[https://wiki.winehq.org/FAQ#Does_Wine_run_on_all_Unix_filesystems.3F|explains on their FAQ]] that some games won't run on a non-Linux native file system. Steam games are [[https://developer.valvesoftware.com/wiki/Steam_under_Linux#Wine.2C_Steam_.26_ntfs-3g|notoriously known to be unusable under WINE when using ntfs]].
</WRAP>

<WRAP center round help>
From Batocera **v32** and above there is a bug where Flatpaks (including Steam) cannot be installed if you are using a NAS.

If you still want to use a NAS for the rest of your systems' saves, [[:troubleshooting#nas_workaround_for_affected_systems|Flatpaks can still be installed to internal storage as a workaround]].
</WRAP>

<WRAP center round tip>
Steam is installed via Flatpak, which [[systems:flatpak|has its own page]].
</WRAP>

Useful resources:
  * The [[https://www.pcgamingwiki.com/wiki/Home|PCGamingWiki]] for general tips about PC gaming.
  * [[https://www.protondb.com/explore|ProtonDB]] for [[#installing_windows-only_games|running Windows-only games]] in Linux-based operating systems (such as Batocera).
  * The [[https://steam.fandom.com/wiki/SteamWiki|SteamWiki fandom page]], particularly its [[https://steam.fandom.com/wiki/List_of_DRM-free_games|list of DRM-free games]].

This system scrapes metadata for the "steam" group ([[#no_boxart_for_my_steam_games_and_i_can't_scrape_for_them|no scraper supports this group (yet)]]) and loads the ''steam'' set from the currently selected theme, if available.
</WRAP>

<WRAP third column>

</WRAP>
</WRAP>

==== Quick reference ====

  * **Emulator:** [[#steam|steam]]
  * **Folder:** ''/userdata/roms/steam''
  * **Accepted ROM formats:** ''.steam''

<WRAP center round info>
Since Steam is a Flatpak, it too saves program data to the saves folder instead as well. Only the shortcuts are stored in the ROMs folder.
</WRAP>


===== Installation =====

<WRAP center round important>
A mouse and keyboard will be required for the first launch of Steam.
</WRAP>


==== Installing the Steam flatpak ====

=== Using the GUI ===

This video shows the install process using the flatpak-config UI, and the launch of the Steam application via the Steam system menu in EmulationStation.
This applies from Batocera v40 and later.

{{ :emulators:steamv40.mp4?direct&720 |}}

Steam will be installed via Flatpak. The recommended way to do so is [[systems:flatpak#using_flatpak-config|using the flatpak-config GUI]]. Add the Flathub remote, search for "Steam" and install the appropriate package. See the video above for more details.

{{ :systems:virtualbox_batocera.linux_for_pc_31x64_18_10_2021_07_54_52.png?direct&720 |}}

=== Using SSH ===

If for some reason that doesn't work, you can install Steam via [[:access_the_batocera_via_ssh|SSH]]:

<code>
# flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# flatpak install com.valvesoftware.Steam
Looking for matches…
Required runtime for com.valvesoftware.Steam/x86_64/stable (runtime/org.freedesktop.Platform/x86_64/24.08) found in remote flathub
Do you want to install it? [Y/n]:
</code>

Some older Batocera releases may already have the `flathub` remote installed.


=== Update game list ===

To add Steam to EmulationStation from **v40** or higher you need to update the Games List to get the Steam system on your main menu:

{{:systems:screenshot-2024.07.25-13h07.30.png?720|}}
{{:systems:screenshot-2024.07.25-13h07.06.png?720|}}

**Note: Ensure you launch Steam from within the Steam systems menu to allow the initial configuration.**

When launched, Steam will have to install its updates and then you'll be greeted by the Steam login dialog. If you have two-factor authentication, you'll need your phone handy as well. Sign in and wait patiently for Steam to do some house-cleaning.

<WRAP center round important>
If immediately returned to the menu when attempting to launch Steam, just try again. Steam seems to be a bit unstable with its first launch, but eventually it will sort itself out.
</WRAP>

==== Initial Steam configuration ====

Unfortunately Steam has some not-so-desirable defaults that need to be changed. First, navigate to **View** -> **Settings** -> **Steam Play** and check "Enable Steam Play for supported titles". This will automatically have Steam activate Steam Play/Proton to play white-listed non-Linux native games on your system.

{{ systems:steam-activate-steamplay.png?540 |The Steam Play settings menu.}}

Optional: While in this menu, go to **Interface** and check "Start Steam in Big Picture Mode". Big picture mode (BPM for short) is a 10-foot user interface, optimal for use with couches facing large-screen TVs. Otherwise, you can start standard steam and press HOTKEY to switches to Big Picture Mode.

{{ systems:activate-steam-bpm.png?540 |The Interface settings menu. You can't miss it.}}

<WRAP center round important>
If using a resolution equal to or lower than 640x480 using Big Picture mode may cause issues.
</WRAP>

Exit and relaunch Steam. You no longer need a mouse and keyboard at this point.

{{ blog:screenshot-2021.09.03-03h36.47.jpg?nolink&720 |Steam's Big Picture mode. Now we're talking.}}

<WRAP center round help>
Steam's Flatpak version currently does not support PS4/5 controllers correctly. This is a known issue to Steam and they are investigating.

The issue is unrelated to Batocera. You can employ [[#my_ps4_controller_isn't_working_with_steam|the workaround as specified in the troubleshooting section below]] for PS4 controllers to work around it for now.
</WRAP>

===== Installing native Linux games =====

Installing [[https://store.steampowered.com/linux|Linux-native games]] is straightforward. Navigate to the game in your library and install it.

{{ blog:screenshot-2021.09.03-04h33.36.jpg?nolink&720 |Installing a game with Steam. When did Rocket League get this large?!}}

<WRAP center round info>
On the first launch of a game, it may take a moment to generate shaders. But after that, launching should be relatively quick!
</WRAP>

===== Installing Windows-only games =====

When "Enable Steam Play for supported titles" is checked and the game is white-listed by Valve, the process is similar. Navigate to the game in your library and install it. Non-Linux compatible titles will utilize [[https://steamcommunity.com/games/221410/announcements/detail/1696055855739350561?snr=|Steam Play/Proton]] to function in Batocera. If however your game is "Not on SteamOS", you can manually force Steam to use Proton to attempt to launch it.

You can also search for your games on the [[https://docs.google.com/spreadsheets/d/1QptxTF9_2nHPaT02F5YllN-DaWMn5tMlgvHbNK3MdTM/edit#gid=1116822551|tested Windows games running on Batocera spreadsheet]], however do note this includes //all// Windows games, not just ones from Steam. In case that link ever goes down, [[systems:windows_on_batocera_spreadsheet|a static copy is available on this wiki]].

<WRAP center round tip>
You can set the default Proton to try by checking the option **Enable Steam play for all other titles** and selecting the preferred version of Proton. Most games work best with the **Proton (Community build)**.
</WRAP>

==== Manually forcing a specific Proton version for a game ====

=== In Big Picture Mode ===

First, [[#proton|install all the versions of Proton]] you would like to try. Then once installed:

  - Navigate to the game in Steam
  - Go to **Manage Game** -> **Set Steam Play Options...**
  - Check "Force the use of a specific Steam Play compatibility tool" and select the latest stable Proton release
  - Steam will now let you install the game, do so and wait for it to complete (you can still navigate to other pages in Steam if you want to)
  - Test the game, it may take several minutes for each attempt as it needs to recompile shaders for each version of Proton used
  - If the game fails to launch (indicated by the Steam page offering to "PLAY" again instead of opening the game), try forcing the next older Proton version [or select the version already tested according to to [[https://www.protondb.com/explore|ProtonDB|]]
  - Repeat steps 5 and 6 until you find a version of Proton that launches the game correctly

A community-maintained list of games compatible with Proton and what version of Proton was used is available at the [[https://www.protondb.com/explore|ProtonDB website]].

{{ blog:how-to-install-windows-steam-games.webm?655x368 |Sometimes running a game through Proton is even better than its Linux-native version!}}

<WRAP center round important>
On the first launch of a game, it may take a moment to generate shaders. But after that, launching should be relatively quick!

For Windows games being launched via Proton, <wrap em>no progress bar will be shown to indicate this</wrap>. The game will appear as "Running", and it will launch after a period of time.
</WRAP>

=== In desktop mode ===

  - Right-click the game's entry in the list on the left side. {{ systems:steam-right-click.png?nolink |Right-clicking a game in the list opens a menu.}}
  - Go to **Properties** -> **Compatibility**.
  - Check "Force use of a specific Steam Play compatibility tool". {{ systems:steam-compatibility-menu.png?540 |It should contain a blue checkmark.}}
  - Select the appropriate Proton version (a community-maintained list of games compatible with Proton and what version of Proton was used on the [[https://www.protondb.com/explore|ProtonDB]]).

<WRAP center round important>
On the first launch of a game, it may take a moment to generate shaders. But after that, launching should be relatively quick!

For Windows games being launched via Proton, <wrap em>no progress bar will be shown to indicate this</wrap>. The game will appear as "Running", and it will launch after a period of time.
</WRAP>

===== Adding games to the "Steam" system in ES =====

If you want to add your installed Steam games to the EmulationStation's "Steam" system section, note that it is mandatory to check the following two options on every Steam game installation, as the Batocera gamelist update script relies on those shortcuts/icons:
  * //Create desktop shortcut//
  * //Create a system application icon// \\ {{:systems:steamgamesshortcuts.png?400|}}

<WRAP center round tip 60%>
Note: If you have already installed the Steam game without creating the according desktop shortcut or if you added a non-Steam game to the Steam library, you can still do this manually. Just highlight and right-click the according game in Steam and click \\ //Manage// → //Add desktop shortcut//. \\ Then you can find the desktop icon on the following path: \\
''/userdata/saves/flatpak/data/.var/app/com.valvesoftware.Steam/Desktop/<myGame>.desktop'' \\
Now you have to duplicate the desktop shortcut to the according path by executing: \\
''cp /userdata/saves/flatpak/data/.var/app/com.valvesoftware.Steam/Desktop/<myGame>.desktop /userdata/saves/flatpak/data/.var/app/com.valvesoftware.Steam/data/applications/''
</WRAP>

Then, simply update the Batocera game list (**MAIN MENU** -> **GAMES SETTINGS** -> **UPDATE GAMES LIST**) to add the installed Steam games to the Steam system in EmulationStation.

{{ blog:screenshot-2021.09.03-22h22.51.jpg?nolink&720 |Steam games will show up in the system list with all your retro-consoles! This satiates my organization OCD!}}

To do this via CLI/SSH (Batocera **v32** and up):

<code>
batocera-steam-update
</code>

===== Sharing the Steam library with another OS =====

It is possible to share a single Steam library across multiple operating systems (provided that each operating system can run the game in the first place on the same platform).

<WRAP center round important>
This is not required and is actively not recommended. It is far simpler to just have multiple libraries, despite the redundancy. Steam's cloud storage arguably nullifies the need to do any of this in the first place.
</WRAP>

Normally, the process should be as simple as using Steam's library managing tool available in **Settings...** -> **Library** -> **Manage Steam libraries** to point Steam to the library installed on Batocera (or vice versa). However due to a bug with Steam's menu, it cannot see anything beyond the ''data'' folder in Batocera. This can still be configured manually:

  - Open the VDF library file for the Steam insallation. This will vary based on operating system:
    * **Pop! OS:** \\ ''~/.steam/debian-installation/config/libraryfolders.vdf''\\ {{:systems:steam_libraryvdf_on_pop_os.png|}}
    * (FIXME more OSes?)
  - Add a new library entry. If you don't know how to type it out, use the Steam menu to do so (pointing to any folder on the intended drive, this will be changed later).
  - Edit the path and the label of the library as appropriate. For example, when pointing an external installation of Steam to Batocera's Steam library: <code ->
        "path"        "/media/maioni/1TB/batocera/saves/flatpak/data/.var/app/com.valvesoftware.Steam/data/Steam/"
        "label"        "BATOCERA"
</code>
  - Steam should now see the installed games.

===== Controls =====

Steam uses your controllers as it does on a regular computer, refer to [[https://help.steampowered.com/en/faqs/view/3725-76D3-3F31-FB63#controller|Steam's official documentation]] to see whether your game supports it or not.

===== Troubleshooting =====

==== Steam itself is not launching ====

First thing to try is simply rebooting and attempting to launch it again. Technology can be great like that.

If that doesn't solve the issue, [[systems:flatpak#troubleshooting|try the troubleshooting section for Flatpaks in general.]] You might also try disabling Big Picture Mode, as it is more prone to errors than the desktop interface.

==== Games are not launching/running slowly/have weird issues ====

Steam is usually pretty good when you're only using it to run Linux-native games. Here are some general troubleshooting steps that apply to all Steam games:
  * If using a Nvidia GPU, [[:supported_pc_hardware#nvidia_drivers|make sure your official Nvidia graphics drivers are enabled and functional]].
    * Sometimes, flatpak will "forget" that you have drivers and will need to "redownload" them (you'll find Steam is suddenly lagging in its menus). Run ''flatpak update'' in the [[:access_the_batocera_via_ssh|SSH]] and if it starts downloading ''org.freedesktop.Platform.GL.nvidia-###-##-##'' then that is what happened.
  * Verify a game's file integrity by going to **Manage Game** -> **Validate Content**. This may take a while.
  * PC games in general (especially ones that were ported from home consoles //to// PC) can be buggy. Check out the [[https://www.pcgamingwiki.com/wiki/Home|PCGamingWiki]] for general tips, settings configurations, [[#setting_up_launch_commands|launch commands]] and patches you can apply to fix the game (just keep in mind it's focused on Windows, not Linux (and thus, not Batocera) so a lot of external programs/patches won't be compatible).
    * Some games work better with their Windows version being run in WINE/Proton instead of their native Linux version. Not all cases.
  * Free up some disk space. Most Steam games need to compile and save shaders before being launched for the first time; if there is not enough free space then this will silently fail.

==== I upgraded Batocera and now Steam isn't working ====

  * Ensure the Steam flatpak is upgraded to the latest version. Sometimes, the ''flatpak-config'' UI will fail, so it's recommended to just run ''flatpak upgrade'' [[:access_the_batocera_via_ssh|via SSH]].

==== Proton ====

Proton is still very experimental, there will be cases where a certain game won't function or will have severe game-breaking glitches. Generally, the newer and always-online multiplayer games tend to be completely unsupported. That being said, here are some things to try troubleshooting your issue:
  * Search the game on [[https://www.protondb.com/|the ProtonDB]] and see what other users have said they've had to do to make it work. You may need to utilize [[#setting_up_launch_commands|custom launch commands]] to get a game working.
  * You can [[#installing_alternate_versions_of_proton|download additional versions of Proton via flatpak]] and then [[#in_big_picture_mode|try them out in the Steam Play settings for that game]]. If none of your Windows-only games are running, redownloading the version of Proton you're using that's already installed may "fix" it.
  * If the game carries its own dynamic link libraries in cabinet files, try extracting them to the root folder of the game itself.
    - For instance, with Sonic CD, here are the DLL files compressed in the archived CAB files:\\ {{:systems:sonic_cd_cab_files.png|}}
    - Open them up in your preferred archive manager and look for the appropriate file. In this case, it is ''D3DCompiler_43.dll'' (without any suffixes usually means the 64-bit one):\\ {{:systems:sonic_cd_d3d_compiler_dll.png|}}
    - Extract the appropriate DLL files to the root folder of the game. In this case, all that was needed were ''d3dx9_43.dll'' and ''D3DCompiler_43.dll'':\\ {{:systems:sonic_cd_dlls_in_folder.png|}} <WRAP center round tip>
If you need the specifics of which DLL files the game might need, refer to the [[https://www.protondb.com/|the ProtonDB]] as mentioned above.
</WRAP>

==== Installing alternate versions of Proton ====

Press ''[F1]'' while on the system list, go to **Applications** and launch ''flatpak-config''. Then search for "Proton" and install the following flatpaks:

  * Proton (community build)
  * Proton Experimental (community build)
  * Proton-GE (community build)

{{ :systems:proton_install.png?direct&720 |}}

Alternatively, [[:access_the_batocera_via_ssh|sign into SSH]] and run:

<code>
flatpak install com.valvesoftware.Steam.CompatibilityTool.Proton com.valvesoftware.Steam.CompatibilityTool.Proton-Exp com.valvesoftware.Steam.CompatibilityTool.Proton-GE
</code>

==== Steam BETA Update client issues: Access Big Picture Mode with Gamepad in Beta Client | Unable to change settings in Beta Client ====

Those two issues are reproducible only in the Steam BETA update client version:
- Unable to initialize Big Picture Mode with Gamepad Hotkey (Start Key in the Steam) in the Steam Beta Client version
- Unable to change any settings from steam settings using the interface in the Steam Beta Client version

To fix it, you need to rollback to the regular version, but due to the settings issues, you can't rollback using the interface, so you need to manually delete the beta file to goes back to the standard steam client version

Normally the interface way to do it is:
<code>
Settings/Preferences > Account > Beta Participation - Steam > NONE
</code>
But if you can't to do it due to the interface window issue, do it manual:
At batocera, open the file manager [F1}, and the **delete the beta file** found in steam/packages:
<code>
/userdata/saves/flatpak/data/.var/app/com.valvesoftware.Steam/.steam/steam/package/beta
</code>

Exit the file manager and relaunch steam again at ports, it will be updated to the regular version again.
It will be possible to start big picture mode pressing the gamepad Hotkey button and also interact correctly with the steam windows.

==== Setting up launch commands ====

Sometimes a game may need certain launch parameters to work. This can be used to configure the settings of a game before it runs, allowing it to boot in the first place if it's by default using incompatible settings. You can refer to [[https://help.steampowered.com/en/faqs/view/7D01-D2DD-D75E-2955|Valve's official documentation]] on it. These launch commands should also be respected when launching the game through EmulationStation.

=== In Big Picture Mode ===

  - Navigate to the game.
  - Go to **Manage Game Options** -> **Set Launch Options**.
  - Enter your launch commands and press OK.

=== In desktop mode ===

If not using Steam's Big Picture Mode the instructions would be as follows:
  - Right-click the game's entry in the list on the left side.\\ {{systems:steam-right-click.png?nolink|Right-clicking a game in the list opens a menu.}}
  - Go to **Properties** -> **General**.
  - Enter your launch commands into **LAUNCH OPTIONS** and press OK.\\ {{systems:steam-launch-options.png?540|The game's properties menu.}}

<WRAP center round tip>
A common launch command to add which fixes many games is ''PROTON_USE_WINED3D=1 %command%'' (as shown in the above screenshot).
</WRAP>

==== Editing game files ====

Should you need to edit a game's files directly, they are in \\ ''/userdata/saves/flatpak/data/.var/app/com.valvesoftware.Steam/.local/share/Steam/steamapps/common/''

You will need to enable "view hidden folders" to see beyond the ''.var/'' directory.

==== My game has successfully installed and runs from Steam, but is not showing up on my games list in EmulationStation ====

Some games instead opt to create desktop shortcuts that Batocera fails to detect in \\ ''/userdata/saves/flatpak/data/.var/app/com.valvesoftware.Steam/Desktop'' \\ You can remedy this by copying the shortcut to \\ ''/userdata/saves/flatpak/data/.var/app/com.valvesoftware.Steam/.local/share/applications'' \\ instead and then refreshing your game list.

If this is a frequent problem for you, you can permanently symlink the folders using the following [[:access_the_batocera_via_ssh|command]]: \\ ''ln -s /userdata/saves/flatpak/data/.var/app/com.valvesoftware.Steam/Desktop /userdata/saves/flatpak/data/.var/app/com.valvesoftware.Steam/.local/share/applications''

==== My game has no controls! ====

This is also a problem with regular Steam on Windows, especially with older titles that didn't adhere to controller API standards such as X-input. This can be worked around by forcing Steam Input on the game in question. Navigate to the game in Steam, then go to **Manage Game** -> **Controller Options** -> **Steam Input Per-Game Setting** and set it to "Forced On".

Then you can configure your controller from the **Controller Configuration** in that same **Manage Game** menu. It is usually easiest to emulate a mouse and keyboard.

<WRAP center round tip>
From Batocera **v33** and higher, an alternative to this is to use Batocera's pad2key profile. Highlight over the game in EmulationStation and hold {{:wiki:south.png?nolink&20|South button (B SNES)}} to bring up the game options menu. Then navigate to **CREATE PAD2KEY PROFILE**, and configure the keys as necessary.
</WRAP>

  - Launch the game in question. Once in, press the home button on your controller to bring up the Steam overlay.\\ {{:systems:screenshot-2022.04.08-14h11.05.png?600|}}
  - Under **Controller Options**, ensure that your appropriate controller is enabled for Steam Input configuration (if unsure, just check all the boxes here).\\ {{:systems:screenshot-2022.04.08-22h01.10.png?600|}}
  - Return to the Steam Overlay, and then go to **Controller Configuration**. You will be brought to the following screen (it looks different depending on which controller has been detected):\\ {{:systems:screenshot-2022.04.08-14h11.36.png?600|}}
  - Press the button (labelled at the bottom of the screen, usually {{:wiki:west.png?nolink&20|West button (Y SNES)}}) to "Browse configs".\\ {{:systems:screenshot-2022.04.08-14h12.17.png?600|}}
  - Scroll down to **Community**, press right, and select whichever control layout you prefer. The top one is usually okay.\\ {{:systems:screenshot-2022.04.08-14h12.34.png?600|}}
  - After selecting the profile, you will be shown a preview of its layout. Press the button (labelled at the bottom, usually {{:wiki:west.png?nolink&20|West button (Y SNES)}}) to apply the layout.\\ {{:systems:screenshot-2022.04.08-14h13.04.png?600|}}
  - Your controls should now be applied in-game!

Controller layouts can be manually customized, refer to [[https://partner.steamgames.com/doc/features/steam_controller|Steam Input's documentation]].

==== My PS4 controller isn't working with Steam ====

This was a known issue with Steam in Flatpak. The exact cause and the exact solution aren't clear, but here's one thing users have been doing to moderate success with Steam on Batocera:

Download the following udev rule file and copy it to \\ ''/etc/udev/rules.d/99-steam-controller-perms.rules'' \\ (you can do this using Batocera's file manager (''[F1]'' in the system list) or via WinSCP):

<code - 99-steam-controller-perms.rules>
# This rule is needed for basic functionality of the controller in Steam and keyboard/mouse emulation

SUBSYSTEM=="usb", ATTRS{idVendor}=="28de", MODE="0666"

# This rule is necessary for gamepad emulation; make sure you replace 'pgriffais' with a group that the user that runs Steam belongs to

KERNEL=="uinput", MODE="0660", GROUP="batocera", OPTIONS+="static_node=uinput"

# Valve HID devices over USB hidraw

KERNEL=="hidraw*", ATTRS{idVendor}=="28de", MODE="0666"

# Valve HID devices over bluetooth hidraw

KERNEL=="hidraw*", KERNELS=="*28DE:*", MODE="0666"

# DualShock 4 over USB hidraw

KERNEL=="hidraw*", ATTRS{idVendor}=="054c", ATTRS{idProduct}=="05c4", MODE="0666"

# DualShock 4 wireless adapter over USB hidraw

KERNEL=="hidraw*", ATTRS{idVendor}=="054c", ATTRS{idProduct}=="0ba0", MODE="0666"

# DualShock 4 Slim over USB hidraw

KERNEL=="hidraw*", ATTRS{idVendor}=="054c", ATTRS{idProduct}=="09cc", MODE="0666"

# DualShock 4 over bluetooth hidraw

KERNEL=="hidraw*", KERNELS=="*054C:05C4*", MODE="0666"

# DualShock 4 Slim over bluetooth hidraw

KERNEL=="hidraw*", KERNELS=="*054C:09CC*", MODE="0666"
</code>

Then run ''batocera-save-overlay'' and reboot. Test if your PS4 controller is working with Steam now. ^_^

==== No boxart for my Steam games and I can't scrape for them ====

Steam //should// provide the boxart and other relevant metadata for the games it installs. This is dependent on the publisher of the original game properly filling out all the metadata themselves to Steam's database when the game is submitted.

Guess how often that happens.

You can always manually add boxart to your games through **GAME OPTIONS** (hold {{:wiki:south.png?nolink&20|South button (B SNES)}} while hovering over the game) -> **EDIT THIS GAME'S METADATA**.

You might also have more luck using an external scraping tool such as [[https://forum.batocera.org/d/1288-arrm-scraper-gamelist-roms-manager|ARRM]].

==== Steam's menus are slow/laggy in the desktop version ====

For couch use Big Picture mode is recommended. However those that prefer to use Desktop mode may improve its performance by tweaking the following settings:

  * In **Library**: check **Low bandwidth mode** and **Low performance**.

  * In **Download**: set a range of time for auto-downloading at **Only auto-update games between**.

  * In **Shader pre-caching**: check **Allow background processing of Vulkan**.

==== Steam's stuck on waiting for network ====
See github issue: [[https://github.com/batocera-linux/batocera.linux/issues/9011|Steam Flatpak stuck on "waiting for network"]]: when looking at the network, it shows. Error: "e.StartScanningForNetworks is not a function".

The workaround is to open ''/share/roms/flatpak/steam.flatpak'' with a text editor and write: 
<code>
com.valvesoftware.Steam -vgui
</code>
then update gamelist in batocera 

==== Steam crashes on windows games ====
The proton version coming with steam is not very compatible with the flatpak version. Install an alternate version of proton by following [[https://wiki.batocera.org/systems:steam#installing_alternate_versions_of_proton]] , then launch your windows games with one of the proton community builds.

==== My laptop has a hybrid gpu and performance is very poor ====
It's possible that Steam is using the iGpu instead of your discrete Gpu.

Possible workarounds for a nvidia discrete card are:
  * Edit your launch options with:
<code>
VK_ICD_FILENAMES=/usr/share/vulkan/nvidia/nvidia_production_icd.x86_64.json %command%
</code>
  * For some games, you need:
<code>
VK_ICD_FILENAMES=/usr/share/vulkan/nvidia/nvidia_production_icd.x86_64.json DXVK_FILTER_DEVICE_NAME="NVIDIA" %command%
</code>
  * If you want to use FSR, the launch option will be:
<code>
VK_ICD_FILENAMES=/usr/share/vulkan/nvidia/nvidia_production_icd.x86_64.json WINE_FULLSCREEN_FSR=1 %command%
</code>
Remember to use "Fullscreen" in your game settings and to lower the resolution for FSR to take effect.
  * if you don't want to modify the launch option for each game, you can also edit your ''/userdata/system/custom.sh'' to export this environment variable with
<code>
#!/bin/bash
case "$1" in
    start) 
        # Code in here will only be executed on boot.
        export VK_ICD_FILENAMES=/usr/share/vulkan/nvidia/nvidia_production_icd.x86_64.json
</code>