Self-host tunesynctool
v1.2.2Self-hosted music library sync across streaming services
- Stars
- 158
- Ports
- 8000 (API backend), 80 (Frontend web UI)
- Requires
- MySQL, Redis
What is tunesynctool?
tunesynctool is a Python-based self-hosted web application for managing music libraries across multiple streaming services. It provides a web UI and REST API to search, transfer, and synchronize playlists and tracks between Spotify, Deezer (read-only), YouTube Music, and any Subsonic-compatible service such as Navidrome or Airsonic. The project includes a Docker Compose setup with a React frontend, FastAPI backend, MySQL database, and Redis cache. It uses JWT-based authentication for user accounts and OAuth2 flows for connecting to music providers. The software is licensed under GPL-2.0 and is under active development with a 1.2.2 release as of June 2026.
Should you self-host tunesynctool?
tunesynctool scores 41/100 on selfhost.directory (how scoring works) and ranks #43 of 59 in Music Streaming. It has 158 GitHub stars.
It shipped 1 stable release in the past year. The latest, v1.2.2, came out on 6 June 2026.
Setup is advanced: plan for several services and some ongoing maintenance. It is GPL-2.0-licensed and written mostly in Python.
Its closest alternative on selfhost.directory is koel (75/100, 17 320 stars). It scores higher overall, so compare the two before you pick. See tunesynctool vs koel side by side.
Features
- Deezer ARL cookie authenticationRead-only, experimental
- Multi-user support with admin roles
- OAuth2 provider linking
- Playlist synchronizationMarked as work in progress in README
- Playlist transfer between services
- REST API with OpenAPI schema
- Subsonic credential authentication
- Track matching via ISRC and MusicBrainzBeing rebuilt from scratch according to FAQ
- Track search across providers
tunesynctool README
FAQ
How does matching work?
Track matching is currently being entirely rebuilt from scratch.
Does tunesynctool offer functionality to download or stream music?
No, it does not download or stream music. Use official clients' offline listening features or source music in other ways.
Why aren't there any updates to the CLI or Python package, even though the repository is active?
The maintainer decided to focus on developing a self-hostable application instead of the CLI/Python package.
More in File Transfer & Sync
UnisonSelf-hosted, open-source two-way file synchronizer for Linux, BSD, macOS and Windows replicas, with conflict detection, profiles, backups and a continuous watch mode.
YouTransferA self-hosted file transfer and sharing server you run behind your own firewall, shipped as a Docker image or NodeJS app, pitched against Dropbox and WeTransfer.
any-sync-dockercomposeDeploy your own any-sync network with Docker Compose - self-host Anytype backend
bashuploadSelf-hosted PHP file upload service for sharing files between servers, desktops and mobiles via command line or browser with automatic expiration.
ClipCascadeOpen-source clipboard sync for Windows, macOS, Linux and Android: text, images and files relayed by a self-hosted server or peer-to-peer, end-to-end encrypted.
crocSelf-hosted, open-source croc sends files and folders between any two machines with PAKE end-to-end encryption, resumable transfers, and your own relay via Docker.
DashBeamOpen-source P2P file transfer tool with self-hosted relay and discovery servers; direct device-to-device over QUIC + TLS 1.3, on desktop, Android, CLI and web.
davosSelf-hosted web-based FTP/FTPS/SFTP download automation tool with scheduling, filtering, and notifications.- DelugeDeluge is a lightweight, free, cross-platform BitTorrent client with a daemon/client model, multiple user interfaces (GTK, Web, Console), and a plugin system.
docker-sftpSelf-hosted SFTP server using OpenSSH with Fail2ban for brute-force protection, packaged as a Docker image for easy deployment.
drivebaseDrivebase is a self-hosted, open-source file manager unifying Google Drive, S3, Dropbox, and local files into a desktop-like web UI with real-time transfers.
DropgateSelf-hosted file sharing with hosted uploads, P2P transfers, E2EE, web UI, desktop client, and TypeScript library.
0 comments