Shufflify is a lightweight app that reorders your Spotify playlists into a truly random order. Unlike Spotify's built in shuffle - which can favour songs you play more often - this app ensures a completely randomised listening experience.
- Completely reorders your playlists to eliminate playback bias.
- Runs as a Docker container for simple deployment on your local network.
- Uses Spotify's Developer API to authenticate and modify playlists safely.
Spotify's native shuffle algorithm will often replay frequently listened-to tracks. Shufflify works by:
- Securely connecting to your Spotify account
- Retrieving all playlists associated with your account
- Shuffling the tracks in the playlist you choose with a simple randomisation algorithm.
- Replacing the existing playlist with an updated one in a new order.
- NOTE - For large playlists (over 50) you will see the tab refresh a number of times - this is due to the API limiting the number of songs, meaning the playlist is "rebuilt" in blocks of 50 songs - wait for this action to finish before closing the tab.
Before setting up ensure you have:
- Docker installed on your machine (currently only AMD64 architecture)
- (Optional) Docker Compose
- (Required for quick setup) Network setup - Host machine IP address set to
192.168.1.150and port 3030 not in use - (Required for self hosted setup) A Spotify Developer account
This option uses a pre-built contianer which connects to the devlopers Spotofy Developer credentials. There is no additional setup required beyond the Network setup above.
- Pull the pre-built image
docker pull asdwerte1/shufflify:quick- Run the container
docker run -d -p 3030:3080 --name shufflify asdwerte1/shufflify:quick- Verify functionality Open your browser and navigate to
http://192.168.1.150:3030to confirm the app loads and runs correctly
- Create a file called
docker-compose.ymland paste in
services:
shufflify:
image: asdwerte1/shufflify:quick
container_name: shufflify
ports:
- "3030:8080"
restart: unless-stopped- Deploy with Docker Compose
docker-compose up -d- Verify functionality Open your browser and navigate to
http://192.168.1.150:3030to confirm the app loads and runs correctly
This option allows you to build and run the container with your own choice of IP and port, using your own Spotify Developer credentials. Setup a Spotify App and note the Client ID, Client Secret, and set the Redirect URI to match your desired address. You will also need to generate a secret-key string for the web app to function.
- Pull the latest selfhost image
docker pull asdwerte1/shufflify:selfhost- Run the container - replace the placeholders below with the deatils from your Spotify Developers dashboard
docker run -d -p 3030:8080 \
--name shufflify \
-e CLIENT_ID=your_spotify_client_id \
-e CLIENT_SECRET=your_spotify_client_secret \
-e REDIRECT_URI=http://your_ip:port/callback \
-e SECRET_KEY=your_custom_key \
asdwerte1/shufflify:selfhostNote - the redirect URI must exactly match what is on your Spotify Developer Dashboard
- Verify functionality Open your browser and navigate to
http://custom_ip:portto confirm the app loads and runs correctly
- Create a docker-compose.yml file
services:
shufflify:
image: asdwerte1/shufflify:selfhost
container_name: shufflify
ports:
- "3030:8080"
environment:
CLIENT_ID: "your_spotify_client_id"
CLIENT_SECRET: "your_spotofy_client_secret"
REDIRECT_URI: "http://your_ip:port/callback"
SECRET_KEY: "your_custom_key"
restart: unless-stopped- Deploy with Docker Compose
docker-compose up -d- Verify functionality Open your browser and navigate to
http://custom_ip:portto confirm the app loads and runs correctly
Contributions are welcome! Please open issues and submit pull requests for improvements, bug fixes or new features.