### DOSBox Command Arguments for Linux Offline Installers

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/How-To:-DOSBOX-and-SCUMMVM

Example command arguments for launching DOSBox games installed via Linux offline installers. These are typically found in the 'start.sh' file.

```bash
dosbox -conf "${conf_1}" -conf "${conf_2}" -no-console -c exit
```

--------------------------------

### ScummVM Command Arguments for Linux Offline Installers

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/How-To:-DOSBOX-and-SCUMMVM

Example command arguments for launching ScummVM games installed via Linux offline installers. These are typically found in the 'start.sh' file.

```bash
scummvm -c "${conf}" --themepath=scummvm
```

--------------------------------

### Install 7zip using Homebrew

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Using-Heroic-on-a-Mac-computer

Install the '7zip' package using Homebrew. Note that this installs the '7zz' command, and a symlink for '7z' may need to be manually created.

```sh
brew install 7zip
```

--------------------------------

### Install Heroic via WinGet on Windows

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/blob/main/README.md

Use the WinGet package manager to install Heroic on Windows.

```powershell
winget install Heroic
```

--------------------------------

### Install DOSBOX Staging Flatpak

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/How-To:-DOSBOX-and-SCUMMVM

Use this command to install the DOSBOX Staging Flatpak if you are using the Heroic Games Launcher Flatpak.

```bash
flatpak install io.github.dosbox-staging
```

--------------------------------

### Install Heroic Games Launcher via Flatpak

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Linux-Quick-Start-Guide

Use this command to install the Heroic Games Launcher Flatpak from the terminal. Ensure Flatpak is installed on your system first.

```bash
flatpak install com.heroicgameslauncher.hgl
```

--------------------------------

### Install ScummVM Flatpak

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/How-To:-DOSBOX-and-SCUMMVM

Use this command to install the ScummVM Flatpak if you are using the Heroic Games Launcher Flatpak.

```bash
flatpak install org.scummvm.ScummVM
```

--------------------------------

### Install zenity using Homebrew

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Using-Heroic-on-a-Mac-computer

Install the 'zenity' package using Homebrew, which is required for the graphical interface of Winetricks. This is optional if you only need Winetricks for known-fixes.

```sh
brew install zenity
```

--------------------------------

### Development on Nix

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/blob/main/README.md

Use nix-shell to make Node.JS/pnpm available and automatically run installation steps for Nix users.

```bash
nix-shell
```

--------------------------------

### Install Heroic via dpkg on Debian/Ubuntu

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/blob/main/README.md

Use this command to install the .deb package directly on Debian, Ubuntu, and their derivatives.

```bash
sudo dpkg -i Heroic*amd64.deb
```

--------------------------------

### Install Heroic using Nix shell

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/blob/main/README.md

This command installs Heroic using Nix shell, providing a temporary environment.

```bash
nix-shell -p heroic
```

--------------------------------

### Install Heroic via dnf on Fedora

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/blob/main/README.md

Use this command to install the .rpm package on Fedora systems.

```bash
sudo dnf install ./heroic-*.x86_64.rpm
```

--------------------------------

### Install Flatseal

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/How-To:-DOSBOX-and-SCUMMVM

Use this command to install Flatseal, a tool for managing Flatpak permissions.

```bash
flatpak install com.github.tchx84.Flatseal
```

--------------------------------

### Install cabextract using Homebrew

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Using-Heroic-on-a-Mac-computer

Install the 'cabextract' package using Homebrew, which is a dependency for Winetricks to install certain packages and apply game fixes.

```sh
brew install cabextract
```

--------------------------------

### Install Gamescope Flatpak for HDR

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Steam-Deck

Installs the Gamescope Flatpak required for HDR support with the Heroic Games Launcher Flatpak. Ensure the version is compatible with the natively installed Gamescope.

```bash
flatpak install org.freedesktop.Platform.VulkanLayer.gamescope
```

--------------------------------

### Configure Heroic installation in NixOS

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/blob/main/README.md

Add Heroic to your system packages in NixOS by including it in your configuration.nix file.

```nix
# /etc/nixos/configuration.nix
{ config, pkgs, ... }:

{
  users.users.example = {
    isNormalUser = true;
    description = "Example user";
    packages = with pkgs; [
      heroic
    ];
  };
}
```

--------------------------------

### Install Heroic via Homebrew on macOS

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/blob/main/README.md

Install Heroic using Homebrew on macOS. The --no-quarantine flag is often necessary for security compliance.

```bash
brew install --cask --no-quarantine heroic
```

--------------------------------

### Install MangoHud Flatpak

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Steam-Deck

Installs the Flatpak version of MangoHud, which is necessary for it to function correctly with Flatpak applications. Ensure the version is compatible with the '24.08' runtime.

```bash
flatpak install org.freedesktop.Platform.VulkanLayer.MangoHud
```

--------------------------------

