Integration for synchronizing data between music streaming services
- Python 100%
TuneCruncher
A CLI tool for transferring playlists and likes between streaming services
Spotify Badge TIDAL Badge AGPL Badge
This is an API integration scripting project that reads playlists and likes from one popular music streaming service and uploads it to another. This can be useful if you want to switch services without paying for a premium data transfer tool.
Installation
This project uses uv for project management.
Git Dependency
uv supports installing packages from git sources:
uv add git+https://codeberg.org/c-forge/tunecruncher
Manual
git clone https://codeberg.org/c-forge/tunecruncher.git
cd tunecruncher
uv sync
Setup
- Copy
.env.exampleto.env - Add Spotify client ID and secret from Spotify Developer Dashboard
- Add Tidal credentials to
.env - Configure
config.yml- seeconfig.yml.examplefor reference
Usage
uv run tunecruncher
Sync Options
| Flag | Description |
|---|---|
--sync-favorites |
Sync liked tracks |
--sync-artists |
Sync liked artists |
--sync-albums |
Sync liked albums |
--source spotify|tidal |
Source service |
--target spotify|tidal |
Target service |
Development
See docs/DEVELOPMENT.md for setup instructions.