JammyMusic Support

Troubleshooting and help for the JammyMusic player for Jellyfin — on iPhone, Apple Watch, and CarPlay.

📱 iPhone App

JammyMusic connects to your own Jellyfin server. Most issues come down to the server connection, your network, or downloaded-content (offline) mode.

I can't log in / connect to my server
  1. Make sure your iPhone is on the same network as your Jellyfin server (or that the server is reachable over your VPN/remote setup).
  2. Enter the server's IP address exactly as shown in your Jellyfin dashboard, including the port if it uses one (for example 192.168.1.50:8096).
  3. Confirm the server is online by opening it in a web browser from another device.
  4. Double-check your username and password — they are the same credentials you use to sign in to Jellyfin.
  5. If your server uses HTTPS with a self-signed certificate, try the plain http:// address on your local network.
The app only shows downloaded music / says "Offline Mode"

This means the app can't currently reach your server, so it's showing only the music you've downloaded to the device.

  1. Check that your server is running and reachable.
  2. Confirm Wi-Fi or cellular is connected on your iPhone.
  3. The app reconnects automatically when the network returns — give it a few seconds, or close and reopen it to retry immediately.
My library is empty or slow to load
  1. Confirm you're connected (no "Offline Mode" banner).
  2. Large libraries take a moment to sync the first time — the home screen and "Recently Added" appear first while songs finish loading in the background.
  3. If it still looks empty, fully close the app (swipe it away in the App Switcher) and reopen it.
  4. Make sure your Jellyfin user has access to the music libraries on the server.
Downloading music

Open an album or playlist, tap the + / options button, and choose Download. Downloads continue in the background, so you can keep browsing and playing while they finish.

Downloaded files are organized by Artist and Album and remain available in Offline Mode. Logging out keeps your downloads; deleting a download removes only that item.

Playback stops when I lock the screen or switch apps
  1. JammyMusic supports background audio — use the Lock Screen and Control Center controls to play/pause and skip.
  2. If audio cut out, check that the iPhone isn't in Silent/Focus modes that affect media, and that AirPlay isn't pointed at a device that's powered off.
  3. If a single track won't play, try another song — if only one fails, it may need to be re-downloaded or may have an unsupported format on the server side.

⌚ Apple Watch

The Watch app can control playback on your iPhone or play music downloaded directly to the Watch. It gets your account and library from the iPhone app.

The Watch shows no music or "not connected"
  1. Open the JammyMusic app on your iPhone first. The iPhone sends your login and library to the Watch — the Watch can't sync on its own.
  2. Keep the iPhone and Watch nearby and unlocked while it syncs.
  3. Open the Watch app and give it a few seconds to receive the library.
  4. If it stays empty, make sure both apps are updated and that the Watch is paired and connected (check the Watch app on iPhone).
Difference between "control iPhone" and playing on the Watch
  • Remote control: the Watch controls music playing on your iPhone. This needs the iPhone nearby and connected.
  • Local playback: music downloaded to the Watch plays through the Watch (Bluetooth headphones recommended) and works without the iPhone.
Downloading music to the Watch
  1. Downloading songs to the Watch requires the iPhone to be connected, since the files transfer from the phone.
  2. Keep both devices nearby and on charge for large transfers — watchOS may pause transfers when the Watch is busy or low on battery.
  3. Once downloaded, that music plays locally even when the iPhone is away.
Library on the Watch is out of date
  1. Open the iPhone app to push the latest library to the Watch.
  2. If it still doesn't update, open the Apple Watch app on iPhone, and as a last resort uninstall and reinstall the JammyMusic Watch app, then reopen the iPhone app to re-sync.

🚗 CarPlay

JammyMusic works in CarPlay, including when the app wasn't already running. It shares your account with the iPhone app.

JammyMusic doesn't appear or is empty in CarPlay
  1. Make sure you've signed in at least once in the iPhone app — CarPlay uses the account saved on your phone.
  2. Reconnect: unplug and replug the cable, or toggle the Bluetooth/CarPlay connection.
  3. If the car was connected before you finished setup, fully close the iPhone app and reopen it, then reconnect to the car.
  4. If your server isn't reachable from the car, CarPlay shows your downloaded music so you can still play offline.
New music or playlists aren't showing in the car
  1. Open the iPhone app while connected to your server to refresh the library, then reconnect to CarPlay.
  2. The Favorites and Recently Played lists in CarPlay show a selection from your library to keep browsing quick while driving.
Playback or controls aren't responding in CarPlay
  1. Try pausing/playing from the car's controls and from the iPhone Lock Screen.
  2. Disconnect and reconnect CarPlay.
  3. Restart the iPhone if controls remain unresponsive — this clears most temporary audio-session issues.

🛠️ General Tips

Steps that fix most problems
  1. Make sure JammyMusic is updated to the latest version from the App Store.
  2. Confirm your Jellyfin server is online and reachable.
  3. Fully close the app (swipe it away in the App Switcher) and reopen it.
  4. Restart your iPhone.
  5. As a last resort, sign out and sign back in — your downloads are kept.
Privacy & your data

JammyMusic connects only to the Jellyfin server you configure. Your login is stored securely in the device Keychain and used to talk to your server. The app does not sell or share your listening data.

✉️ Still need help?

If these steps didn't solve it, send me a note. Please include your device model, iOS version, and a short description of what happened.

Email Support

[email protected]