Help & FAQ

We've got you covered.

Answers to the most common questions about JellyWave, Jellyfin, and everything in between.

Frequently Asked Questions

Common questions

Can't find what you're looking for? Reach out directly — we're happy to help.

Yes — Jellyfin is required. JellyWave is a front-end music player that streams audio from your personal Jellyfin media server. Jellyfin is a free, open-source media server you self-host at home or on a cloud server. It organises your music collection and serves it to JellyWave on demand. If you don't have a Jellyfin server yet, visit jellyfin.org/docs to get started — it takes about ten minutes to set up.
On first launch, JellyWave presents a login screen. Enter your server URL (for example http://192.168.1.100:8096 for a local server, or your public domain), along with your Jellyfin username and password. JellyWave securely stores an access token on your device — your password is never saved. You can change or add servers later in Settings → Server.
Yes — JellyWave is a one-time purchase with no subscription, no recurring fees, and no in-app purchases. Pay once and enjoy every feature, including all future updates. There are no tiers or locked features. Jellyfin itself is also completely free and open source.
JellyWave requires macOS 12 Monterey or later. It runs natively on both Apple Silicon (M-series) and Intel Macs. For the best experience — including smoother animations and faster performance — macOS 14 Sonoma or later is recommended.
JellyWave only shows music from your Jellyfin server's Music libraries. A few things to check:

• Make sure your music is added to a Music library in Jellyfin (not a Generic or Videos library).
• Run a library scan in Jellyfin's dashboard to ensure new files are indexed.
• Confirm your Jellyfin user account has read access to the music library.
• Pull down to refresh the library inside JellyWave, or restart the app.

If the problem persists, check that your server URL is reachable from your Mac and that the Jellyfin service is running.
Yes. JellyWave has built-in Last.fm scrobbling. Go to Settings → Last.fm and sign in with your Last.fm credentials. Once connected, every track you listen to for more than half its duration (or at least 4 minutes) will be automatically scrobbled to your Last.fm profile. You can also toggle scrobbling on or off at any time without disconnecting your account.
The sleep timer gradually fades out and then pauses playback after a duration you choose. Access it via the Now Playing view — tap the moon icon or use the keyboard shortcut. You can set a custom time (5 minutes to several hours) or choose end of track to finish the current song cleanly before stopping. The crossfade setting also applies during the final fade-out for a smooth ending.
Email us at support@freakma.net. When reporting a bug, include your macOS version, JellyWave version (found in JellyWave → About), and steps to reproduce the problem.

Still need help?

Can't find the answer you're looking for? Drop us an email — we typically respond within one business day.

support@freakma.net