Skip to content

UncleGoogle/galaxy-integration-humblebundle

Repository files navigation

galaxy-integration-humblebundle

Integration for GOG Galaxy 2.0.

Features

  • Library:
    • DRM free direct downloads from HumbleBundle
    • Third party game keys
  • Install: simple download via webbrowser
  • Installed games detection:
    • scanning Windows registry (only for games that can be uninstalled via Control Panel\Programs\Programs and Features)
    • scanning file directory trees choosen by a user (experimental; 1 level deep tree search for directories names similar to game names from library)
  • Launch: running games tracking (requires launching via Galaxy)

Installation

Stable release:

autoupdates to next Stable relase (served as FriendsOfGalaxy fork)

GOG Galaxy 2.0 go to Settings->Integrations-> use build-in Search GitHub engine

Latest release:

autoupdates to next Latest release (since 0.7.0)

Download asset humblebundle_v{}.zip from releases and upack to:

  • Windows: %localappdata%\GOG.com\Galaxy\plugins\installed
  • MacOS: ~/Library/Application Support/GOG.com/Galaxy/plugins/installed

From source:

Requires python3.6 or higher

  1. git clone https://github.com/UncleGoogle/galaxy-integration-humblebundle.git
  2. cd galaxy-integration-humblebundle
  3. pip install -r requirements-dev.txt
  4. inv dist # this will forcelly restart Galaxy

Configuration

Config window

Humble_Install

To open: double click "Install" button from any HumbleBundle game view.

Contains:

  • Library settings for game types to show
  • Local games settings for installed games detection

Galaxy settings

Humble_Settings

To open: go to Galaxy menu -> Settings -> Features -> "HUMBLE BUNDLE".

Contains:

  • Ability to manualy overwrite detected Choice subscription months and Trove
  • Importing predefined tags: Key, Unrevealed for games that are third party keys
    • Warning: this will not automatically add tags for newly added games. You will have to import tags again.
    • Note: since v0.8 tag Trove is not longer used; re-import to clear out

Recommended Humble Choice view

  1. Go to Humble Bundle bookmark

  2. Filter to subscriptions

Humble_filters

  1. Group by subscriptions

Humble_Groupby

  1. Bookmark

Humble_Bookmarked

  1. Rename a new bookmark with right-click

FAQ

Can I group my Humble games and Choice games altogether?

You have to create a new filtered Humble Bundle bookmark, proceeding as follows:

  1. Click on the default Humble Bundle bookmark: you see only the owned games in this view, and your goal is to have a similar view that lists both owned and subscription games.

  2. Change the view filter selecting the funnel icon, then the Status menu -> and then flagging both Owned and Subcriptions.

HumbleBundle_Filters

  1. Bookmark the search query you've just composed clicking on the small bookmark flag.

Bookmarking

  1. The view that you've just created will appear in the bookmark list as an Humble Bundle duplicate, so you want to rename it. To do so, click with right mouse button on the new bookmark itself and select Rename bookmark changing name with something you like as for example Humble Owned + Choices.

Bookmark_rename

  1. Now when you select the new bookmark you can view (and search!) both owned and subscription Humble Bundle games.

Bookmark_renamed

Bug Reporting

This integrations uses sentry.io to report anonymous error reports. Personal and sensitive data are not gathered.

Create new issue here.

Acknowledgements

  • GOG.com for Galaxy and its open source API
  • MayeulC for his fork of Command-line downloader as a starting point for this integration