Retune is a dense, album-first desktop music library inspired by the three-column browser in early iTunes.
| Light | Dark |
|---|---|
 |
 |
Retune brings local audio files and a Spotify library into one browser while keeping ratings, normalized genres, play counts, and other personal metadata local.
Retune is for people who want to maintain a music library, not just stream one.
- Browse by genre, artist, and album in a compact, resizable interface.
- Mix local files and Spotify content without treating either as secondary.
- Edit personal metadata without rewriting Spotify's catalog.
- Rate albums and tracks, track plays, search, and manage owned playlists.
- Back up, restore, or merge the library as JSON or gzip.
| Platform | Package | Supported architecture |
|---|---|---|
| macOS | Homebrew | Apple Silicon |
| Windows 10/11 | Winget | x64, ARM64 |
| Ubuntu 22.04 and compatible Debian/Ubuntu | APT | amd64, arm64 |
macOS:
brew install --cask open-cli-collective/tap/retuneWindows:
winget install --exact --id OpenCLICollective.RetuneDebian/Ubuntu, after adding the signed Open CLI Collective APT repository:
sudo apt install retuneSee the installation and Spotify setup guide for APT repository setup, upgrades, uninstall commands, direct downloads, platform trust warnings, and the exact Spotify callback.
On first launch, import local audio files, connect Spotify, or use both. Local files remain available without a Spotify account.
See Development for platform prerequisites, then run:
cd apps/desktop
npm ci
npm exec tauri devRetune stores ratings, genres, play counts, and other overlay edits locally. Those edits are never written to Spotify. Explicit content actions such as saving albums, following artists, and editing owned playlists do update Spotify.
Built-in Spotify playback does not require the Spotify desktop app. The desktop app is needed only when using the optional Spotify Connect backend.
Spotify does not expose playlist contents to Retune unless the current user owns the playlist. Retune can retain cached metadata and track counts for other playlists, but cannot load or edit their tracks.