Skip to content
This repository has been archived by the owner on May 19, 2024. It is now read-only.

Steam Deck (Flatpak) Guide

Rishabh Moharir edited this page May 14, 2023 · 25 revisions

Note: This guide is subject to change over time

Steam Deck users are recommended to use Heroic's built-in Add To Steam feature.

Setup Guide

  1. Install Heroic Games Launcher.

  2. Log in to your Epic Games and/or GOG account.

  3. Install any game(s).

  4. Download the latest release of Bash Launcher.

  5. Unzip and place the HeroicBashLauncher folder in /home/username/Games/Heroic/

  6. Configure the settings using the settings.config file if you wish to.

  7. Run the HeroicBashLauncher executable. Don't forget to enable executable permission - you can achieve that by doing a right-click, selecting Properties, and enabling "Allow Launching" or something similar.

  8. If you're a Steam Deck user, you should be greeted by the Process Finished dialog at the end and your entire Heroic library will be automatically synced to Steam.

  9. If you're a Linux Desktop user, you should be greeted by the Process Finished dialog at the end along with the newly generated AddToSteam.sh script placed in the above directory.

Adding and Running Games from Steam

You will find launch scripts for all of your installed games under GameFiles. For newly installed games, run the executable again.

  1. Verify if the games' .sh files launch the game with a double-click.

  2. If you're a Steam Deck user, skip to Step 5.

  3. Run the AddToSteam.sh script with a double-click and select a game to be added to Steam. You should be greeted by the Process Finished dialog at the end.

  4. Repeat Step 3 to add more games to Steam.

  5. Restart Steam or switch to the Game Mode UI to find your Heroic games, along with the game's artwork (enabled by default), added to your Library.

Issues

Do note that I don't own a Deck, so you may face Deck-specific issues.

If you're having problems in running the executable or launching a game's launch script -

  • Make sure you've run the game from Heroic at least once.

  • In some cases, the program fails to run when Steam is already running in the background. Exit Steam, run the program, and launch Steam again.

  • Don't enable the Proton compatibility layer for the newly added launch script. You're not trying to run a game but a script. You can set the Wine/Proton version under the game's settings in Heroic itself.

  • Try using Wine-GE instead of Proton/Proton-GE, since Proton is made for Steam games in mind.

  • Check if the TARGET (Right Click Game -> Properties -> SHORTCUT) points to the correct path in Steam.

  • Check the logs to debug the issue.

    • For game launch scripts, the logs are present under GameFiles/logs/
    • For the program, the log is present in the base directory

If it's not working for you, feel free to submit an issue or report it in the heroic-bash-launcher channel by joining Heroic's Discord server.