Sync selected playlists from music services into a Subsonic-compatible server (for example Navidrome), with support for downloading missing tracks if used with the Subsonic API proxy server Octo-Fiesta.
On every cycle, Octo-Sync fetches configured source playlists, resolves tracks in the target library, and updates the target playlist.
| Source | Credentials required | Private playlists |
|---|---|---|
| Apple Music | No | No |
| Deezer | No | No |
| ListenBrainz | Yes | Yes |
| Qobuz | No | No |
| Spotify | No | No |
| TIDAL | Yes | Yes |
| YouTube Music | No | No |
| Csv files | No | No |
See the Supported Playlist Sources wiki page for detailed information.
- Docker Compose (recommended)
- A running Navidrome instance
- Playlists you want to mirror :)
# Clone the repository
git clone https://github.com/m8tec/octo-sync.git
cd octo-sync
# Configure
cp .env.example .env
nano .env # Edit with your settings
# Start
docker-compose up -d
# Watch logs
docker-compose logs -fSee the Installation wiki page for detailed instructions.
All runtime configuration is supplied through environment variables in .env.
For the playlist configuration, see the Supported Playlist Sources wiki page.
GPL-3.0
- Octo-Fiesta - The Subsonic API proxy server that led me to create Octo-Sync in the first place and heavily inspired it
- Navidrome - The excellent self-hosted music server