### Resolve 'No such file or directory: .../bin/wine' error

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Troubleshooting-Heroic-and-Games

This error typically means missing Wine dependencies. Install them if not using Flatpak, or restart Heroic if using Flatpak and it was updated while running.

```log
File "legendary/cli.py", line 3148, in <module>
File "legendary/cli.py", line 3063, in mainFile "legendary/cli.py", line 706, in launch_game
File "subprocess.py", line 951, in __init__File "subprocess.py", line 1837, in _execute_child
FileNotFoundError: [Errno 2] No such file or directory: '/home/.../.config/heroic/tools/wine/Wine-GE-latest/bin/wine'
[11578] Failed to execute script 'cli' due to unhandled exception!
```

--------------------------------

### Install Gamescope Flatpak (Common Issues)

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Steam-Deck

Installs the Gamescope Flatpak, a common troubleshooting step if Gamescope is not available for HDR functionality. On Steam Deck, version compatibility is important to prevent crashes.

```bash
flatpak install org.freedesktop.Platform.VulkanLayer.gamescope/x86_64/24.08
```

--------------------------------

### Install and Reinstall Heroic Games Launcher Flatpak

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Linux-Quick-Start-Guide

Use this command to update your Flatpak installations and then reinstall the Heroic Games Launcher. This command does not remove or clear any existing data or configurations.

```bash
flatpak update && flatpak install --reinstall com.heroicgameslauncher.hgl
```

--------------------------------

### Create symlink for 7z command

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Using-Heroic-on-a-Mac-computer

After installing 7zip via Homebrew, create a symbolic link for the '7z' command to ensure compatibility with tools that expect it.

```sh
sudo ln -s /path_from_which/7zz /path_from_which/7z
```

--------------------------------

### Create Symlink for Paradox Launcher

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Paradox-Launcher-for-native-Linux-games-from-GOG

Run this command once to create a symbolic link that resolves the Paradox Launcher path issue for Flatpak installations of Heroic Games Launcher. This is a workaround until Paradox officially fixes the bug.

```bash
ln -s /home/$USER/.var/app/com.heroicgameslauncher.hgl/.local/share/Paradox\ Interactive /home/$USER/.var/app/com.heroicgameslauncher.hgl/data/Paradox\ Interactive
```

--------------------------------

### Launch Rocket League with Bakkesmod on Linux

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Rocket-League

Use this batch script to launch Bakkesmod and then Rocket League with the `-noeac` flag. Ensure the paths are correct for your installation.

```batch
@echo off

set RL_PATH=%cd%\Binaries\Win64

echo Launching BakkesMod...
C:
cd "C:\Program Files\BakkesMod"
start BakkesMod.exe
echo BakkesMod started, starting Rocket League: %RL_PATH%
Z:
cd %RL_PATH%
Launcher.exe -noeac %*

```

--------------------------------

### Check Gamescope Version

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Steam-Deck

Verifies the currently installed version of Gamescope. This is crucial for ensuring compatibility between the Flatpak and native installations when enabling HDR.

```bash
gamescope --version
```

--------------------------------

### Start Heroic Games Launcher with Hot Module Replacement

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/blob/main/README.md

Starts Heroic Games Launcher using Vite's development server for rapid testing and debugging with hot module replacement (HMR) and hot reload (HR).

```bash
pnpm start
```

--------------------------------

### Install Rosetta on Apple Silicon Macs

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Using-Heroic-on-a-Mac-computer

Run this command in the terminal to install or update the Rosetta translation layer, which is required for running Windows applications on Apple Silicon.

```sh
softwareupdate --install-rosetta
```

--------------------------------

### Sample goggame.info JSON for Game Launch Configuration

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/How-To:-DOSBOX-and-SCUMMVM

This JSON structure from a goggame.info file shows the primary playTask, including arguments and working directory, used to launch a Windows build game.

```json
{
    "buildId": "51156444997712340",
    "clientId": "49002505861146264",
    "gameId": "1207658695",
    "language": "English",
    "languages": [
        "en-US"
    ],
    "name": "Beneath a Steel Sky",
    "playTasks": [
        {
            "arguments": "-c \"..\\beneath.ini\" beneath",
            "category": "game",
            "isPrimary": true,
            "languages": [
                "*"
            ],
            "name": "Beneath a Steel Sky",
            "path": "ScummVM\\scummvm.exe",
            "type": "FileTask",
            "workingDir": "ScummVM"
        },
        {
            "category": "document",
            "languages": [
                "*"
            ],
            "name": "Manual",
            "path": "Manual.pdf",
            "type": "FileTask"
        },
        {
            "category": "document",
            "languages": [
                "*"
            ],
            "link": "http://www.gog.com/support/beneath_a_steel_sky",
            "name": "Support",
            "type": "URLTask"
        },
        {
            "category": "document",
            "languages": [
                "*"
            ],
            "name": "Walkthrough",
            "path": "Walkthrough.pdf",
            "type": "FileTask"
        }
    ],
    "rootGameId": "1207658695",
    "version": 1
}
```

