Humble Keys Library

Humble Keys Library is a library plug-in extension for Playnite which queries Humble Bundle for third-party keys, and also supports Humble Choice subscription games.

The default Humble Library plug-in only reports DRM-free games, not the keys for third-party services like Steam. Humble Keys Library allows you to search your entire collection for a game, to make sure you don't buy a new copy in the latest sale if you already have one from a previous Humble Bundle.

Installation

You can install it via Playnite's built-in add-on browser or:

1. Download the .pext file from the latest release
2. Drag-and-drop the .pext file onto your Playnite window

Settings

• Ignore Redeemed Keys - When checked, HumbleKeysLibrary will not import keys that have been revealed on the Humble site.
• Add Redemption Store to field - Add the store the key is for (e.g. Steam) to this field (IMPORTANT: Platform field is no longer used by default, but now Source is to help some metadata plugins properly match games).
• Import Choice Games - When checked, purchases that are detected as Humble Choice Bundles will have the bundle's individual games added.
• Create Tags for Bundle Names - When an entry not None is selected, it will create a tag in the format of Bundle: [Bundle Name].
• Unredeemable key handling - Unredeemable virtual orders (either expired and cannot be redeemed or part of a Bundle where all choices have been made) can be tagged as Key: Unredeemable or not added to the library. For existing games, if Tag is selected a new tag will replace the existing Key: Unredeemed tag with Key: Unredeemable, if Delete is selected the game will be deleted from the library if it cannot be redeemed.
• Enable Cache - When checked, HumbleKeysLibrary will create JSON files for data retrieved from the Humble API in the ExtensionsData directory. If a Cache file exists, the API will not be queried to prevent spamming Humble. This applies to Purchases, Memberships (Humble Monthly) and Orders.

Details

Tags

• Key: Redeemed - this tag is attached to entries that have been redeemed. Corresponds to Humble API tpkd_dict.all_tpks[n].redeemed_key_value.
• Key: Unredeemed - this tag is attached to entries that have not been redeemed. Corresponds to Humble API tpkd_dict.all_tpks[n].redeemed_key_value.
• Key: Unredeemable - this tag is attached to entries that cannot be redeemed (either expired or part of a Bundle where all choices have been made).
• Bundle: [Bundle Name] - will be created per Bundle of keys if the option to create grouping tags is enabled (when product.category=='subscriptioncontent' and product.choice_url has a value).

Key Types

Humble API lists key types in tpkd_dict.all_tpks[n].key_type, which corresponds to the services on which the key can be redeemed. Supported keys include:

• gog
• nintendo_direct
• origin (EA app)
• origin_keyless
• steam

Unsupported key types include non-game software, services that are shut down, and other kinds of content:

• generic
• desura
• external_key

Note: Humble Bundle sells keys for other services such as Epic Games, Ubisoft, Battle.net, etc., which are also not currently supported. Please open an issue on GitHub if you would like to see support for these services added.

Attributions

Key icon by Freepik: https://www.flaticon.com/authors/freepik
Original author: Justin Hardage (Fierce Punch Studios)