Gogg is a minimalistic tool for downloading game files from GOG.com. It is written in Go and uses the official GOG API.
The main goal of Gogg is to provide a simple and easy-to-use interface for people who want to download their GOG games for offline use or archival purposes.
Main features of Gogg:
- It can be used to fully automate the download process with a few simple commands.
- It can run anywhere (Windows, macOS, or Linux) that a Go compiler is available.
- It has a graphical user interface (GUI) that lets users search and download games they own on GOG.
Additionally, it allows users to perform the following actions:
- List owned games
- Export the list of owned games to a file
- Search in the owned games
- Download game files (like installers, patches, and bonus content)
- Filter files to be downloaded by platform, language, and other attributes like content type
- Download files using multiple threads to speed up the process
- Resume interrupted downloads and only download missing or newer files
- Verify the integrity of downloaded files by calculating their hashes
- Calculate the total size of the files to be downloaded (for storage planning)
See the documentation for how to install and use Gogg.
Run gogg -h to see the available commands and options.
Note
- Since version
0.4.1, Gogg has a GUI besides its command line interface (CLI). > The GUI is still in the early stages of development and does not support all the features of the CLI and may have > bugs. > To start the GUI, rungogg gui. - Since version
0.4.2, there are Docker images available for Gogg. > See the documentation for more information.
| File | Description |
|---|---|
| calculate_storage_for_all_games.ps1 | PowerShell script to calculate storage size for all games user owns |
| download_all_games.ps1 | PowerShell script to download all games user owns |
| download_all_games.sh | Bash script to download all games user owns |
| simple_example.sh | Simple examples of how to use Gogg from the command line |
# First-time using Gogg, you need to log in to GOG to authenticate
gogg loginImportant
You might need to have Google Chrome, Chromium, or Microsoft Edge browsers installed on your machine for the first-time authentication. So, make sure you have one of them installed and available in your system's PATH.
# Will fetch the up-to-date information about the games you own on GOG
gogg catalogue refresh# Will show the game ID and title of the games that contain "Witcher" in their title
gogg catalogue search "Witcher"# Will download the files for `The Witcher: Enhanced Edition` to `./games` directory (without extra content)
gogg download 1207658924 ./games --platform=windows --lang=en --dlcs=true --extras=false \
--resume=true --threads 5 --flatten=true# Will show the SHA1 hash of the downloaded files for `The Witcher: Enhanced Edition`
gogg file hash ./games/the-witcher-enhanced-edition --algo=sha1# Will show the total size of the files to be downloaded for `The Witcher: Enhanced Edition`
DEBUG_GOGG=false gogg file size 1207658924 --platform=windows --lang=en --dlcs=true \
--extras=false --unit=GB
Show more screenshots
Please see the CONTRIBUTING.md file for information on how to contribute to Gogg.
Gogg is licensed under the MIT License.