iPii.TV Help — User guide

🚀 GET STARTED

Live in 5 minutes

From signing up to a running stream — step by step.

01

Create account

Enter your email and password — done. No credit card, no subscription. Get started for free.
Go to home page
02

Import an M3U source

In Sources manager → Import paste your IPTV provider's URL or upload an M3U file.

https://provider.example/get.php?username=…&password=…&type=m3u_plus
03

Watch in the browser

Open ZapPilot, choose a channel, and start it directly in the player — done.
▶ Open ZapPilot
04

Install TV app (optional)

Install the APK on your TV, start pairing mode in the app, and read the 6-digit TV pairing code.
📥 Download APK
05

Pair and control TV remotely

Enter the TV pairing code in ZapPilot — each click in the browser now switches the channel directly on the TV.

Ready? Jump right in:

📡 ZapPilot 🎬 Library ▶ Live TV

⊞ MODULE

Module overview

What's included and what each module is for.

📡

ZapPilot

TV guide · EPG · TV controls in a focused companion interface.

CORE

▶

Live TV

Watch directly in the browser — HLS, low latency, keyboard controls.

CORE

🎬

Library

On-demand movies and series, with a watchlist, genre filter, and episode list.

CORE

⚒

Settings

Control center for account, security, color scheme, and pairing.

CORE

📂

Sources manager

Manage sources — import, check channels, EPG & logos, export.

CORE

⚽

Soccer

Schedule, live games, direct switch to the channel.

CORE

🛰

Multi-Stream

Multiple streams at once — PIP, split, grid.

CLASSIC

📡 ZAPPILOT

ZapPilot · TV guide

Live programming, now/next, EPG, and TV controls in a focused interface.

📋

Channel list with timeline

Each channel has a row with logo, name, group, and horizontal EPG timeline. The current show displays a progress bar; upcoming shows have a countdown.

🔍

Search

Searches channel names AND current EPG titles. Debounced at 120ms, with immediate results.

⤧

Merge variants

"Das Erste FHD DE" + "Das Erste HD DE" + "Das Erste DE" are merged into one family; small quality badges show the variants.

★

Favorites

Star at the top right of each channel row. Saved in localStorage and synced with the server across devices.

🏷

Category chips

Top 40 genres with count badges. "Favorites" and "All" as quick filters.

📅

Switch day

Today / Tomorrow — slides the timeline to the selected day.

Tip: Click a program card to open a details overlay with description, cast, director, season/episode, and trailer link.

▶ LIVE TV

Live TV · Browser playback

HLS.js-based stream player with a channel sidebar and EPG bar.

01

Choose source

Open the dropdown in the right sidebar and select the source you want.
02

Filter channels

By group, search, or the ☆ Favorites filter.
03

Click a channel

HLS.js starts automatically. For HTTP streams: proxy. For VOD content: external player.
04

Keyboard controls

Space=Pause · F=Fullscreen · M=Mute · ←/→=Channel · ↑/↓=Volume ±5%

🎬 LIBRARY

Library · Movies & series

On-demand catalog with a hero carousel, genre filter, and details overlay.

🎞

Hero-Carousel

5 featured titles rotate every 7s, with backdrop, rating, genre, and direct play.

🏷

Genre filter

28 German genres with count badges — Drama 2362, Thriller 2189, Comedy 1914 ...

📺

Series episodes

Season selector and episode list with play button. Air date is displayed.

★

Watchlist

Add to the watchlist with server sync — available on every device.

🕓

History

Up to 20 recently watched titles are stored locally.

🎬

Trailer

YouTube trailer button in the details overlay (when available).

📺 PAIRING

Set up TV pairing

Enter the TV pairing code from the TV — then each click in the browser controls the TV.

A

On the TV

Open the iPii.TV app → Settings → "Enable pairing" → A 6-digit TV pairing code appears.

1 2 3 · 4 5 6

↓

B

In the browser

On your phone or computer, open ipii.tv/link (or scan the QR code on the TV) and enter the 6-digit pairing code from step A.

→ Open ipii.tv/link

↓

C

Controls

Connected! Click "📺 Send to TV" on a channel in ZapPilot — the stream starts on the TV immediately.

📂 SOURCES MANAGER

Import sources

Import an M3U URL or Xtream credentials.

OPTION A — M3U URL

1 Open Sources manager, "Import" tab
2 Paste URL
3 Enter a name and save
4 Done — the source is in ZapPilot

https://provider.example/get.php?username=USER&password=PASS&type=m3u_plus

OPTION B — XTREAM API

1 Sources manager · Import · Xtream tab
2 Enter server URL, username, and password
3 Connect — all channels and VOD load in sync

Important: Up to 5 sources are allowed per account. Delete unused ones under "Manage sources" in the Sources manager.

📱 TV-APP

Install Android TV app

For Fire TV, Android TV, Google TV, and NVIDIA Shield.

