Skip to content
Jacob edited this page Jul 6, 2025 · 9 revisions

For AlbumPaper to know what song you're playing it needs to connect to the appropriate API using your API keys. This page will guide you through the process of obtaining these keys for Spotify and Last.fm. Spotify is recommended as the album art quality is often better but Last.fm is a little easier to setup.

Spotify

1. Head over to the Spotify developer dashboard and press "Create app". Call it whatever you like and add a description.

2. In "Redirect URIs" enter http://127.0.0.1:8080/ exactly and press "Add".

3. Select "Web API" for "Which API/SDKs are you planning to use?"

4. Agree to the Spotify Developer Terms of Service and press "Save"

5. Copy the the Client ID and paste it into AlbumPaper. Press "View client secret" and copy the Client secret into AlbumPaper.

6. Press "Save" in AlbumPaper. This should open a browser window which may ask you to sign in. Press "Agree" to allow AlbumPaper to see your currently playing track. AlbumPaper should now be setup. Play some music.

[Notice] If this step fails try quitting AlbumPaper and starting it again.

Last.fm

1. Create a new API account here enter an email and an application name a callback URI is not required.

2. Press Submit and add the API Key to the AlbumPaper settings you DO NOT need the shared secret key.

3. Add your last.fm username to the AlbumPaper settings and press Save.

Clone this wiki locally