Steam Deck - Heroic-Games-Launcher/HeroicGamesLauncher GitHub Wiki
Steam Deck
Table of Contents
Usage
It is intended to install and configure games from desktop mode only. Running Heroic itself through Game Mode is not supported and you may encounter issues doing so.
The proper way to use Heroic with the Steam Deck is to open Heroic in desktop mode, install and update games from there. You may need to play games at least once in desk top mode to confirm that they are functioning properly and in the case where a game requires user interaction on first launch, such as associating your Epic account with the game via a web browser pop up.
Once a game is installed, you can add it to steam through the 3 dot menu on the game page, or by selecting "auto add to steam" from the heroic settings on the side bar.
How to Install Heroic Games Launcher
Flatpak (Recommended)
To install Heroic Games Launcher using the Flatpak, follow the below steps. The Flatpak is the recommended packaging method to use Heroic Games Launcher on the Steam Deck.
- Switch to Desktop mode.
- Open the app store (Discover).
- Search for "Heroic".
- There should be a result for Heroic Games Launcher. Click install.
- You should now be able to launch Heroic like any other application on your Steam Deck!
Flatpak Permissions
Purpose: Give permissions to SD Card, other partitions, external drives, etc.
Flatpak's containerization while intended for increased security does limit Heroic's permissions to several system's features and folders. It is necessary to give extra permissions to Heroic.
If you are using KDE (includes the Steam Deck):
- Open the
System Settings
- On the left-hand side, click
Applications
under thePersonalization
section - On the left-hand side, click
Flatpak Permission Settings
- In the list of applications, locate Heroic Games Launcher and click it to open the permissions menu.
- On the right-hand side under the
Permissions
menu, locate theFilesystem Access
section. - Click
Add New
and add your preferred path. - When finished, set it to
read/write
and clickOK
- Restart Heroic Games Launcher.
If you are not using KDE:
In this case we will need to install Flatseal from the Discover or another Linux Store that you use.
- Search for and install Flatseal on your Store, Discover on Steam Deck.
- Open Flatseal and Search for Heroic Games Launcher:
- Looks for the Filesystem section and add the folders you need to access like shown on the image above.
- Restart Heroic.
AppImage
To install Heroic Games Launcher using the AppImage, follow the below steps.
- Switch to Desktop Mode.
- Open the Heroic "Releases" page, https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases
- Download the
Heroic-*.*.*.AppImage
file- Depending on when you are reading this page, the version # may differ
- If you do not see the AppImage, click
Show all ## assets
- Move the newly downloaded AppImage to the
/home/deck/Applications
folder- If you do not have an
Applications
folder, it is recommended you create one but you may place the AppImage wherever you would like
- If you do not have an
- Right click the AppImage, click
Properties
,Permissions
, checkIs Exectuable
- Double click the AppImage to open Heroic.
Game Mode
Though it is not recommended to use Heroic in Game Mode, you may add the AppImage to Game Mode by following the below steps. If you are using Heroic in Game Mode, it is highly recommended you only do so to launch your games. Installing, updating, and managing your games should be done in Desktop Mode.
- Switch to Desktop Mode, right click the Heroic AppImage, and click
Add to Steam
- Switch to Game Mode, open the Heroic shortcut by clicking it once.
- Click the
Gear
icon on the right-hand side of the screen. - Click
Properties
- On the left-hand side of the screen, click
Shortcut
- Scroll down to
Launch Options
- Type
--no-sandbox
- Heroic will now launch in Game Mode.
How to Add Heroic Games to Steam/Game Mode
Non-Steam games added to Steam will automatically appear in Game Mode under the "Non-Steam" tab. In order to add non-Steam games to Steam, follow the below steps.
Manual
These steps will cover how to manually add a Heroic game to Steam after it is installed.
- In Desktop Mode, open Heroic.
- Either install a game or select an already installed game in Heroic.
- Click the three vertical dots in the top-right section of the screen.
- Click
Add to Steam
- The game will now be added to Steam and appear under the "Non-Steam" tab in Game Mode.
Automatic
These steps will cover how to automatically add a Heroic game to Steam after it is installed.
- In Desktop Mode, open Heroic.
- On the left-hand side of the screen, click
Settings
- On the left-hand side of the screen, click
Add games to Steam automatically
- Any newly installed Heroic games will automatically get added to Steam and appear under the "Non-Steam" tab in Game Mode.
HDR
Flatpak
The Heroic Flatpak requires the Gamescope Flatpak to enable HDR. However, the Flatpak Gamescope version must match the version of the natively installed Gamescope. As of October 29th, 2024, the Steam Deck Gamescope is on version 3.15.13-2
. The natively installed Gamescope is close enough to the latest version of the Flatpak meaning the only step required to enable HDR is to install the Flatpak Gamescope.
To enable HDR with the Flatpak version of Heroic, follow the below steps.
- Switch to Desktop Mode.
- Open Konsole.
- The following command will set a sudo password. If this is your first time setting a sudo password, make sure it is secure and that you do not forget it. if you have already set a sudo password, skip to Step 4.
passwd
- Konsole will prompt you to create a password, any characters typed here will not display in the terminal. Once you have typed a password, press enter and Konsole will ask you to type it again to confirm.
- If the commands after this step request a sudo password, type the password you created here for the respective step.
- Type the following command and press enter:
flatpak install org.freedesktop.Platform.VulkanLayer.gamescope --system -y
- If you see a list, select
runtime/org.freedesktop.Platform.VulkanLayer.gamescope/x86_64/24.08
by typing the respective number. For example, if it is the third item in the list, type3
and press enter.
- The Flatpak Gamescope will now be installed and HDR will now work in Game Mode.
Optional: Freezing Updates
If the Gamescope Flatpak updates and is no longer in sync with the natively installed Gamescope, HDR may stop working. As an optional step, you may mask the Gamescope Flatpak in order to "freeze" its updates.
- Switch to Desktop Mode.
- Open Konsole
- Type the following command and press enter:
sudo flatpak mask org.freedesktop.Platform.VulkanLayer.gamescope
- The Gamescope Flatpak will now be masked and its updates will be "frozen".
To unmask the Gamescope Flatpak, use the following command:
sudo flatpak --remove mask org.freedesktop.Platform.VulkanLayer.gamescope
AppImage
HDR will work out of the box with the AppImage.
Common Issues
Mangohud does not work
Check if you have installed the Flatpak version of Mangodhud: flatpak install org.freedesktop.Platform.VulkanLayer.MangoHud
Gamescope not available
Check if you have installed the Flatpak version of Gamescope: flatpak install org.freedesktop.Platform.VulkanLayer.gamescope
If you are on a Steam Deck, the Flatpak version of Gamescope must match the natively installed version. If these versions do not match, you may experience increased crashing in other Flatpaks.