Support

Get help with NaviBeat

Email support@navibeat.app and we will get back to you within 48 hours.

What server does NaviBeat require?

NaviBeat works with any Navidrome server (v0.50 or later) or any OpenSubsonic-compatible server. Navidrome is free and open source. See navidrome.org for installation instructions.

The app says "Cannot reach server". What do I do?

Check that your Navidrome server is running.
Check that the URL you entered is correct, including the port number (e.g., http://192.168.0.110:4533).
If you are away from home, make sure your server is accessible from outside your home network (via a reverse proxy, Tailscale, or similar).
If your server uses a self-signed TLS certificate, NaviBeat may reject the connection. Use a trusted certificate (Let’s Encrypt is free) or reach out to us for help.

NaviBeat says "connected" but no library loads on my iPhone, while my iPad on the same WiFi works fine.

Three iOS-side network filters can block local-server connections on one device while another device on the same network is unaffected. Check these on the device that's failing:

Local Network permission. Open Settings → NaviBeat → Local Network and turn it ON. iOS 14+ silently denies private-IP connections (your home server’s 192.168.x.x or 10.x.x.x address) for any app that hasn’t been granted this permission.
iCloud Private Relay. Open Settings → Apple Account → iCloud → Private Relay. If your server is on a private IP (LAN, .local hostname, Tailscale CGNAT range), Private Relay can hijack the request through Apple’s relay and fail to reach it. Turn Private Relay OFF temporarily; if the library now loads, that was the cause.
Active VPN profile. Open Settings → General → VPN & Device Management. A VPN that routes all traffic (rather than splitting LAN traffic) blocks local-network destinations. Disconnect the VPN and try again.

The same checks apply to Mac (System Settings → Privacy & Security → Local Network), and to Apple TV in a more limited way (no Local Network toggle exists, but a configuration-profile VPN can block server access, check Settings → General → VPN & Device Management on tvOS).

How do I tell whether NaviBeat lost network access vs. my server being unreachable?

Open NaviBeat on a different device on the same network. If a second device works, the issue is local to the failing device (most often the three filters above). If no device can reach it, the server itself is the problem: check that Navidrome is running, the right port is open, and your URL hasn’t changed.

Playback cuts out or stutters. How do I fix it?

Try lowering the max bit rate in Settings > Audio to 192 kbps or 128 kbps.
Check your home network. A wired connection for the Apple TV improves stability significantly.
Check your server’s CPU and disk usage. If Navidrome is transcoding on a slow machine, playback can lag.

Where is my NaviBeat data stored?

Everything is on your device or your own server. NaviBeat does not send any data to us or any third party. See our Privacy Policy for details.

Can I use NaviBeat with multiple servers?

v1 supports one server per install. Multi-server support is on the roadmap.

How do I disconnect from my server?

Open the Settings tab, scroll to the Server section, and tap Disconnect. This clears your credentials from the device.

Glossary

Short definitions for terms used across this page and the rest of navibeat.app.

Navidrome: Free, open-source self-hosted music server. The primary server NaviBeat targets. Runs on Linux, macOS, Windows, Docker, NAS appliances, and even a Raspberry Pi. navidrome.org.
OpenSubsonic: An open extension to the original Subsonic API that standardises modern endpoints (year-in-review, time-synced lyrics, extended metadata). NaviBeat speaks OpenSubsonic and is listed on navidrome.org/apps with the OpenSubsonic indicator.
Subsonic: The original self-hosted music server (2006) whose HTTP API became a de-facto standard. Most modern servers (Navidrome, Airsonic-Advanced, Gonic) implement a superset of the Subsonic API and now extend it via OpenSubsonic.
Airsonic-Advanced: A community fork of Airsonic itself a fork of Subsonic. Implements the Subsonic API. NaviBeat works with Airsonic-Advanced via the shared API.
Gonic: A lightweight Go implementation of the Subsonic + OpenSubsonic API. Popular for low-power servers. NaviBeat works with Gonic.
Universal Purchase: Apple's mechanism where one $5.99 purchase covers the iOS, iPadOS, macOS, tvOS, and watchOS apps. Buy NaviBeat once on any Apple device and it installs on the other four for free.
LRC lyrics: A lyrics file format with per-line time stamps ([mm:ss.xx]). NaviBeat reads LRC straight from your Navidrome and renders them time-synced: tap any line to seek.
AutoMix: NaviBeat's endless-playback mode. When the queue runs out, AutoMix uses your server's similar-track / similar-artist data (optionally enriched via Last.fm) to keep music going without manually building a queue.
Scrobble: Reporting a play event to Last.fm so it's recorded in your listening history. NaviBeat never scrobbles directly to Last.fm: scrobbles route through your Navidrome server (which already holds your Last.fm credentials), keeping the trust boundary on your side.
CarPlay: Apple's in-car experience that mirrors a subset of an iPhone app on the head-unit display. NaviBeat ships full CarPlay support: library, search, Now Playing, and continuous-push playback.