Trackhop

Keeps playlists in sync across Spotify, Apple Music, YouTube Music, TIDAL, Plex, Jellyfin and more.

  • ghcr.io/hsinghhira/trackhop:latest
  • v1.8.1
  • Updated 10 Nov 2026
  • port 6715
  • amd64 · arm64
  • Media
  • 259 stars

Screenshots

Trackhop screenshot 1: SyncsTrackhop screenshot 2: A syncTrackhop screenshot 3: StatsTrackhop screenshot 4: Services

Open the app

Web App

http://localhost:6715/

About Trackhop

Trackhop keeps playlists identical across Spotify, Apple Music, YouTube Music, Amazon Music, TIDAL, Deezer, SoundCloud, Navidrome, Jellyfin, Emby and Plex. Scheduled syncs run on your server, and tracks it can't find are easy to review. No Trackhop account: your sign-ins stay on your server.

Features

  • Two-way and one-way playlist syncs between music services and your own servers
  • Scheduled syncs, with a report of what was matched
  • Review and replace tracks that weren't found or can't be played
  • Playlist files (CSV, M3U, iTunes XML) and Last.fm, ListenBrainz sources
  • Optional separate accounts for each person

How to use

  1. Set SONGPORT_URL to your ZimaOS IP (or your https address) before you install.
  2. Open Trackhop. Your browser asks for a user name and password: type any name and the password from the CREDENTIALS box in the app's logs.
  3. Connect your music services, then create a sync.

Before you install

You must set SONGPORT_URL first. It starts as http://[ZIMAOS-IP-ADDRESS]:6715: replace [ZIMAOS-IP-ADDRESS] with your ZimaOS IP, like http://192.168.1.20:6715, and always open Trackhop at exactly that address, because music service sign-ins come back to SONGPORT_URL/callback.

Spotify, YouTube Music and Deezer only allow https sign-ins: put Trackhop behind a reverse proxy with your own domain and set SONGPORT_URL to it, like https://music.example.com, then register that callback with each service. Navidrome, Jellyfin and Plex work without https.

This install's password is made on first start and shown in the app's logs, in the box marked CREDENTIALS; when the browser asks, type any user name and that password. To choose your own password, add SONGPORT_PASSWORD in the app settings. Service keys and more settings are in the Variables tab.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone, for scheduled syncs. It is filled in from your ZimaOS time zone.
SONGPORT_URLhttp://[ZIMAOS-IP-ADDRESS]:6715Required. The address you open Trackhop at: replace [ZIMAOS-IP-ADDRESS] with your ZimaOS IP, like http://192.168.1.20:6715. Music service sign-ins come back to this address followed by /callback. Spotify, YouTube Music and Deezer only accept an https address, like https://music.example.com through your reverse proxy.

Sign-in

VariableDefault valueDescription
SONGPORT_PASSWORD—The password for every page. Made on first start and kept in .icestore-password in the data folder when left out.
SONGPORT_USER—Only this user name may sign in. Left out, any name works.
SONGPORT_MULTIUSER—Set to true for separate accounts per person; the admin signs in with the password and invites the others.

Server

VariableDefault valueDescription
SONGPORT_LOCALE—The language of the engine's texts, like it, de or pt-BR.
SONGPORT_MUSIC—A music folder for the Lyrics tool. Add it as a volume too (not read-only).
SONGPORT_UPDATE_CHECK—Set to false to turn off the daily version check.

Service keys

VariableDefault valueDescription
SPOTIFY_CLIENT_ID—Your Spotify app's client ID (developer.spotify.com), instead of entering it in the page.
GOOGLE_CLIENT_ID—A Google "Web application" OAuth client ID, for YouTube Music.
TIDAL_CLIENT_ID—Your TIDAL app's client ID (developer.tidal.com).
DEEZER_APP_ID—Your Deezer app's ID.
DEEZER_REDIRECT_URL—Deezer's redirect address (must be https). Left out, it is SONGPORT_URL followed by /callback.
LASTFM_API_KEY—Your Last.fm API key.
docker-compose.yml
name: trackhop

