The music on your Jellyfin, Navidrome or other Subsonic server, on the iPhone, the iPad, the Mac and Linux. Artists, albums, songs and playlists; playlists Jukebox makes up for you on Home; and a radio that plays on from any song, artist, album, genre or decade and learns from what you skip.
What plays on one device shows on the other: leave the computer, and the phone goes on where it was.
dev/linux-install.sh
builds Jukebox in Docker and installs it for you (binary, icon, desktop
entry). It needs only libraries (GTK 4, libadwaita, GStreamer, libsecret): at home on GNOME, at
ease on KDE, XFCE and Hyprland. More in docs/LINUX.md.
Or the Flatpak, from Releases:
flatpak install --user Jukebox-1.0-x86_64.flatpak
GitHub's macOS runners build and upload it, so no Mac is needed.
- App Store Connect › Apps ›
+› New App: iOS, name Jukebox, bundle IDcom.tijmen.Jukebox, SKUjukebox. If the bundle ID is not offered, register it under Certificates, Identifiers & Profiles › Identifiers. - This repository's secrets (Settings › Secrets and variables › Actions):
APPLE_TEAM_ID,ASC_KEY_ID,ASC_ISSUER_ID,ASC_KEY_P8, the same as Numa-mac's: an App Store Connect API key with the Admin role. - Actions › CI › Run workflow, with "Upload to TestFlight" ticked, or a
commit whose message has
[testflight]. Only main (and themacbranch) uploads; a work branch only builds.
The Mac's app is the same app with the same bundle ID, so it goes to the
same record, one purchase for all three. A [testflight] run uploads it
after the iPhone's (mac_upload=true in ci/app.sh).
docs/RELEASE.md has the rest, and the quick loop on the photographer's
Mac.
The radio works from your library alone. Put a free Last.fm API key (last.fm/api/account/create) in Settings and it also knows which artists and songs sound alike, and the stations get much better. Only artist names and song titles are sent to Last.fm.
See docs/ARCHITECTURE.md. dev/jellyfin-test-server.sh and
dev/kit-test.sh test JukeboxKit on Linux against a real Jellyfin in
Docker.