All installation guides
Installation Guide

How to set up IPTV on an
Enigma2 receiver

For Vu+, Zgemma, Octagon, Gigablue, Edision, Mutant, Qviart and other Linux receivers. Install XStreamity from your image's plugin feed, add your EyePTV login, and Live TV, movies, series and catch-up appear alongside your satellite channels. Eleven steps, about fifteen minutes.

About 15 minutes 11 steps XStreamity plugin

XStreamity is not an M3U player. It is built around Xtream Codes login details entered as separate fields — server URL, port, username and password. If all we sent you was one long get.php link, message us: we can usually read the separate values out of the same account.

An Enigma2 receiver

Vu+, Zgemma, Octagon, Gigablue, Edision, Mutant, Qviart and other Linux boxes.

A supported image

OpenATV, OpenPLi, OpenViX, OpenHDF, OpenSPA, OpenBH and others that carry the plugin.

Xtream Codes details

Server URL, port, username and password — as four separate values.

On a Dreambox? Same plugin, same steps — we have a separate Dreambox page covering the DreamOS package differences. The screenshots below are from OpenATV 7.6; other images look slightly different but the button names are the same. XStreamity is a player only — its developers state it ships with no channels and no playlists. EyePTV supplies those.

Part 1 — Install the plugin
OpenATV 7.6 XStreamity setup screen
Enigma2 Plugin Browser — enigma2.net
1

Open the Plugin Browser

Press MENU on the receiver remote and select Plugin Browser.

OpenATV 7.6 XStreamity setup screen
Plugin Browser, Green to install — enigma2.net
2

Press the Green button

Inside the Plugin Browser press Green for Install Plugins. That is what pulls the list down from your image's feed.

OpenATV 7.6 XStreamity setup screen
Install Plugins to Extensions — enigma2.net
3

Open Extension Packages

Select Extension Packages — some images call it just Extensions — and press OK.

OpenATV 7.6 XStreamity setup screen
XStreamity in the extensions feed — enigma2.net
4

Find XStreamity in the list

Scroll down to XStreamity. The feed describes it as an IPTV Xtream Codes playlist player, which is how you know you have the right entry.

Press OK to select it.

OpenATV 7.6 XStreamity setup screen
Installing XStreamity from the feed — enigma2.net
5

Install it, then restart the GUI

Press Green to start the install and confirm Yes. When it finishes, restart the Enigma2 GUI or reboot the receiver.

Don't skip the restart. XStreamity frequently will not show up in the menu until Enigma2 reloads, and people reinstall it two or three times before working that out.

Part 2 — Add your EyePTV login
OpenATV 7.6 XStreamity setup screen
XStreamity after installation — enigma2.net
6

Open XStreamity

After the restart, press MENU and look for XStreamity. On some images it lives inside Plugins instead — check both before assuming the install failed.

OpenATV 7.6 XStreamity setup screen
XStreamity Add Playlist — enigma2.net
7

Select Add Playlist

On the XStreamity main menu choose Add Playlist and press OK.

OpenATV 7.6 XStreamity setup screen
XStreamity Xtream Codes form — enigma2.net
8

Enter your EyePTV details

Fill each field separately, exactly as we sent them: Name — type EyePTV. Protocol — http:// or https://. Server URL — the host on its own. Port, Username, Password.

Press Green to save.

Server URL takes the host only. Don't paste a full get.php playlist link into it — XStreamity builds that itself from the separate fields. Watch for accidental spaces too; they are invisible on screen and break the login silently.
Part 3 — Start watching
OpenATV 7.6 XStreamity setup screen
XStreamity main menu with Playlists — enigma2.net
9

Open Playlists

Once saved, XStreamity adds a Playlists entry to its main menu. Select it and press OK.

OpenATV 7.6 XStreamity setup screen
XStreamity Manage Playlists — enigma2.net
10

Select the EyePTV playlist

Your EyePTV account appears in Manage Playlists. Where our server supplies it, XStreamity shows the account status, expiry date and connection limit here.

Highlight EyePTV and press OK.

Useful to know: the expiry date on this screen comes straight from our server, so it is the fastest way to confirm your subscription is live.
OpenATV 7.6 XStreamity setup screen
XStreamity content menu — enigma2.net
11

Browse your content

The playlist menu shows whatever your package includes — Live Streams, VOD / Movies, TV Series, Catch Up TV, plus Playlist Settings and Manual EPG Update.

Pick a section and browse with the remote. If the guide is empty, run Manual EPG Update and let it finish — it takes longer than most people wait.

If it's not in your feed

When XStreamity isn't listed

Availability varies between images and versions. First update your image's package and plugin feeds, then check Extensions again — that alone fixes it most of the time.

If your image still doesn't carry it, advanced users can install a package from the maintained XStreamity project directly. Use the format and architecture that matches your receiver and image. Installing a package built for a different Enigma2 image is the usual way people end up with a broken plugin menu, so check first rather than after.

On OpenPLi? The flow is the same, just worded differently: Menu → Plugins → Green → Extensions → XStreamity → install → restart GUI → Add Playlist.

If something doesn't work

Six things that go wrong on Enigma2 receivers, and how to fix them.

XStreamity isn't there after installing

Restart the Enigma2 GUI or reboot the receiver, then check under both Menu and Plugins — different images file it in different places. This is almost always all it needs.

The playlist shows invalid or inactive

Check Protocol, Server URL, Port, Username and Password one field at a time, and look for accidental spaces — they don't show on screen but they break the login. Then confirm with us that the subscription is active.

I was only given an M3U URL

XStreamity works from Xtream Codes details rather than a playlist link. Message us and we'll pull the server, port, username and password from the same account.

Streams open but stutter

Try Ethernet instead of Wi-Fi first, then reboot. If it persists, change the stream type or playback engine in XStreamity's settings — some images run better with ServiceApp.

Channels work but the guide is empty

Run Manual EPG Update from the playlist menu and let it finish. A full guide download takes several minutes. Restart the GUI afterwards if you changed EPG settings.

Catch-up is missing on a channel

Catch-up has to come from the source for that specific channel — the plugin can't create it. Tell us which channel and we'll check whether it carries catch-up on your package.

Stuck on a step?

Message us with your receiver (Vu+ Duo, Zgemma H9, Octagon SF8008 and so on) and the image you're running. That tells us most of what we need to know.

Get help on WhatsApp
On a Dreambox? See the Dreambox guide No subscription yet? See the plans Other devices? See all guides

Sources & verification

Every screenshot on this page comes from enigma2.net's OpenATV 7.6 tutorial; each credits its source underneath. None are AI-generated. Other Enigma2 images look slightly different but use the same button names. Plugin release visible at time of writing: v5.58 (July 2026) — check the project page for anything newer. Verified August 2026.