Some download scripts in Helium use external services that may require authentication keys or an API key.

Discogs and Last.fm are examples of two APIs that will require these additional details to enable downloading.


Configuring Last.fm

  1. Navigate to https://www.last.fm/join?next=/api/account/create
  2. Fill in the required details and click Sign Up.
  3. Once your account has been created, log in and then navigate to the following page: https://www.last.fm/api/authentication
  4. Follow the steps to generate an API key.
  5. In Helium, create a variable from Tools > Options > Variables, named LastfmApiKey with the value of the API key you generated in step 4.

You can now use the Last.fm download scripts in Helium.


Configuring Discogs

  1. Navigate to https://www.discogs.com/developers.

  2. Click Create an App in the topmost toolbar.

  3. Follow the steps to create an application.

  4. Once the application has been created, you will need to create variables from Tools > Options > Variables in Helium with the following names:

    • DiscogsConsumerKey with the value shown on Discogs for "Consumer Key."
    • DiscogsConsumerSecret with the value shown on Discogs for "Consumer Secret."

  5. Generate a Discogs token as described here: https://www.discogs.com/developers/#page

    , under the section Discogs Auth Flow. Note that it is possible to use various tools to generate the token and the token secret, such as Postman. A link to a full Postman project with authentication can be found at the following URL: https://github.com/leopuleo/Discogs-Postman.

  6. Once you have generated the token and the token secret, create two more variables in Helium, DiscogsToken and DiscogsTokenSecret, containing the generated values.


You can now use the Discogs download scripts in Helium.


Onboarding Discogs using Postman

  1. Download and install Postman from https://www.postman.com/

  2. Download the Postman collections from https://github.com/leopuleo/Discogs-Postman
  3. Import the downloaded collection from step 2 into Postman. More in detail information about importing collections/workspaces into Postman can be found on their website,
  4. Setup the required authentication variables from your Discogs account in Postman: 
  5. Execture the GET Request token query
  6. The response will contain your token and your secret:
    oauth_token=BsvlvnyEtsPWUwKyhFlLVFGtlUeyhjHcWoUfggYg&oauth_token_secret=UODsAiPFbAYtEsUZAuWTYdsnxhTCXWpQdSUhLFyN&oauth_callback_confirmed=true