Setting up the workflow is easy, you just need to follow these steps:-

Download and install the workflow

  • Download the workflow

  • Open spotifyminiplayer.alfredworkflow by double-clicking it or dragging it into Alfred.

Create a Spotify Application

Create an app.
  • Step 1: Set App or Hardware Name and App or Hardware Description as following, and select Desktop App :-
Step 1.
  • Step 2: Respond with No :-
Step 2.
  • Step 3: Tick all the boxes and click on Submit :-
Step 3.
  • On the application page, click on Edit Settings :-
Edit Settings.
  • Redirect URI must be set to http://localhost:15298/callback.php, then click Add, and then click Save :-

Warning: Make sure you’ve clicked Save button once you set the Redirect URI

  • The Client ID and Client Secret (needed in next steps) are then available :-
Access Client ID and Client Secret.


  • if you’re using a firewall or a software that blocks communications, note that you’ll have to unblock the following domains to use the workflow:-

    • (for interaction with Spotify)

    • (for downloading new release from web site)

    • (for downloading images when changing theme)

    • (for statistics)

  • if you’re using a proxy, don’t forget to enable this option in Alfred preferences, except for the time of authentication, it must be disabled :-

Use Mac OS http proxy settings for scripts option (except for authentication).
  • Wappalyzer browser extension interfere with authentication process: make sure to disable it during time of authentication.

Create the library

  • Invoke the workflow (with keyword spot_mini, or highly recommended with an hotkey )

  • Follow the steps as below by copy/pasting the Client ID and Client Secret into Alfred window when asked:

Paste Client ID and Client Secret (click to enlarge).
  • Invoke the workflow again and select Authenticate with Spotify, Google Chrome or Firefox (Safari is not working for authentication) will open and you’ll be prompted to login with Spotify and allow access to your application. At the end you should see a message like this:-

    Hello xxx ! You are now successfully logged and you can close this window.

  • Invoke the workflow again and Create the library.

  • You can then start using the workflow:-

See progress by invoking workflow.

It will create your library in the background, but you’ll be able to access use the workflow during that time (except for actions where library has to be modified).

  • The artworks are downloaded in the background, you should get a notification when background download starts:-
Notification for the start of background download of artworks.
  • During that time, you can use the workflow (you’ll see the progress at the top of main menu), and you can see some blank artworks:-
Example of blank artworks until the end of background download is over.