https://github.com/habedi/gogg

A multiplatform game file downloader for GOG
https://github.com/habedi/gogg

command-line-tool downloader go gog golang video-games

Last synced: 17 days ago
JSON representation

A multiplatform game file downloader for GOG

Host: GitHub
URL: https://github.com/habedi/gogg
Owner: habedi
License: mit
Created: 2025-01-11T17:55:27.000Z (10 months ago)
Default Branch: main
Last Pushed: 2025-07-27T14:57:20.000Z (3 months ago)
Last Synced: 2025-08-01T00:29:49.527Z (3 months ago)
Topics: command-line-tool, downloader, go, gog, golang, video-games
Language: Go
Homepage:
Size: 205 KB
Stars: 89
Watchers: 3
Forks: 4
Open Issues: 16
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

---

Gogg is a minimalistic tool for downloading game files from [GOG.com](https://www.gog.com/).
It is written in [Go](https://golang.org/) and uses the
official [GOG API](https://gogapidocs.readthedocs.io/en/latest/index.html).

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.

### Features

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)

---

### Getting Started

See the [documentation](docs/README.md) 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, run `gogg gui`.
> * Since version `0.4.2`, there are Docker images available for Gogg.
> See the [documentation](docs/README.md#containerization) for more information.

#### Examples

| File | Description |
|------------------------------------------------------------------------------------------|---------------------------------------------------------------------|
| [calculate_storage_for_all_games.ps1](docs/examples/calculate_storage_for_all_games.ps1) | PowerShell script to calculate storage size for all games user owns |
| [download_all_games.ps1](docs/examples/download_all_games.ps1) | PowerShell script to download all games user owns |
| [download_all_games.sh](docs/examples/download_all_games.sh) | Bash script to download all games user owns |
| [simple_example.sh](docs/examples/simple_example.sh) | Simple examples of how to use Gogg from the command line |

##### Login to GOG

```bash
# First-time using Gogg, you need to log in to GOG to authenticate
gogg login
```

> [!IMPORTANT]
> You might need to have [Google Chrome](https://www.google.com/chrome/), [Chromium](https://www.chromium.org/), or
> [Microsoft Edge](https://www.microsoft.com/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.

##### Syncing the Game Catalogue

```bash
# Will fetch the up-to-date information about the games you own on GOG
gogg catalogue refresh
```

##### Searching for Games

```bash
# Will show the game ID and title of the games that contain "Witcher" in their title
gogg catalogue search "Witcher"
```

##### Downloading a Game

```bash
# 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
```

##### File Hashes (For Verification)

```bash
# Will show the SHA1 hash of the downloaded files for `The Witcher: Enhanced Edition`
gogg file hash ./games/the-witcher-enhanced-edition --algo=sha1
```

##### Storage Size Calculation

```bash
# 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
```

### CLI Demo

[![asciicast](https://asciinema.org/a/kXMGRUUV149R37IEmZKtTH7nI.svg)](https://asciinema.org/a/kXMGRUUV149R37IEmZKtTH7nI)

### GUI Screenshots