Repository navigation
Trackhop Desktop & Server 2.0.0
Pre-releaseReleased together with the app's 2.0. Discover from your music (new releases, concerts, setlists, records and
merch, Wrapped from what you really play, followed artists), shared playlists' mailboxes, syncs handed over from
the phone, podcasts, covers on more services and an encrypted full backup; then two-way pairs, favourites and
labels, Lyrion and Mopidy, Missing on my server and more.
- New releases: Tools › New releases lists the new albums, EPs and singles of a playlist's artists from Deezer and MusicBrainz, and what is announced; make them a playlist on any service, or a weekly New releases sync that keeps every track.
GET /api/v1/releases,trackhop releasesand the MCP toolfind_new_releases; a new notification event tells when a weekly New releases sync found new music. - Concerts: Tools › Concerts lists the upcoming dates of a playlist's artists in a country, from Ticketmaster and MusicBrainz, with ticket-site searches for artists without dates; your own Ticketmaster key in Settings or
TICKETMASTER_API_KEY.GET /api/v1/concerts,trackhop concertsand the MCP toolfind_concerts. - Setlists: Tools › Setlists shows what a playlist's artists played live, from setlist.fm, and saves a setlist as a File playlist to send to any service. It needs your own free setlist.fm key, in Settings or
SETLISTFM_API_KEY.GET /api/v1/setlists,trackhop setlistsand the MCP toolfind_setlists. - Records and merch: Tools › Records and merch finds a playlist's artists' CDs, vinyl and cassettes on Discogs, the official sites and shops MusicBrainz links them to, and searches on Bandcamp, Discogs, eBay and the web; plain links. With your own Discogs token (Settings), the copies for sale and the lowest price.
GET /api/v1/records,trackhop recordsand the MCP toolfind_records. - Wrapped, playlist poster and followed artists: Tools › Wrapped makes your Wrapped from what you really played (Last.fm, ListenBrainz, your own server's play counts, Spotify, Deezer, TIDAL, YouTube Music) with its card as a PNG; Tools › Playlist poster lists the songs you play most in the cover's colours, to print; Tools › Followed artists tells your notification channels of your artists' new releases, concerts, merch and records, checked every day. Concerts also reads Spotify's tour dates where Spotify (web) is connected. In the API, the
trackhopcommand and MCP. - Shared playlists' mailboxes: a group sharing a playlist can meet on your server. The app makes the group's mailbox with your API token and gets the group's key, shown once; that key only reads and writes the signed items of its own group, nothing else on the server, and a new key ends the old one.
GET/POST /api/v1/groups,GET/DELETE /api/v1/groups/{group},POST /api/v1/groups/{group}/keyandGET/POST /api/v1/groups/{group}/items. - Hand-over from the app: a phone can hand a sync over to your server and bring it back.
POST /api/v1/syncstakes anidof your own, which makes the call safe to repeat: sent again, it answers the sync made the first time. - Review choices shared with the app:
GET/POST /api/v1/syncs/{sync}/decisionsgive and take in the review's choices (ignored, matched by hand, kept), each with its time; for each track the newest choice wins on both sides. - Podcasts: YouTube Music's followed podcasts as a source; followed podcasts exported as OPML, with their feeds looked up.
- Playlist covers on more services: Spotify (web), YouTube Music, TIDAL, YouTube, Jellyfin, Emby and Plex take the source's cover.
- More of your library: TIDAL liked tracks, Apple Music favorites and recent plays, ListenBrainz's playlists made for you.
- Encrypted full backup: Backup & restore › Your set-up can save the file with the sign-ins (
tokens.json), client secrets and pasted web cookies, locked with a password (AES-256-GCM, PBKDF2 with 600,000 rounds); restoring one asks its password and whether this server replaces the other device.POST /api/v1/config/encrypted,POST /api/v1/configwith theX-Backup-Passwordheader,trackhop config --encryptedandtrackhop config import <file> --replaces-device --replace-sign-ins. A phone's Bridge sessions are not used on a server, and the other way round. - Synced lyrics from your server: Tools › Synced lyrics lists the songs of a connected Navidrome (and other Subsonic servers), Jellyfin, Emby, Plex or Lyrion server without lyrics, looks them up on LRCLIB and shows what it found before anything is written. Jellyfin takes them through its API; for Navidrome, Emby and Plex they are saved as
.lrc(synced) or.txt(plain) next to the audio file, once the server's music folder is mapped to a folder here (mounted read-write on Docker). Nothing is ever replaced. Mopidy has no lyrics.GET /api/v1/tools/nolyrics,POST /api/v1/tools/nolyrics/lookupand/save,trackhop nolyricsand the MCP toolfind_songs_without_lyrics. - Two-way pairs on the web page: make a two-way pair from the page; the pair is turned on or off and deleted as one. A pair can follow removals too: a track removed on one side goes from the other, and removals held back for a check are confirmed from the page. A playlist renamed on either side updates both halves of the pair.
- Favourites, labels and tags: star a sync, name a colour as a label, add key/value tags; filter and search by them on the page, and in the API (filters, run a group by tag or label), the
trackhopcommand and the MCP tools. - No more doubles from two devices: a set-up brought in from another device keeps its scheduled syncs paused, shown as Scheduled on and the device's name; a playlist is read again just before it is written; a track a sync added twice is removed by the next run.
- MusicBrainz matching for your own server: Navidrome, Jellyfin, Emby and Plex answer with the file tagged with the source track's recording; the MusicBrainz tags report in Tools, the API, the CLI and MCP lists the songs without those tags.
- Lyrion Music Server and Mopidy (beta): playlists read, created, filled and mirrored on your own Lyrion or Mopidy server.
- Missing on my server: one list of the tracks your syncs to your own server could not find, by album, ticked when you get them, exported as CSV, M3U, text, JSON or a Lidarr Custom List (with a read-only list key).
GET /api/v1/wanted,trackhop wanted, the MCP toollist_missing_on_serverand thewanted.addedwebhook. - Quicker review: removing a wrong match reads the target playlist only as far as needed, or not at all right after a run.
- Diagnostics: a report with a ready GitHub issue, secrets and names left out, which first looks for the same issue on GitHub; from the API,
trackhop diagnosticsand MCP. - Crowded schedules on the page: when many syncs reach one service at once, a card proposes new times to confirm; the same through the API, CLI and MCP; a two-way pair counts once.
- Safer notification channels: a channel that comes with a set-up file stays off until you turn it on; saved keys stay with a channel only while its server or webhook address is the same; the ntfy topic is kept as a secret; failures and technical reports leave out webhook addresses, tokens and keys.
- Official APIs: Spotify apps in Development Mode find relinked tracks again; YouTube's searches are counted in their own daily allowance; Jellyfin is asked on its current routes first (the older ones as a fallback) and a playlist's order is kept there too; the Deezer texts say new developer apps can no longer be made (an existing one keeps working); Navidrome and other OpenSubsonic servers sign in with an API key; TIDAL lists your own playlists with its current filter.
Docker: docker pull ghcr.io/xlollx/trackhop:2.0.0 (or :latest). Docker guide · Desktop guide
A stable release: GitHub shows it as a pre-release only so that the repository's "latest" release stays the Android app, which app stores and updaters (Obtainium, F-Droid) read from it.
The .msix is the package for the Microsoft Store, unsigned: it does not install by itself; use the .msi or the .zip.
macOS: -macos-arm64.dmg for Apple silicon (M1 and later), -macos-x64.dmg for Intel Macs. Not signed by Apple: the first time, macOS refuses to open it; then System Settings › Privacy & Security › Open Anyway (how).
Flatpak (Linux): flatpak install --user Trackhop-Desktop-v2.0.0-linux.flatpak, then Trackhop in the menu (needs Flathub's GNOME runtime, which Flatpak offers to install).
VirusTotal: every file of this release, checked by the antivirus engines VirusTotal runs.
| File | Result | SHA-256 |
|---|---|---|
| Trackhop-Desktop-v2.0.0-linux.deb | clean | a5ffbdd244b23c0728ebde01346f107e02c36bddbf5c73f16a23a89db8c2328b |
| Trackhop-Desktop-v2.0.0-linux.tar.gz | clean | 7df020b3896d215a360a838582bbacd22dfd632558b0131a24398d300b447be9 |
| Trackhop-Desktop-v2.0.0-macos-arm64.dmg | clean | 3fffd3cc2da50552aaa9873be8702dd187a0ffec082242858e22776c2f226550 |
| Trackhop-Desktop-v2.0.0-macos-x64.dmg | clean | 78f92a5c9f808f8c680a4d26ff81d0798f14e735240f9d1aa6972375388024d0 |
| Trackhop-Desktop-v2.0.0-windows.msi | clean | 6d689cca077cef2e17aba392cc9980b5311d7b7652e00b7e8d4a887ba0f8834d |
| Trackhop-Desktop-v2.0.0-windows.msix | clean | c0a7a7d4efb9073d98bc2f61387275f843b70a4fb4080ab423b8c6c300af1728 |
| Trackhop-Desktop-v2.0.0-windows.zip | clean | bc7b7c5a608d4bce8e1abc9c7fdcbe8d867dbb4e24c9ae046eac07d30bc6074c |