LSDfy is a small Node.js program that automatically creates/updates Deezer playlists from the latest setlists of your favourite live bands!
The idea behind this program is to keep your Deezer playlists varied, changing, always in line with the latest performances of your favourite live artists (which often contain their biggest hits as well as new material ✌️).
The only prerequisite to use this program is to have Node.js on your machine. If you don't have it yet, you can download and install it through the official website. LSDfy has been tested and works with Node.js 18.12.1 LTS version.
Open a terminal and clone the repository wherever you want:
git clone https://github.com/ehenon/LSDfy.gitNavigate to the created directory and install the dependencies:
cd LSDfy
npm installCreate an app for LSDfy in your Deezer for Developers dashboard and retrieve its "Application ID" and "Secret Key".
Open your favorite browser and navigate to the following URL: https://connect.deezer.com/oauth/auth.php?app_id={YOUR_APP_ID}&redirect_uri=http://localhost:8888/callback&perms=manage_library,delete_library,offline_access
Follow the process provided by Deezer. You should now be automatically redirected to http://localhost:8888/callback?code={SOMETHING} with an authorization code as parameter. Keep this authorization code in mind.
Finally, call the following URL (using the tool you want, like Postman or cURL) to generate your access token: https://connect.deezer.com/oauth/access_token.php?app_id={YOUR_APP_ID}&secret={YOUR_APP_SECRET_KEY}&code={YOUR_AUTHORIZATION_CODE}&output=json
Create a .env file based on .env.sample, and fill it with your own values:
cp .env.sample .envSome details about the environment variables:
| # | Variable name | Required | Description |
|---|---|---|---|
| 1 | SETLISTFM_API_KEY | * | Setlist.fm API Key you can generate here (link for logged in users only) |
| 2 | DEEZER_USER_ID | * | Your Deezer User ID (can be found in the URL of your profile) |
| 3 | DEEZER_ACCESS_TOKEN | * | Deezer Access Token you retrieved just before |
Create an artists.json file with your favourite live artists based on artists.sample.json:
cp artists.sample.json artists.jsonThis JSON simply consists of an array containing one object per artist:
[
{
"name": "Metallica", // Name of the artist
"mbid": "65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab" // MusicBrainz id
},
{
"name": "Municipal Waste", // Name of the artist
"mbid": "b5a31e9b-1fa2-45f9-91f5-b3a25fb38038" // MusicBrainz id
},
...
]NB: mbid fields correspond to the unique identifiers of the artists in the MusicBrainz database. You can for example find them in the URL of the artist pages.
To launch the application locally, open a terminal from the root of the directory and run the following command:
npm run devYou can follow the progress of the program thanks to the logs appearing in the console.
If you want to build the program and run the compiled code separately, please note that the following commands are also available:
npm run build
npm run startThese commands allow you to compile the program in a dist folder using the Babel transcompiler, and then run the compiled program.
- If no
artists.jsonfile is found, the program stops immediately. - If an environment variable is missing, the program stops immediately.
- If a new setlist is found but contains less than 10 songs, the program does not create a new playlist.
- If the last available setlist for an artist has already been transformed into a playlist, it is not re-created.
- If a new setlist is available for an artist, the generated playlist will automatically overwrite your old one.
As explained above, this project allows you to automatically generate Deezer playlists from the latest setlists of your favourite artists. That being said, this is a Node.js script only, and not a real web or mobile application. So it's intended for a more development-oriented audience (to adapt it, or to run it automatically every week, with a time-based job scheduler for example).
The interest of this project lies essentially in the automation of playlist creation. The user has nothing to do, all his favourite live artists are browsed and processed by the program without any action on his side.
If you want to create Deezer playlists from setlists manually, web and mobile applications already exist and are much more suitable for a non-developer audience:
This project is a free and open personal project. Pull requests are welcome (targeting the develop branch). For major changes and problems encountered, feel free to open an issue to discuss what you would like to change/fix. Concerning the commits standards, please follow the conventional commits with these possible types: feat:, fix:, build:, chore:, ci:, docs:, style:, refactor:, perf:, test:.
- setlistfm-js - Used to communicate with the Setlist.fm API
- axios - Used to communicate with the Deezer API
- dotenv - Used to load environment variables from
.envfile intoprocess.env - babel - Used to compile next-gen JavaScript
- eslint - Used to find and fix problems in JavaScript code
- winston - Used to manage console logs
- husky - Used to prevent bad commits 🐶