Guide · Connect GOG
Connect GOG
GOG doesn't offer a clean third-party OAuth, but the GOG Galaxy desktop client does — we ride on its public flow. You log in at gog.com once, copy a URL from the page you land on, paste it back, done.
What you get
- Auto-imported playtime + last-played for every GOG-managed game.
- Best-effort achievement counts (many GOG games have none — that's GOG, not us).
- Manual games auto-matched to your GOG library, so you can promote them.
- Refresh tokens are long-lived (months) — you usually only connect once.
1. Open the GOG connect flow
Settings → Connected Accounts → Connect GOG. The card expands with a three-step guide and a paste field.
Screenshot
Connected Accounts panel showing the GOG row expanded with login button + paste field
(Drop a 1600×900 PNG here later — file: guide-gog-settings.png)
2. Open GOG login
Click Open the GOG login page. A new tab opens at GOG's auth screen. Sign in there as usual (email + password, plus 2FA if you have it). If you were already logged in, GOG may skip this step entirely.
Screenshot
GOG login page in a new tab
(Drop a 1600×900 PNG here later — file: guide-gog-login.png)
3. Copy the redirect URL
After login, GOG redirects you to a page that looks blank or 404 — that page is fine, it's exactly what we want. The URL in your address bar contains the auth code we need. It looks like:
https://embed.gog.com/on_login_success?origin=client&code=eFmW…
Select the entire address bar and copy it. (Or just the part after code= — we accept both.)
Screenshot
Browser address bar showing the on_login_success URL with a code parameter
(Drop a 1600×900 PNG here later — file: guide-gog-redirect.png)
4. Paste & verify
Back in Settings, paste the URL into the box and click Verify & connect. We exchange the code for a refresh token, AES-encrypt it before storing, and immediately kick off a background sync of your library.
Screenshot
Verify & connect button after pasting the URL
(Drop a 1600×900 PNG here later — file: guide-gog-verify.png)
5. Pick games to import
After connect we send you to the GOG picker. Same UX as the Steam importer — check what you want to track, set a status, hit Import.
Screenshot
GOG importer with the library sorted by last-played
(Drop a 1600×900 PNG here later — file: guide-gog-importer.png)
6. Daily sync & disconnect
Same daily cron as Steam (03:00 UTC) refreshes playtime + last-played for every GOG-managed game. Disconnect anytime via Settings — imported games stay; syncing stops.
Common pitfalls
- "GOG rejected that code" → auth codes are single-use and expire fast. Re-open the login URL and grab a fresh redirect.
- Game shows zero achievements → most GOG games genuinely don't have achievements; the ones that do are tracked per-game.
- Cover art looks low-res → GOG ships smaller cover thumbnails than Steam. You can override the cover from the game detail page if it bothers you.