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 play music downloaded to the Watch, stream directly from your server, or control playback on your iPhone. It gets your account and library from the iPhone app the first time, then works on its own.

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

Open an album, artist, or playlist on the Watch and tap the download button. Albums, artists, and playlists are all supported. The Watch downloads in two ways automatically:

  • Directly from your server whenever the Watch can reach it — on Wi-Fi, or over cellular if your server is reachable from outside your home (see the tip below). No iPhone needed.
  • Via your iPhone as an automatic fallback: if the Watch can't reach the server (for example, a home-only server address while you're out), it hands the download to your iPhone, which fetches the songs and syncs them to the Watch when the two are together.

Downloads continue in the background — you can lower your wrist or switch apps and they keep going. Reopen the Watch app to see progress and the "downloaded" checkmarks. Keep the Watch on its charger for large downloads.

Once downloaded, that music plays on the Watch even with the iPhone away.

Streaming or downloading over cellular (away from home)

To stream or download on the Watch away from home, your Jellyfin server has to be reachable from outside your home network. A plain home address like 192.168.x.x only works on your home Wi-Fi.

  • Use a public address for your server (a domain through a reverse proxy or tunnel), or
  • Use a VPN / mesh network such as Tailscale on the Watch and server, so the Watch can reach your home address from anywhere.

Whatever address you sign in with on the iPhone is the one the Watch uses, so point the app at an address that works both at home and 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

brentburroughs@gambittechnical.com