All installation guides
Installation Guide

Can you get IPTV
on a Dreambox?

Yes. A Dreambox running Enigma2 handles IPTV natively through a plugin — no extra hardware and nothing plugged into the HDMI port. Install XStreamity from your image's plugin feed, add your EyePTV login, and Live TV, movies, series and catch-up appear inside the Dreambox interface alongside your satellite channels. Seven steps, about ten minutes.

About 10 minutes 7 steps XStreamity plugin

You need Xtream Codes details, not an M3U link. XStreamity is built around separate server URL, port, username and password fields. One long get.php playlist link pasted into the Server URL box will always fail. If that is all you have from us, message us — we can normally pull the separate values from the same account.

Dreambox on Enigma2

Running an image such as OpenPLi, OpenATV, DreamElite, Newnigma2 or Merlin. Recent tutorials cover DM920, DM900, DM7080, DM820 and DM525.

Internet connection

The box must be online to pull the plugin feed and reach our server.

Xtream Codes details

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

XStreamity is a player, nothing more. Its own developers state the plugin ships with no channels and no playlists — you supply your own provider details. EyePTV is that provider.

Dreambox OpenPLi plugin browser showing XStreamity
Enigma2 plugin browser — enigma2.net
1

Open the plugin browser and install XStreamity

Press Menu → Plugins. On OpenPLi and most Enigma2 images the Green button downloads or browses the available plugin feed.

Look under Extensions for XStreamity and install it.

Not in your feed? See the note below the steps — you can install the package manually, but it has to match your image and architecture.
2

Restart the Enigma2 GUI

When the install finishes, restart the GUI or reboot the box.

Don't skip this. XStreamity often won't appear in the menu until Enigma2 reloads, and people reinstall it two or three times before realising that is all it needed.

XStreamity main menu
XStreamity main menu — gomel-sat.bz
3

Open XStreamity and select Add Playlist

Launch XStreamity from the Dreambox menu. On the main screen choose Add Playlist and press OK.

XStreamity Add Xtream Codes server screen
XStreamity Xtream Codes form — enigma2.net
4

Enter your EyePTV Xtream Codes details

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

Leave the other stream settings at their defaults unless we tell you otherwise, then press Green to save.

The Server URL field takes the host only. Don't paste a full get.php playlist link into it — XStreamity builds that itself from the separate fields. This is the single most common reason a Dreambox setup reports “invalid”.
XStreamity manage playlists screen
XStreamity playlists — star7arab.com
5

Select the EyePTV playlist

Go back to Playlists. Your EyePTV account appears in the list, usually with its expiry date and connection limit if our server reports them.

Highlight EyePTV and press OK.

Worth a look: the expiry date shown here comes straight from our server, so it is the quickest way to confirm your subscription is live.
XStreamity stream selection menu
XStreamity stream selection — dreambox4u.com
6

Pick a section and open a channel

XStreamity shows the sections your package includes — Live Streams, VOD / Movies, TV Series and Catch Up TV.

Open Live Streams, choose a category, pick a channel and press OK. Programme information appears alongside it wherever our server provides guide data.

XStreamity main settings and EPG options
XStreamity settings and EPG — gomel-sat.bz
7

Fix the guide if it's empty

If the TV guide is missing, go back to the XStreamity main screen and run Manual EPG Update. Give it time — a full guide download is not instant.

Under Main Settings you can set the automatic EPG download time along with the playback options. Worth setting once so the guide keeps itself current.

If it's not in your feed

Installing XStreamity manually

Dreambox software varies a lot by model and image, and XStreamity is not in every plugin feed. If it isn't in yours, you can install the package by hand and restart Enigma2 — but the package has to match your image.

DreamOS and other Debian-based images use .deb. Most other Enigma2 images use .ipk. Installing a package built for a different image or a different architecture is the usual way people end up with a broken plugin menu, so check before you install rather than after.

Use the maintained XStreamity project or the package your image's community recommends. If you are not comfortable doing this, message us with your model and image and we'll tell you whether it's worth attempting on your box.

If something doesn't work

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

XStreamity installed but isn't in the menu

Restart the Enigma2 GUI, or reboot the box. Then check under both Menu and Plugins — different images file it in different places. This is almost always the fix.

The playlist says invalid or connection failed

Check Protocol, Server URL, Port, Username and Password one field at a time. The usual cause is a full get.php link pasted into Server URL, or the port typed into the URL field instead of the port field.

I only have one long M3U URL

XStreamity is designed around Xtream Codes server details rather than a playlist link. Message us — we can normally read the server, username and password out of the account you already have.

Streams open but playback stutters

Test on Ethernet rather than Wi-Fi first, then reboot the box. If it persists, try a different stream type or playback engine in XStreamity's settings — some Dreambox images run better with ServiceApp.

Movies work but the guide is empty

Run Manual EPG Update and let it finish — it takes longer than people expect. If you changed EPG settings first, restart the GUI afterwards.

Catch-up is missing on a channel

Catch-up has to be provided by 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 exact Dreambox model (DM900, DM920, DM525, Dreambox One, Dreambox Two) and the image you're running — OpenPLi, OpenATV or otherwise. That tells us most of what we need.

Get help on WhatsApp
Setting up another device? See all guides No subscription yet? See the plans Other questions? Read the FAQ

Sources & verification

The screenshots on this page come from public pages showing real XStreamity and Enigma2 interfaces; each credits its source underneath. None are AI-generated. Menus differ between Dreambox models and images. Checked August 2026.