--------------------------------

### Build Heroic Binaries for Windows

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/blob/main/README.md

Builds Heroic Games Launcher binaries for Windows.

```bash
pnpm dist:win
```

--------------------------------

### Make AppImage executable

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/blob/main/README.md

After downloading the AppImage, use this command to make it executable before running it.

```bash
chmod +x Heroic*.AppImage
```

--------------------------------

### Build Heroic Binaries for macOS

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/blob/main/README.md

Builds Heroic Games Launcher binaries for macOS.

```bash
pnpm dist:mac
```

--------------------------------

### Clone Heroic Games Launcher Repository

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/blob/main/README.md

Clone the repository and navigate into the project directory. Ensure submodules are included.

```bash
git clone https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher.git --recurse-submodules
cd HeroicGamesLauncher
```

--------------------------------

### Build Heroic Binaries for Linux

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/blob/main/README.md

Builds Heroic Games Launcher binaries for Linux. Optionally specify a package format like deb, pacman, tar.xz, rpm, or AppImage (default).

```bash
pnpm dist:linux # Optionally specify a package to create (eg: deb, pacman, tar.xz, rpm, AppImage); default: AppImage
```

--------------------------------

### Mask Gamescope Flatpak Updates

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Steam-Deck

Optional step to prevent the Gamescope Flatpak from updating, ensuring it remains in sync with the natively installed version to maintain HDR functionality. Use this to freeze updates.

```bash
sudo flatpak mask org.freedesktop.Platform.VulkanLayer.gamescope
```

--------------------------------

### Enable Frontend Logging in Heroic Games Launcher

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Troubleshooting

Launch Heroic Games Launcher with the `--enable-logging` flag or set the `ELECTRON_ENABLE_LOGGING` environment variable to `true` to display frontend logs in the terminal. This is useful for debugging frontend-specific errors.

```bash
heroic --enable-logging
```

```bash
ELECTRON_ENABLE_LOGGING=true heroic
```

--------------------------------

### Create fix.bat for Rockstar Games on Windows

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Rockstar-Games-from-Epic-Games

On Windows, create a fix.bat file to launch Rockstar Games. This batch file uses a custom EpicGamesLauncher.exe wrapper to bypass the main launcher screen and directly start the game.

```batch
start "" EpicGamesLauncher.exe PlayGTAV.exe %*
```

--------------------------------

### Grant Flatpak Permission for DOSBox/ScummVM

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/How-To:-DOSBOX-and-SCUMMVM

Add 'org.freedesktop.Flatpak' to the Session Bus Talks permission in Flatseal for Heroic Games Launcher to interact with DOSBox and ScummVM Flatpaks.

```bash
org.freedesktop.Flatpak
```

--------------------------------

### Defining a Store with Pre-set Keys

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/blob/main/doc/electron_store.md

Use this structure when your store has predefined keys. Add your keys directly into the interface.

```typescript
interface StoreStructure {
  // ...
  myStoreName: {
    myKey: boolean /* or any other type here */
  }
}
```

--------------------------------

### Launch Heroic Games Launcher with gamescope and Firejail

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/How-To:-Other-Tools-and-Wrappers-(gamescope)

Use this command to launch the Heroic Games Launcher through gamescope, with Firejail providing a sandboxed environment. Adjust Firejail options as needed for specific application requirements.

```bash
gamescope -f -- firejail --noprofile --/opt/Heroic/heroic
```

--------------------------------

### Configure Rendering for Cassette Beasts on Mac

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Game-Workarounds

Create an 'override.cfg' file to fix invisible or partially invisible elements in Cassette Beasts on Mac. Ensure the file is plain text and placed correctly.

```cfg
[rendering]
quality/depth_prepass/disable_for_vendors=""
quality/depth_prepass/enable=true
```

--------------------------------

### Sync EGL manifest data

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Troubleshooting-Heroic-and-Games

Use this command to sync EGL manifest data, potentially resolving 'ValueError: EGS ProgramData path does not exist'.

```bash
legendary egl-sync --disable-sync
```

--------------------------------

### Configure Game Settings with Gamescope

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/How-To:-Other-Tools-and-Wrappers-(gamescope)

When launching a specific game, add Gamescope commands to the Advanced Options (Environment Variables) in Heroic's game settings. Ensure to append '--' at the end of your Gamescope command.

```bash
gamescope -w 1920 -h 1080 -W 3440 -H 1440 -b --
```

```bash
DXVK_HUD=full gamescope ... --
```

--------------------------------

### Configure Bioshock Collection Alternative EXE

Source: https://github.com/heroic-games-launcher/heroicgameslauncher/wiki/Game-Workarounds

To skip the launcher for Bioshock Collection, set the alternative executable to the game's main executable.

```text
{GameFolder}/Binaries/Win32/ShippingPC-XGame.exe
```