The Enigma2 tutorial for Dreambox in English (Complete Guide)

Introduction: Dreambox and Enigma2, the kings of satellite

For many years, satellite receivers running on the Enigma2 Linux operating system (like the famous Dreambox, Vu+, or Zgemma brands) have been the absolute benchmarks for TV reception. If you are typing "How to add IPTV channels to Dreambox" on the internet today, it's because you have understood that these super-powerful machines are not limited to satellite: they are also fantastic for handling IPTV streams via the Internet.

This comprehensive guide will show you how to elegantly integrate thousands of channels from your IPTV subscription directly into your decoder's native "bouquets" (favorites), exactly as if they were classic satellite channels.

Prerequisites before you begin

Unlike a simple app on a Smart TV, integration on a Dreambox requires some basic computer knowledge. Here is what you need:

• Your Dreambox / Vu+ receiver turned on and connected to your local internet router (preferably via an Ethernet cable for optimal stability).
• A computer connected to the same Wi-Fi/Ethernet network.
• A free SSH/Telnet client software, like PuTTY (on Windows) or the native Terminal (on Mac).
• The auto-installer script ("wget" command). This script is sent to you by your IPTV provider when you subscribe. It looks like a long line of code starting with wget -O /etc/enigma2/iptv.sh...

Method 1: Installation via the Auto-Installer script (Recommended)

This is the fastest, cleanest, and most commonly used method by professionals. The script will automatically download the channel list and arrange them in your decoder's bouquets.

Step 1: Find the IP address of your Dreambox

Go into your decoder's menu with the remote control: Menu > Information > Network (or Menu > Setup > System > Network). Write down the IP address displayed (e.g., 192.168.1.50).

Step 2: Connect via PuTTY

1. Open the PuTTY software on your computer.
2. In the "Host Name (or IP address)" field, type your Dreambox's IP address (e.g., 192.168.1.50).
3. Check the "Telnet" (port 23) or "SSH" (port 22) protocol. Click Open.
4. A black window (console) will open. When asked "login as:", type root and press Enter. By default, there is no password, or the password is dreambox.

Step 3: Run the installation script

Now that you are connected inside the "brain" of your Dreambox:

1. Right-click in the black PuTTY window to paste the wget script you received from us.
2. Press Enter.
3. The download will start, and you will see lines of text scroll by. The operation takes between 10 seconds and 1 minute depending on the size of the subscription.
4. Once completed, the console will display that your Dreambox will restart automatically. (If it does not restart, type reboot and press Enter).

Congratulations! Once the machine has turned back on, press the "Favorites" (Bouquets) button on your remote control. You will see new folders appear containing all your IPTV channels, sorted by country, ready to be watched!

Method 2: Using the "XStreamity" or "XCPlugin" plugin

If you prefer to have a dedicated "Netflix" style interface separate from your satellite channels, using a plugin (extension) is an excellent idea. The XStreamity plugin is currently the best for Enigma2.

1. From your Dreambox menu, go to Plugins > Download plugins (green button) > Extensions and install XStreamity.
2. Open the plugin. There, you must insert your server URL, your username, and your password (the famous Xtream API codes).
3. You will then be able to navigate a beautiful interface with VODs, movie posters, and the TV guide, just as if you were on an Android box! To learn more about the other systems, read our multi-platform installation guide.

Enigma2 Frequently Asked Questions (FAQ)