Self-hosted Spotify care
Clean, sort, and polish your Spotify playlists.
Playlist Polisher is a modern, self-hosted playlist manager that helps you tidy playlists, remove duplicates, and keep your library organized. Preview every change, run it in your own Docker stack, and keep full control of your data.
What it does
- Grid, list, and table views for every playlist you own or follow.
- In-place sorting by artist, album, title, or date added with fast or preserve modes.
- Duplicate detection with review, removal, and ignore options.
- Schedule operations, track history, and undo recent actions.
- Cache track metadata and enjoy in-app playback (premium).
Features that keep playlists in shape
Built for self-hosters who want control, speed, and safe automation. Everything happens inside your own Docker environment, with OAuth authentication and no surprises.
Playlist library views
Switch between grid, list, and table layouts. Filter by ownership and sort by name, track count, or recency.
Playlist detail tools
Edit names and descriptions, clone playlists, delete them, and search tracks in place.
Sorting and duplicates
In-place sorting and duplicate detection are core features you cannot do in the Spotify app.
In-app playback
Premium Spotify users can play tracks in-app with queue, now playing, and rich metadata panels.
Cache and metadata
Track metadata cache with stats, refresh controls, and automatic warming for faster browsing.
Scheduling and history
Schedule sorts and cache refreshes, then review history and undo operations when needed.
How it works
Playlist Polisher runs entirely in your environment. Connect your Spotify app credentials, then manage playlists from your browser.
Set up Spotify credentials
Create a Spotify Developer app and add the redirect URL for your local host.
Launch the containers
Copy the Compose file, configure your .env, and start the stack with Docker Compose.
Authenticate and explore
Sign in with Spotify to browse playlists, track details, and sorting tools.
Preview and apply changes
Review every change before you commit, then polish playlists with confidence.
Self-hosting quick start
Use the quick start from the README to get running locally in minutes.
mkdir playlist-polisher && cd playlist-polisher
curl -O https://raw.githubusercontent.com/consecrated-hammer/playlistpolisher/main/docker-compose.yml
curl -O https://raw.githubusercontent.com/consecrated-hammer/playlistpolisher/main/.env.example
mv .env.example .env
# Edit .env with your Spotify credentials
docker compose up -dDocs and guides
Everything you need to deploy, configure, and contribute lives in the GitHub repository.
Roadmap highlights
See what is shipped, what is in progress, and what is coming next.
Core operations
Scheduled dedupe, merges, splits, imports, and snapshot-based undo are on deck.
Advanced sorting
Popularity, release date, and audio feature sorting to fine-tune playlist order.
Export and sharing
CSV/JSON exports, snapshot sharing, and backups for long-term playlist safety.