Bring your music collection back into a focused listening app. AltSound connects to your Jellyfin server and turns it into a streaming experience for songs you own — no subscriptions, no ads, no algorithms tracking what you play.
AltSound is an unofficial, third-party client. It is not affiliated with or endorsed by the Jellyfin project.
-
macOS — download the unsigned
.appfrom the latest GitHub Release, then drag it into/Applications. Because the build is unsigned and unnotarized, macOS Gatekeeper will block the first launch with a "Apple cannot check it for malicious software" warning. To open it:- macOS 14 Sonoma and earlier: right-click the app → Open → confirm in the dialog.
- macOS 15 Sequoia and newer: double-click the app once (it will be blocked), then go to System Settings → Privacy & Security, scroll to the bottom, and click Open Anyway. Alternatively, run
xattr -dr com.apple.quarantine /Applications/AltSound.appin Terminal.
You only need to do this once. No re-signing or expiry.
-
iOS — iOS support is already working, and I want to ship AltSound on the Apple App Store in the future. Right now, I do not have an active Apple Developer account. The yearly developer fee is currently too expensive for me, so App Store distribution is paused for now.
- A Jellyfin server with a music library.
- The server's URL and your Jellyfin credentials.
That's it. Your credentials stay in the device's secure storage, and the app only talks to your own server.
- Stream your full Jellyfin music library
- Browse albums, artists, playlists, and liked songs
- Home screen with recently added, most played, and personalized "for you" picks
- Full-text search across songs, albums, and artists
- Full-screen now playing with queue management and synced lyrics
- Instant Mix — turn any song into an endless radio
- Offline downloads with per-track management and cache control
- Remote control of other Jellyfin player sessions
- SyncPlay for synchronized listening across devices
- Playlist backup and restore
AltSound looks great on a plain Jellyfin install, but two server-side plugins unlock the smart features:
- Playback Reporting — official Jellyfin plugin. Required for the home screen's "most played this week", "recently played", and the personalized "for you" section. Without it, those sections stay empty.
- AudioMuse-AI — community plugin that analyzes your library's audio and improves Instant Mix, similar albums, and more like this recommendations. Jellyfin's built-in recommendations work without it, but AudioMuse-AI makes them noticeably better, especially for niche libraries.
Both install through your Jellyfin server's Dashboard → Plugins.
- Your Jellyfin credentials are stored in the device's secure keychain — never in plain text.
- Only the access token is sent to your own server. No data goes to AltSound, the developers, or any third party.
- No analytics. No telemetry. No ads.
Pull requests and issues are welcome — see CONTRIBUTING.md to get a development environment running. All contributors are expected to follow the Code of Conduct.
Licensed under the Apache License, Version 2.0. See NOTICE for attribution.