01

Enable unknown sources

TV settings → Security → enable "Install apps from unknown sources". On Fire TV: My Fire TV → Developer options.
02

Download APK

Open the APK in the TV browser or via Downloader.
📥 iPiiTVPlayer.apk
03

Install

Tap "Install". If warned, choose "Install anyway".
04

Pair TV

Start the app → note the TV pairing code → enter it in ZapPilot.

System requirements: Android TV 7.0+, approx. 15 MB storage, Wi-Fi or Ethernet.

⌨ SHORTCUTS

Keyboard shortcuts

Faster controls in Live TV and IT Cockpit.

WEB-PLAYER

SpacePause / Play

FFullscreen

MMute / Unmute

← →Previous / next channel

↑ ↓Volume ±5%

IT-COCKPIT (ADMIN)

1 – 9Switch tabs

RManual refresh

EscClose dialogs

GLOBAL

⌘K / Ctrl KFocus search (Help)

EscClose overlay

❓ FAQ

Frequently asked questions

Quick answers — click a question to expand it.

How many sources can I import?+

Up to 5 sources per account. You can delete old ones in the Sources manager.

Does iPii.TV work without an IPTV subscription?+

iPii.TV itself is free, but you need an M3U source (your own file or an IPTV provider URL). You can find freely available M3U lists, for example, at iptv-org/iptv (GitHub).

Which stream formats are supported?+

HLS (m3u8) is the primary format — it works in the browser and TV app. MPEG-TS is natively supported in the TV app; in Live TV, .ts runs via a transcoding proxy.

Why do I see "Open in external player"?+

For VOD content (movies/series) or HTTP streams on an HTTPS page (mixed content), the browser cannot play directly. The external player works around this.

How does TV pairing work?+

The TV app generates a 6-digit TV pairing code. Enter it in the browser; the server stores the connection. Control commands are then pushed directly from the browser to the TV — push latency under 500ms.

Where is my data stored?+

Account, sources, and watchlist are stored on our server (ipii.tv, Frankfurt). Watch history, theme settings, and cache are stored locally in the browser (localStorage).

Can I watch multiple channels at once?+

Yes — in the Multi-Stream module (classic view), you can run 2 or 4 streams at once in PIP/split/grid.

How does the TV app update?+

Automatically — at startup, the app checks for a newer version and installs it without intervention.

🔧 TROUBLESHOOTING

Troubleshooting

Common errors and their solutions.

⚠

No channel starts — but the internet works

DNS NETWORK

Typical symptoms: The website and app load normally, but every channel stops immediately — often with “Playback error (Code 1004).” It may work on a phone on the same Wi-Fi network.

The cause: Your router or device uses a DNS server with a filter list (e.g., AdGuard, Pi-hole, NextDNS, or a filtered provider DNS). Your IPTV provider's address is on such a list and is not resolved. Your internet connection is fine — only this name is blocked.

Why it sometimes still works in the browser: Some browsers (such as Opera with VPN/proxy enabled) resolve addresses through their own servers, bypassing your filter without you noticing.

Solution A — allow the address in your own filter: If you deliberately use a filter, add your provider's domain to its allowlist. In the filter log it usually appears as “blocked.”

Solution B — use unfiltered DNS:

Open the router interface → change DNS from “automatic” to “manual”
Enter two unfiltered servers (examples; your choice): 9.9.9.10 and 149.112.112.10 (Quad9 without a filter list) — or 1.1.1.1 and 1.0.0.1 (Cloudflare)
Save, then briefly disconnect the router and TV from power
Open the channel again

Quick test: Open your provider's address in the browser on the same device. If nothing loads there while ipii.tv loads, DNS is a strong likely cause. (Less often, the provider itself has an outage or a firewall is responsible.)

iPii.TV does not provide channels and cannot bypass or remove such blocks. This guide only helps you find the cause in your own network.

⚠

Stream will not load / buffering

HLS NETWORK

First check:

TV Wi-Fi signal is stable (at least 10 Mbps for FHD)
Another channel with the same quality works
The browser console (F12) may show CORS/CSP errors

Solution: In Settings → Actions → "Clear cache", then restart the channel.

⚠

TV pairing code is not accepted

PAIRING

The code is valid for 10 minutes. Create a new one on the TV. Make sure the TV and browser are signed in to the same account.

⚠

EPG shows "No EPG data"

EPG

The channel has no matching entry in our EPG database. Some highly specialized or regional channels are not included. For major channels (ARD, ZDF, RTL): "↻ Refresh" in the channel row.

⚠

App cannot be installed (Android TV)

TV-APP

Check whether "Unknown sources" is enabled in TV settings. Fire TV: Settings → My Fire TV → Developer options → Apps from unknown sources.

⚠

Forgot password

ACCOUNT

Click "Forgot password" on the home page. A reset link will be sent to your email.

💬 CONTACT