GOGDL logo

GOGDL Heroic Games Launcher

Use this command to install GOGDL:
winget install --id=HeroicGamesLauncher.GOGDL -e

GOG download module for Heroic Games Launcher

GOGDL is a command-line tool designed to integrate GOG (Good Old Games) functionality into Heroic Games Launcher. It provides essential features for downloading games, managing cloud saves, and launching titles directly from Heroic.

Key Features:

  • Seamless integration with Heroic's ecosystem for streamlined gameplay.
  • Support for downloading GOG game files, including updates and expansions.
  • Cloud save management to sync progress across devices.
  • Authentication handling via token storage for secure access.
  • Cross-platform compatibility, supporting Linux distributions.
  • Available for installation via winget for easy setup.

Audience & Benefit:
Ideal for developers, gamers, and integrators looking to enhance Heroic's functionality with GOG content. It empowers users to manage their GOG library directly within Heroic, ensuring a smooth and efficient gaming experience.

README

heroic-gogdl

GOG download module for Heroic Games Launcher

Important note

This is not user friendly cli, it's meant to be used by some other application wanting to download game files, manage cloud saves or conveniently launch the game

Contributing

The only python dependency needed at this moment is requests

You can install it using your Linux distribution package manager or using pip

pip install requests

To run a code locally, use bin/gogdl script, which is a convenient python wrapper

gogdl now manages authentication, so it no longer needs --token parameter, although you now need to provide a path to json file where the tokens will be stored Heroic uses $XDG_CONFIG_HOME/heroic/gog_store/auth.json

Here is the command to pull the source code

git clone https://github.com/Heroic-Games-Launcher/heroic-gogdl
cd heroic-gogdl
./bin/gogdl --help

If you have any questions ask on our Discord or through GitHub issue

Building PyInstaller executable

If you wish to test the gogdl in Heroic flatpak you likely need to build gogdl executable using pyinstaller

  • Get pyinstaller
pip install pyinstaller
  • Build the binary (assuming you are in heroic-gogdl direcory)
pyinstaller --onefile --name gogdl gogdl/cli.py

Great resources about GOG API

Versions
1.1.2
Website
License