A set of tools to manage your Spotify library from the CLI.
In order to run the CLI you need to first install the latest version of .NET which you can obtain from here. Once you have it you can clone the repo and run:
dotnet run --project SpotifyToolbox.CLI -- --help
This should print out the available commands, but since you haven't added an access token yet it'll print out an error.
The first thing you'll need is a token to access Spotify resources, so head over to the Spotify Developers website and create an account if you don't have any.
Once in the Dashboard create an app and then click on Edit settings and add a new redirect URI under the Redirect URIs section. By default the CLI uses http://localhost:8000/callback, so add that one unless you specifically went to the code to change it.
Once you've done that you can copy the Client ID that the dashboard should show you and re-run the command from before but adding this token to an environment variable:
SPOTIFY_CLIENT_ID={your client ID} dotnet run --project SpotifyToolbox.CLI -- --help
This should now print out the list of commands, which will only be login, and if you run it it should open a browser to help you authenticate your account to the CLI. After login you should see the available commands when running help.
Right now with the toolbox you can do the following things:
By running:
dotnet run --project SpotifyToolbox.CLI -- remove albums
The CLI will prompt you for confirmation and then proceed to remove all the albums on your collection. If instead you run:
dotnet run --project SpotifyToolbox.CLI -- remove albums --dry-run
It should show you instead the list of albums that the app would remove (which should be your entire library).
By running:
dotnet run --project SpotifyToolbox.CLI -- remove artists
The CLI will prompt you for confirmation and then proceed to unfollow all the artists on your collection. If instead you run:
dotnet run --project SpotifyToolbox.CLI -- remove artists --dry-run
It should show you instead the list of artists that the app would unfollow (which should be all of them).
If you're missing any feature or want to add a new command feel free to open an issue or implement it yourself! The project uses C# and the .NET Spotify API wrapper which makes it incredibly easy to interact with the Spotify API and Spectre Console to show all those cool animations and colors on the terminal.