This Python script allows you to convert Spotify playlists to Plexamp playlists. It fetches tracks from a Spotify playlist and creates a matching playlist in Plexamp with the tracks that exist in your Plex library.
- Python 3.6 or higher
- A Spotify Developer account
- A Plex Media Server with a music library
- Plexamp installed and configured
- Clone this repository:
git clone https://github.com/yourusername/convertlist.git
cd convertlist- Install the required dependencies:
pip install -r requirements.txt- Set up your environment variables:
- Copy
.env.exampleto.env:
cp .env.example .env
- Edit
.envwith your credentials (see Configuration section below)
- Copy
- Go to the Spotify Developer Dashboard
- Create a new application
- Note down your Client ID and Client Secret
- Add
http://localhost:8888/callbackto your Redirect URIs- This must match exactly what you set in your
.envfile - If you change it in one place, change it in both
- This must match exactly what you set in your
-
Get your Plex token:
- Go to https://app.plex.tv/desktop
- Sign in to your account
- Press F12 to open Developer Tools
- Go to the "Application" tab
- Look for "Local Storage" on the left
- Click on "plex.tv"
- Find the "myPlexAccessToken" key
- Copy its value - this is your Plex token
-
Note your Plex Media Server URL:
- This should be the URL of your Plex Media Server (not Plexamp)
- For local servers:
http://your-plex-server:32400 - For remote servers: Use the full URL provided by Plex
- You can find this in your Plex Media Server settings under "Network"
Create a .env file with the following variables:
# Spotify API credentials
SPOTIPY_CLIENT_ID=your_spotify_client_id
SPOTIPY_CLIENT_SECRET=your_spotify_client_secret
SPOTIPY_REDIRECT_URI=http://localhost:8888/callback
# Plex credentials
PLEX_URL=http://your-plex-server:32400 # Your Plex Media Server URL
PLEX_TOKEN=your_plex_token
You can use the script in two ways:
If you've set up your .env file, you can run the script with just the required arguments:
python convertlist.py "https://open.spotify.com/playlist/your-playlist-id" "My Plexamp Playlist"You can also provide all credentials via command line:
python convertlist.py \
--spotify-client-id your_client_id \
--spotify-client-secret your_client_secret \
--spotify-redirect-uri http://localhost:8888/callback \
--plex-url http://your-plex-server:32400 \
--plex-token your_plex_token \
"https://open.spotify.com/playlist/your-playlist-id" \
"My Plexamp Playlist"- The script authenticates with both Spotify and Plex Media Server
- It fetches all tracks from the specified Spotify playlist
- For each track, it searches your Plex Media Server library for a matching track
- It creates a new playlist in your Plex Media Server, which will be available in Plexamp
- The script will only include tracks that exist in your Plex Media Server library
- Track matching is based on track title, which might not be perfect
- The script requires both Spotify and Plex Media Server authentication to work
- Make sure your Plex Media Server is accessible and has a music library set up
- The created playlist will be available in Plexamp as it syncs with your Plex Media Server
- If you get authentication errors, verify your credentials in the
.envfile - If tracks aren't being found, check that your Plex Media Server music library is properly indexed
- If the playlist isn't created, verify that your Plex token has the necessary permissions
- If you can't connect to your Plex Media Server, verify the URL is correct and the server is accessible
- If you get a "No redirect_uri" error, make sure SPOTIPY_REDIRECT_URI is set in your environment variables and matches exactly what's in your Spotify Developer Dashboard
- If you get an "unauthorized" error, your Plex token might be invalid or expired. Get a new token following the instructions above.
This project is licensed under the MIT License - see the LICENSE file for details.