Skip to content

Trackhop Desktop & Server 2.0.0

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 11:34

Released 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 releases and the MCP tool find_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 concerts and the MCP tool find_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 setlists and the MCP tool find_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 records and the MCP tool find_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 trackhop command 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}/key and GET/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/syncs takes an id of 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}/decisions give 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/config with the X-Backup-Password header, trackhop config --encrypted and trackhop 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/lookup and /save, trackhop nolyrics and the MCP tool find_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 trackhop command 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 tool list_missing_on_server and the wanted.added webhook.
  • 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 diagnostics and 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