https://github.com/timendum/gog_achievements
https://github.com/timendum/gog_achievements
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/timendum/gog_achievements
- Owner: timendum
- Created: 2026-01-31T16:35:00.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2026-01-31T17:40:42.000Z (4 months ago)
- Last Synced: 2026-02-01T05:26:19.227Z (4 months ago)
- Language: Go
- Size: 4.88 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GOG Achievements Manager
This is a Go cli application allows you to manage GOG achievements manager.
Features:
- list all achievements, locked and unlocked
- unlock a locked achievement
## Requirements
- Go 1.21 or later
- Windows OS (uses Windows Registry for GOG Galaxy token)
## Installation
1. Install dependencies:
```bash
go mod download
```
1. Build the application:
```bash
go build -o gog-achievements.exe main.go
```
## Usage
### List all owned games
```bash
./gog-achievements.exe
```
### View all achievements for a game
```bash
./gog-achievements.exe
```
### Unlock one or more achievements
```bash
./gog-achievements.exe [achievement-id] ...
```
### Clear one or more achievements
```bash
./gog-achievements.exe -c [achievement-id] ...
```
### Enable verbose logging
Add the `-v` flag to any command to enable verbose logging:
```bash
./gog-achievements.exe -v
./gog-achievements.exe -v
./gog-achievements.exe -v
```
## Examples
```bash
# List all games you own
./gog-achievements.exe
# List achievements for Hollow Knight: Silksong (game ID 1558393671)
./gog-achievements.exe 1558393671
# Unlock achievement Fanatic (ID 58889697238411342)
./gog-achievements.exe 1558393671 58889697238411342
# Unlock multiple achievements at once
./gog-achievements.exe 1558393671 58889697238411342 12345678901234567
# List achievements with verbose output
./gog-achievements.exe 1558393671 -v
```
## How it works
1. Reads the GOG Galaxy refresh token from Windows Registry
2. Authenticates with GOG servers
3. Retrieves product data from GOGDB.org
4. Lists or unlocks achievements via GOG's gameplay API
## Notes
- API call results are cached in `auths.json` (for Auth) and `products.json` (for GOGDB) in the same directory as the executable
- GOG Galaxy refresh token is used for authentication, please verify that you are logged in.