Documentation

Use it. Diagnose it.
Keep it playing.

End-user guidance for connecting a provider, installing the addon in Stremio or Nuvio, finding IPTV sources inside their normal catalogs, and diagnosing provider or network playback problems.

Quick start

  1. Open Configure.
  2. Choose Xtream Codes or M3U and enter your provider details.
  3. Use Test connection, then Connect.
  4. Select media types/categories and generate the manifest.
  5. Install in Stremio, or paste the HTTPS manifest URL into Nuvio.

Player integration

Install in Stremio

1
Generate a configured manifest.

Complete the configurator. The generated URL contains your provider settings and selected categories.

2
Choose Install to Stremio.

The button opens a stremio:// link. Confirm the installation in the Stremio app.

3
Find the addon in My Addons.

IPTV Bridge adds Live TV, Movies and Series catalogs according to the options you enabled.

4
Use normal Stremio catalogs and search.

Open a movie or episode from Stremio's Popular, Featured or Search results. If the same title exists in your IPTV library, IPTV Bridge appears in the Streams list with the available FHD/4K variants.

Manual installation: in Stremio Web, open Addons and paste the generated HTTPS manifest URL if the one-click protocol link does not launch.

Player integration

Install in Nuvio

CopyUse Copy manifest URL in the final configuration step. Nuvio needs the HTTPS URL, not the stremio:// URL.
AddOpen Nuvio's Addons area, choose the option to add an addon by URL, paste the full manifest URL and confirm.
BrowseYour IPTV catalogs appear in Nuvio after its addon list refreshes. Restart Nuvio if they do not appear immediately.
PlayOpen a normal Nuvio movie or episode. IPTV Bridge resolves its IMDB/TMDB identity against your IPTV provider and returns only the exact matching quality variants.

What appears where

IPTV Bridge catalogs

Browse provider content by type. Provider logos are shown immediately; richer TMDB artwork and episode information are resolved when a title opens.

Popular and search catalogs

The title comes from Stremio/Nuvio. IPTV Bridge contributes only streams for an exact IPTV title match, including separate FHD, 4K or other available quality URLs.

Movies

The addon compares normalized title identity and year while ignoring provider tags, codecs, language labels and quality markers.

Series

The provider's series list is matched first. When an episode is selected, Xtream episode data resolves the requested season and episode to its playable URL.

Slow source pages

The first request may be slower because a serverless instance must start and the provider list must be fetched. Later requests are cached.

IPTV Bridge returns catalog previews directly from provider data. Full TMDB metadata is loaded only when a title is opened.

If every request remains slow, the provider API is usually responding slowly or returning a very large playlist.

What usually causes buffering?

After a source is selected, the player connects directly to the IPTV URL. Playback quality is therefore mainly determined by the provider feed and the network path to it.

IPTV provider

Most common. Overloaded servers, unstable source, connection limits or transcoding cause stalls.

Your network

Weak Wi-Fi, ISP congestion, VPN routing or insufficient bandwidth can interrupt playback.

Diagnose the cause

Only one channel buffersThat source/provider feed is the likely cause.
Everything buffersTest another network, disable VPN and check provider status.
Source appears slowlyProvider API/TMDB lookup or serverless cold start; this is separate from video buffering.
Source appears but failsCredentials, subscription expiry, connection limit, unsupported codec or provider URL.
No source appearsThe title is unavailable or named differently in the provider library.

Privacy & security

Configuration is compressed into your manifest URL. Treat that URL like a password because it contains provider access details. IPTV Bridge does not store credentials in a database.

Direct playback: IPTV Bridge only returns a stream object containing the IPTV provider's original URL. Vercel does not proxy, relay, cache, download, segment, or transcode the video. After Stremio/Nuvio receives the response, the player connects directly to the provider.

Security headers

The site sends CSP, frame protection, MIME sniffing protection, referrer control and restricted browser permissions.

Rate limits

Connection testing is rate-limited per client to reduce credential abuse and upstream provider load.

Input validation

Manifest size, provider URLs, credentials, category counts and protocol IDs are bounded before processing.

Private-network blocking

Provider URLs targeting localhost, loopback, private LAN, link-local or unsupported protocols are rejected.

Keep your URL private: anyone who obtains a configured manifest URL may be able to use the IPTV credentials encoded inside it. Revoke or regenerate the provider credentials if the URL is exposed.