Addams

C# project to export in csv spotify user's playlist
Source code analysed with DeepSource and Codacy

Version: v1.1.0

Summary

• Requirements
• Get started
  • Create spotify application
  • Launch Addams
• For developer
  • Setup project
  • How it works
  • Unit tests
  • Msi build
• Contact
• Credits

Requirements

• .NET Framework / .NET 10.0 >= .NET 10
• VS 2026

Get Started

Setup spotify application

1. You need to create an application on spotify in this link

2. Click on create an app

   1. Set app name: Addams
   2. Set app description: C# tool to export spotify playlist

3. Click into your app created then get value of Client ID and Client Secret

You will get something like this

4. Setup this redirect url http://127.0.0.1:8888/callback like this

IMPORTANT: You can delete your app in this link

Launch Addams application

5. You can download the Addams Application by this link

6. Install it and launch Addams.exe

7. First you need to setup configuration (user account, client id and secret of spotify application)

8. Then you can authentify your spotify application into Addams like below

After the first authentication, the token renewal itself like this, if not click on Authenticate in Settings tab

8. Then you have multiple actions like export and/or show playlists, change configuration of application
   
   

For developpers

Setup project

1. You need to create a spotify app developer

if you want to test with postman you need to add this redirect uri https://oauth.pstmn.io/v1/callback

If you want to setup other redirect uri please check

2. Clone repository

git clone git@github.com:NY-Daystar/Addams.git

3. Open VS 2022 -> Open project or solution
4. Select Addams.sln
5. Rebuild solution
6. F5 to launch project in Debug mode

You can activate git hooks with this command

git config --global core.hooksPath .githooks

How it works

The project setup an OAUTH2 token with your spotify app credentials to execute spotify api request

• Official guide in spotify
• Authentication guide
• Use authorization code with PKCE
• To understand redirect uri changes

Once all data fetched we create a csv for each playlist with track's data:

• Track Name : Name of the track
• Artist Name(s) : List of artist (separated by |)
• Album Name : Name of the album
• Album Artist Name(s) : Album's artists (separated by |)
• Album Release Date : Release date of the album (YYYY-MM-DD)
• Disc Number : If album has multiple disc
• Track Duration : Time duration of the track (minutes:seconds)
• Track Number : Number of the track in the album
• Explicit : If track is explicit or not (True or False)
• Added At : Datetime when you add this track in your playlist
• Track Uri : Spotify url of the track
• Artist Url : Spotify url of the artist
• Album Uri : Spotify url of the album
• Album Image Url : Url image of the album

Tests

You can run unit tests in Addams.Tests project

Build Msi

To get a proper setup : https://learn.microsoft.com/en-us/visualstudio/deployment/installer-projects-net-core?view=visualstudio&viewFallbackFrom=vs-2019

Contact

• To make a pull request: https://github.com/NY-Daystar/addams/pulls
• To summon an issue: https://github.com/NY-Daystar/addams/issues
• For any specific demand by mail: luc4snoga@gmail.com

Credits

Made by Lucas Noga.
Licensed under Apache.