GOG Galaxy Integrations Python API

This Python library allows developers to easily build community integrations for various gaming platforms with GOG Galaxy 2.0.

Features

Each integration in GOG Galaxy 2.0 comes as a separate Python script and is launched as a separate process that needs to communicate with the main instance of GOG Galaxy 2.0.

The provided features are:

  • multistep authorization using a browser built into GOG Galaxy 2.0

  • support for GOG Galaxy 2.0 features:

    • importing owned and detecting installed games

    • installing and launching games

    • importing achievements and game time

    • importing friends lists and statuses

    • importing friends recommendations list

    • receiving and sending chat messages

  • cache storage

Platform Id’s

Each integration can implement only one platform. Each integration must declare which platform it’s integrating.

PLATFORM ID LIST

Basic usage

Each integration should inherit from the Plugin class. Supported methods like get_owned_games() should be overwritten - they are called from the GOG Galaxy client at the appropriate times. Each of those methods can raise exceptions inherited from the ApplicationError. Communication between an integration and the client is also possible with the use of notifications, for example: update_local_game_status().

import sys
from galaxy.api.plugin import Plugin, create_and_run_plugin
from galaxy.api.consts import Platform

class PluginExample(Plugin):
    def __init__(self, reader, writer, token):
        super().__init__(
            Platform.Generic, # Choose platform from available list
            "0.1", # Version
            reader,
            writer,
            token
        )

    # implement methods
    async def authenticate(self, stored_credentials=None):
        pass

def main():
    create_and_run_plugin(PluginExample, sys.argv)

# run plugin event loop
if __name__ == "__main__":
    main()

Deployment

The client has a built-in Python 3.7 interpreter, so integrations are delivered as Python modules. In order to be found by GOG Galaxy 2.0 an integration folder should be placed in lookup directory. Beside all the Python files, the integration folder must contain manifest.json and all third-party dependencies. See an exemplary structure.

Lookup directory

  • Windows:

    %localappdata%\GOG.com\Galaxy\plugins\installed

  • macOS:

    ~/Library/Application Support/GOG.com/Galaxy/plugins/installed

Manifest

Obligatory JSON file to be placed in an integration folder.

{
    "name": "Example plugin",
    "platform": "generic",
    "guid": "UNIQUE-GUID",
    "version": "0.1",
    "description": "Example plugin",
    "author": "Name",
    "email": "author@email.com",
    "url": "https://github.com/user/galaxy-plugin-example",
    "script": "plugin.py"
}

property

description

guid

description

url

script

path of the entry point module, relative to the integration folder

Dependencies

All third-party packages (packages not included in the Python 3.7 standard library) should be deployed along with plugin files. Use the following command structure:

pip install DEP --target DIR --implementation cp --python-version 37

For example, a plugin that uses requests could have the following structure:

installed
└── my_integration
    ├── galaxy
    │   └── api
    ├── requests
    │   └── ...
    ├── plugin.py
    └── manifest.json