FREN

MANAGE ZAPTVIO

Set up ZAPTVIO from your phone.

Add a playlist, organise channels or put together a movie collection in your browser. Entering addresses and organising content is easier with a phone or keyboard than with the remote.

How to connect Understand JSON collections

GETTING CONNECTED

Scan the QR code on your TV.

Open ZAPTVIO on Apple TV, then scan its QR code with your phone. The page opens in your browser, with nothing to install.

In a browser, enter the code displayed on your Apple TV. The QR code opens setup directly.
In a browser, enter the code displayed on your Apple TV. The QR code opens setup directly.

  1. Open ZAPTVIO on Apple TV.

    Find web access and its QR code in the app menu or Settings → Web. Keep ZAPTVIO open.

  2. Join the same network.

    Scan the QR code with your phone. You can also enter the full local address, including its port, in a browser and use the code shown on the TV.

  3. Organise, then enjoy it on TV.

    Check the active profile, open the section you need and save your changes. Sources and collections belong to the selected profile.

Keep your phone and Apple TV on the same network with ZAPTVIO open. An isolated guest network may prevent the connection.

Find the QR code and connection address in the main menu.
Find the QR code and connection address in the main menu.

WHAT YOU CAN DO

Set up your sources and organise your app.

Changes apply to the profile shown at the top of the page. You will see them in ZAPTVIO on your Apple TV.

Playlists and Jellyfin

Add Xtream or M3U playlists and connect your Jellyfin library. Name your playlists, reorder them and choose which ones to show.

Your TV guide

Choose the playlist guide or add an external XMLTV source. Fine-tune a channel’s guide assignment from its context menu on Apple TV.

Make your channels your own

Reorder categories and channels, rename them and hide what you do not watch. Movie and series rows have their own organisation controls.

Profiles and parental controls

Create profiles and choose avatars. A dedicated area manages the PIN and restrictions, subject to authorised access.

Collections and artwork

Create collections, add folders and link them to your Jellyfin catalogues. Customise covers, backdrops and the other artwork supported by the editor.

Files, storage and DVR

Find local files, set network destinations and follow transfers. Pair ZAPTVIO Server using its pairing link for autonomous DVR.

Trakt and synchronisation

Connect Trakt tracking and manage the iCloud synchronisation supported by the app. These services use your own accounts.

Your WireGuard configuration

Import your own configuration in the VPN section. ZAPTVIO does not provide a VPN account or VPN service.

Basic setup is included. Multiple playlists, additional profiles and some organisation features require ZAPTVIO Pro.

Compare included and Pro features

IMPORTING COLLECTIONS

Import your collections from a JSON file.

A collection groups folders shown in Catalogs. Each folder connects a presentation — title, cover and backdrop — to one or more catalogues available through Jellyfin.

Collection · Movie night
Folder · New releasesFolder · AdventureFolder · Series

Each folder → custom artwork + linked Jellyfin source

JSON is a text file format that describes this organisation. You do not need to write code: import a compatible file, check its source mappings, then refine the result in the visual editor.

  1. Connect Jellyfin first.

    Add the server to ZAPTVIO first and make sure its libraries are accessible to your user.

  2. Open Collections → Import or export.

    Select the JSON file or paste its contents, then choose the destination Jellyfin server. Supported legacy collection files and ZAPTVIO version 2 exports are accepted, up to 1 MB.

  3. Review each source mapping.

    Select the matching catalogue for each folder. Suggested mappings remain editable and existing genre filters are preserved.

  4. Add your collections and personalise them.

    The import adds collections and keeps your existing ones. If you confirm, a missing source can remain unassigned for later. Reorder folders and adjust their artwork in the editor.

Your organisation, ready to import

Your collection and folder structure, along with compatible artwork. ZAPTVIO exports remove source connection identifiers; libraries are mapped again during import.

Your content stays in your sources

The file does not contain movies or create a library on Jellyfin. A collection named Netflix is a personal arrangement of catalogues: it does not connect a Netflix subscription.

Explore collections on TV
Organise your collections from your phone or computer.
Organise your collections from your phone or computer.

APP SETTINGS AND RECORDINGS

What does ZAPTVIO Server add?

The management page lets you configure ZAPTVIO while the app is open on Apple TV. ZAPTVIO Server is installed separately on a NAS or computer using Docker to handle recordings.

To record while Apple TV is off, use ZAPTVIO Server and the autonomous DVR engine. To write from Apple TV to a network share, the app must stay active.

Explore ZAPTVIO Server