services:
  trackhop:
    image: ghcr.io/hsinghhira/trackhop:latest
    container_name: trackhop
    restart: unless-stopped
    stop_grace_period: 30s
    network_mode: bridge
    environment:
      - TZ=$TZ
      - SONGPORT_URL=http://[ZIMAOS-IP-ADDRESS]:6715
    ports:
      - target: 8080
        published: "6715"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /data
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:8080/health"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 40s
    deploy:
      resources:
        limits:
          cpus: "1.00"
          memory: 768M
        reservations:
          cpus: "0.00"
          memory: 128M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/trackhop/icon.png
    x-casaos:
      id: com.icestore.trackhop
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone, for scheduled syncs. It is filled in from your
              ZimaOS time zone.
        - container: SONGPORT_URL
          description:
            en_US: >-
              Required. The address you open Trackhop at: replace
              [ZIMAOS-IP-ADDRESS] with your ZimaOS IP, like
              http://192.168.1.20:6715. Music service sign-ins come back to
              this address followed by /callback. Spotify, YouTube Music and
              Deezer only accept an https address, like
              https://music.example.com through your reverse proxy.
      ports:
        - container: "8080"
          description:
            en_US: Trackhop web app, published on host as 6715
      volumes:
        - container: /data
          description:
            en_US: >-
              Your syncs, reports and settings (store.json), music service
              sign-ins (tokens.json), playlist files and this install's
              password (.icestore-password).

x-casaos:
  id: com.icestore.trackhop
  architectures:
    - amd64
    - arm64
  main: trackhop
  author: HSinghHira
  category: Media
  developer: xlollx
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/trackhop/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/trackhop/screenshot-1.jpg
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/trackhop/screenshot-1.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/trackhop/screenshot-2.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/trackhop/screenshot-3.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/trackhop/screenshot-4.jpg
  title:
    en_US: Trackhop
  tagline:
    en_US: Keeps playlists in sync across Spotify, Apple Music, YouTube Music, TIDAL, Plex, Jellyfin and more.
  description:
    en_US: >-
      Visit: [https://icestore.hsinghhira.me/app/trackhop/](https://icestore.hsinghhira.me/app/trackhop/) for full details


      Trackhop keeps playlists identical across Spotify, Apple Music, YouTube
      Music, Amazon Music, TIDAL, Deezer, SoundCloud, Navidrome, Jellyfin,
      Emby and Plex. Scheduled syncs run on your server, and tracks it can't
      find are easy to review. No Trackhop account: your sign-ins stay on
      your server.


      **Features**


      - Two-way and one-way playlist syncs between music services and your
        own servers

      - Scheduled syncs, with a report of what was matched

      - Review and replace tracks that weren't found or can't be played

      - Playlist files (CSV, M3U, iTunes XML) and Last.fm, ListenBrainz
        sources

      - Optional separate accounts for each person


      **How to use?**


      1. Set SONGPORT_URL to your ZimaOS IP (or your https address) before
         you install.


      2. Open Trackhop. Your browser asks for a user name and password: type
         any name and the password from the CREDENTIALS box in the app's logs.


      3. Connect your music services, then create a sync.
  tips:
    before_install:
      en_US: >-
        1. Open the app configuration before you install.


        2. Find SONGPORT_URL. It starts as http://[ZIMAOS-IP-ADDRESS]:6715
           and needs your ZimaOS IP in place of [ZIMAOS-IP-ADDRESS], like
           http://192.168.1.20:6715 for the IP 192.168.1.20 (use yours). You
           must do this, and always open Trackhop at exactly that address.


        3. Spotify, YouTube Music and Deezer only allow https sign-ins. For
           them, use a reverse proxy with your own domain pointed at
           http://[ZIMAOS-IP-ADDRESS]:6715 and set SONGPORT_URL to it, like
           https://music.example.com. Navidrome, Jellyfin and Plex work
           without https.


        4. Start the installation. It is ready in about half a minute.


        5. When Trackhop opens, your browser asks for a user name and a
           password. Type any user name. The password is in the app's logs,
           in the box marked CREDENTIALS. To pick your own password instead,
           add SONGPORT_PASSWORD in the app settings.


        6. Service keys and more settings are listed on the Trackhop page at
           https://icestore.hsinghhira.me/app/trackhop/ (Variables tab).
  index: /
  port_map: "6715"
  scheme: http
  is_uncontrolled: false
  version: "1.8.1"
  update_at: "2026-11-10"
  release_notes:
    en_US: |-
      - First IceStore version: ghcr.io/xlollx/trackhop 1.8.1, plus a start script that makes this install's SONGPORT_PASSWORD on first start and keeps it in the data folder.
      - Port 6715; the data folder is /DATA/AppData/trackhop/data.
      - Fixed: the healthcheck and the CREDENTIALS box now use /health, which needs no password, so the app turns healthy and the box with the password shows in the logs within a minute.
  repo: "https://github.com/xlollx/Trackhop"
  support: "https://github.com/xlollx/Trackhop/issues"
  docs: "https://trackhop.org/guide/docker"

Install Trackhop

Something not working with Trackhop?

Report it so it gets fixed, or ask for an app that is not here yet.

More Media apps

See all