Support

Get help with NaviFin

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

What server does NaviFin require?

NaviFin works with any Jellyfin server (v10.9 or later). Jellyfin is free and open source. See jellyfin.org for installation instructions. NaviFin is an independent client and is not affiliated with or endorsed by the Jellyfin project.

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

Check that your Jellyfin server is running.
Check that the URL you entered is correct, including the port number (e.g., http://192.168.0.110:8096).
If you are away from home, make sure your server is accessible from outside your home network (via a reverse proxy, Tailscale, or similar).
Behind Cloudflare Access or another proxy? Add your custom access headers (for example CF-Access-Client-Id and CF-Access-Client-Secret) in the advanced section when you pair.
If your server uses a self-signed TLS certificate on the LAN, NaviFin can fall back to a trusted-LAN connection. If it still fails, use a trusted certificate (Let’s Encrypt is free) or reach out to us for help.

NaviFin says "connected" but nothing 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 → NaviFin → 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 it 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).

A video won't play, or plays with no sound.

NaviFin uses a hybrid engine: Apple’s AVPlayer plus a bundled VLC engine. If a file fails on one, NaviFin can fall back to the other. For exotic containers (MKV), codecs (HEVC), or surround audio, the VLC engine usually handles it directly.

If audio is missing, open the player’s audio track menu and pick a different track; some files ship several audio streams.
If subtitles don’t show, open the subtitle menu and select a track; both embedded and external subtitles are supported.
If a specific file refuses to play, let us know the container and codecs (for example MKV / HEVC / TrueHD) so we can reproduce it.

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

If your server is transcoding on a slow machine, playback can lag. Direct Play (no transcode) is smoothest when your device can decode the source format natively.
Lower the streaming quality in Settings if you are on a constrained connection.
A wired connection for the Apple TV improves stability significantly. Check your server’s CPU and disk usage during playback.

Where is my NaviFin data stored?

Everything is on your device or your own server. NaviFin does not send any data to us or any third party, and stores your server credentials in the device Keychain. See our Privacy Policy for details.

Can I use NaviFin with multiple servers?

Yes. NaviFin connects to multiple Jellyfin servers and lets you switch between them in one tap. Each keeps its own credentials in the Keychain and its own resume points. See the multi-server page for details.

How do I disconnect from my server?

Open Settings, find the server, and tap Disconnect. This clears that server’s credentials from the device Keychain.

Glossary

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

Jellyfin: Free, open-source self-hosted media server for movies, TV, music, Live TV, photos, and books. The server NaviFin targets. Runs on Linux, macOS, Windows, Docker, NAS appliances, and even a Raspberry Pi. jellyfin.org.
Direct Play: Playing a file as-is, with no server-side transcoding. The smoothest path when your device can decode the source format natively. NaviFin’s hybrid engine maximizes Direct Play.
Transcoding: The server converting media on the fly to a format your device can play. Useful for old codecs or constrained connections, but heavier on the server CPU. A wimpy server may struggle to transcode 4K.
Hybrid engine: NaviFin’s use of Apple AVPlayer for efficient native playback plus a bundled VLC engine for exotic formats (MKV, HEVC, surround, embedded subtitles). When one engine cannot handle a file, NaviFin falls back to the other.
Skip Intro / Skip Credits: Skipping an episode’s intro and end-credits using your Jellyfin server’s chapter or media-segment data. NaviFin shows a button when a segment is detected.
SyncPlay: Jellyfin’s watch-together feature. NaviFin can join a SyncPlay group so playback stays in sync across devices and people, even in different rooms or cities.
Universal Purchase: Apple’s mechanism where one purchase covers the iOS, iPadOS, macOS, and tvOS apps. NaviFin plans to launch this way at $6.99: buy once on any Apple device and it installs on the others for free. During the open beta everything is free on TestFlight.
Trickplay: Thumbnail previews along the timeline while you scrub, generated by your Jellyfin server. NaviFin shows them so you can find a scene without guesswork.