jacobmichels/jam

Converts Spotify playlists from clean -> explicit

jam

Converts Spotify playlists from clean -> explicit

Motivation

Spotify likes to be inconsistent with their playlists, mixing clean and explicit songs within the same playlist. To me, this is annoying. I don't want to listen to censored music. This tool is a solution to this inconsistency.

Usage

Convert a playlist to explicit:

jam "Power Gaming"

This will create a new playlist in your account titled Power Gaming with clean songs swapped with their explicit version.

Convert a playlist to explicit (dry run):

jam --dry-run "Power Gaming"

This will skip the playlist creation step.

Convert a playlist to explicit while supplying an output name:

jam "Power Gaming" --output "Cool Gaming Music 😎"

This will create a new playlist in your account titled Cool Gaming Music 😎 with clean songs swapped with their explicit version.

Installation

You'll need to compile from source. The following compiles jam and places it in ~/.cargo/bin

1. Get a stable rust toolchain with rustup
2. Run cargo install --git https://github.com/jacobmichels/jam
3. jam is now installed 🎉

Authenticating with Spotify

jam uses oauth to authenticate with Spotify. Authenticating is a straightforward process handled at runtime. The access token and refresh token are cached at ~/.jam/credentials.json

jam's Issues

Fix auth

Sometimes the auth breaks, leading to 400 response errors. Not sure why it happens, but it could be something wrong with the token refresh mechanism.

break up run function

The run function is too long and unreadable, break it up into smaller units with functions

Add dryrun option

Use original playlist image

title, hopefully simple to implement

fix spotify.add_tracks_to_playlist

There has to be a more efficient/idiomatic way of converting Vectors

Remove hardcoded client id

It's only the ID, not the secret. Could make use of something like dotenv

Dedup songs

A playlist could have contained the explicit and non-explicit version of the same song (who knows why, but it's possible and I have seen this on official Spotify playlists). Write some code so the same song doesn't appear twice on a generated playlist

Write readme