Support

Your NAS, on the big screen.

Contact

darjus.dev@gmail.com — send a message.

That address reaches the developer directly. JadePeak has no account, no ticket queue and no forum, so email is the whole support channel and there is nothing else to try first.

I usually reply within two business days. If you are reporting a problem, three things make it solvable from your first message: your Apple TV model, the tvOS version, and which kind of source you were playing from — SMB, NFS, DLNA, or a file on the Apple TV itself.

Frequently asked questions

What do I need to use JadePeak?

An Apple TV running tvOS 26.2 or later, and somewhere for the video to come from. That can be an SMB share (a NAS, a Windows share, or macOS File Sharing), an NFS export, a DLNA/UPnP media server, or files you send to the Apple TV itself from a browser on your wifi. There is no companion server or agent to install.

How do I get files onto the Apple TV itself?

Open the upload screen in JadePeak. It starts a small web page on your local network and shows you its address and a four-digit PIN on the TV; open that address in a browser on the same wifi, enter the PIN, and send your files. The page runs only while that screen is open and stops the moment you leave it or send the app to the background.

Uploaded files live in the app’s cache directory, which is the only place tvOS gives an app for large files. That means tvOS may remove them when the device runs short of space. Treat on-device storage as a convenience, not as where your library lives. Settings shows how much space uploads are using and can delete them all.

Why is it asking for Local Network permission?

Because your files are on your network, and JadePeak has to look there to find them. It is used to discover SMB and NFS hosts and DLNA servers, and to read from the source you pick. Denying it means JadePeak cannot see your servers.

It can’t find my server.

Add the host by IP address instead of waiting for discovery. Some networks block the Bonjour and SSDP traffic that automatic discovery relies on, and typing the address always works.

Beyond that: an SMB share must be SMB2 or later and the account you use must be able to read it; an NFS export must permit the Apple TV’s address; and a DLNA server must be running and sharing the folder you expect.

Does guest or anonymous SMB work?

Yes, as of 2.0. The SMB client was replaced, and the new one does not demand connection signing for an anonymous session, so a share published for guests connects without credentials — the Add Source wizard offers guest by default. Earlier versions refused it, and that answer used to live here.

Which video formats work?

Files Apple TV can open natively — MP4, MOV, M4V, TS — go through the system player. MKV and WebM are repackaged as they stream and handed to that same player: the video and audio are passed through untouched, nothing is re-encoded, and nothing is decoded in software.

AVI, WMV, FLV, MPG and MPEG stopped playing in 2.0, along with DASH manifests. They depended on a separate playback engine that has been removed. Remuxing them to MKV or MP4 with MKVToolNix or ffmpeg keeps the original video and audio exactly as they are and takes seconds. MP3 audio inside an MKV also stopped working — the Apple TV decodes MP3, but not from the container JadePeak now uses, so those files play without sound and say so.

What happened to subtitles?

The engine that was removed is also what displayed subtitles. Subtitles built into an MP4 still appear in the system track menu, because the Apple TV reads those itself. An .srt file sitting next to a video is not picked up in 2.0, and subtitle tracks inside an MKV or WebM do not survive the repackaging. Restoring both on the new player is the next piece of work.

What about HDR and Dolby Vision?

JadePeak streams the original bytes untouched and hands native files to the system player, so the platform’s own HDR pipeline does the work rather than a reimplementation of it. HDR10 and HLG arrive the way they were mastered, and HDR mode switching follows your Apple TV’s Match Content setting.

JadePeak does not claim Dolby Vision. The playback path preserves a Dolby Vision stream in principle, but it has not been confirmed on real hardware against a real DV file, so it is not advertised as a feature and is not listed on the App Store. Where a file’s name claims Dolby Vision but the playback path cannot deliver it — the separate engine used for MKV and similar containers — JadePeak says so on the tile before you press play, rather than after.

Does it remember where I stopped?

No, deliberately. JadePeak records nothing about what you watch: there is no Continue Watching row, no resume, and no watch history — not on the device and not anywhere else. Every file starts from the beginning.

Does it need the internet?

No. JadePeak talks to servers on your own network and to nothing else. There is no metadata scraping, no artwork lookup, no account, and no analytics.

Do my passwords get stored safely?

Share passwords go in the system Keychain, not in plain settings. Removing a source removes its password. DLNA servers and on-device files need no credentials at all.

Privacy

See the JadePeak Privacy Policy.