Open Source implementation of GOG Galaxy's Communication Service
This project aims to implement calls made by game through SDK.
Note: that means it can't and won't replace Communication Service in official client
This will provide minimal and platform-agnostic SDK. For use in game launchers like Heroic or Lutris
Project is continuation of Yepoleb's work https://gitlab.com/Yepoleb/comet/ but in
Python now in Rust
Note
The following list excludes calls that aren't made by the game
- LIBRARY_INFO_REQUEST
- AUTH_INFO_REQUEST
- GET_USER_STATS_REQUEST
- SUBSCRIBE_TOPIC_REQUEST
- UPDATE_USER_STAT_REQUEST
- DELETE_USER_STATS_REQUEST
- GET_USER_ACHIEVEMENTS_REQUEST
- UNLOCK_USER_ACHIEVEMENT_REQUEST
- CLEAR_USER_ACHIEVEMENT_REQUEST
- DELETE_USER_ACHIEVEMENTS_REQUEST
- GET_LEADERBOARDS_REQUEST
- GET_LEADERBOARDS_BY_KEY_REQUEST
- GET_LEADERBOARD_ENTRIES_GLOBAL_REQUEST
- GET_LEADERBOARD_ENTRIES_AROUND_USER_REQUEST
- GET_LEADERBOARD_ENTRIES_FOR_USERS_REQUEST
- SET_LEADERBOARD_SCORE_REQUEST
- CREATE_LEADERBOARD_REQUEST
- GET_GLOBAL_STATS_REQUEST
- OVERLAY_STATE_CHANGE_NOTIFICATION
Check running
Some client SDK versions require Windows service to be registered, refer to dummy service
You need to obtain access_token
, refresh_token
and user_id
either manually, or by importing them:
Log in to GOG within the launcher.
Via Lutris
Log in to Lutris's GOG source.
Via gogdl (CLI)
If GOG authentication has never been performed in Heroic on the current user, create the expected directory:
mkdir -p $HOME/.config/heroic/gog_store
Then, run the command:
./bin/gogdl --auth-config-path $HOME/.config/heroic/gog_store/auth.json auth --code <code>
Obtain the code by logging in using this URL, then copying the code value from the resulting URL:
comet --token "<access_token>" --refresh_token "<refresh_token>" --user-id <user_id> --username <USERNAME>
Or if you are using Heroic/gogdl
comet --from-heroic --username <USERNAME>
Or Lutris
comet --from-lutris --username <USERNAME>
Or use the shortcut script provided for non-Steam shortcuts. See the Steam Deck Usage Guide.
Join Heroic Discord and reach out to us on special thread
Here you can find a blog post about setting up environment for tracing the Communication Service calls (involving Proxifier and custom mitmproxy)
Reverse engineered protobuf definitions are available here: https://github.com/Yepoleb/gog_protocols
In order to dump logging from SDK client (the game) download GalaxyPeer.ini, when placed next to game .exe it will write GalaxyPeer.log when the game is running.
Warning
Proceed with caution, the log may contain sensitive information, make sure to remove such data before sharing the file with others.
If you want to contribute financially you can do so via my Ko-Fi.
You can also use any of the options to support Heroic