⚙️ Setup Guide6 Minute Read

How to Setup IPTV on Enigma2 / Zgemma Devices (Putty Guide)

Enigma2 based receivers (like Zgemma, Vu+, and Dreambox) are fantastic, highly customizable Linux devices. However, because they are satellite/cable hybrid boxes, installing IPTV on them is vastly different from downloading an app on a Firestick. It requires basic SSH (Secure Shell) knowledge using a program like Putty.

Prerequisites

Step 1: Find Your Zgemma IP Address

Before you can connect, you need to know the local network address of your box.

  1. On your Zgemma remote, press Menu > Information > Network.
  2. Write down the IP Address (it will look something like `192.168.1.55`).

Step 2: Connect via Putty (SSH)

  1. Open the Putty application on your PC.
  2. In the "Host Name (or IP address)" box, type the IP address you found in Step 1.
  3. Ensure the Connection Type is set to Telnet or SSH (Port 23 or 22).
  4. Click Open. A black terminal window will appear.

Step 3: Login to the Box

The terminal will ask you for a login username and password. By default, almost all Enigma2 images (like OpenATV or VIX) use the exact same credentials:

Step 4: Execute the IPTV Script

Once you are successfully logged into the root command line of the Zgemma box:

  1. Copy your Enigma2 script provided by IPTV UK. It will begin with `wget -O /etc/enigma2/iptv.sh`.
  2. Right-click in the Putty terminal (in Putty, right-clicking automatically pastes your clipboard).
  3. Press Enter on your keyboard.

The script will run. It will automatically download the bouquets (channel categories) and EPG data directly into your receiver's memory. The Zgemma will usually reboot automatically. When it turns back on, you will find all the IPTV channels alongside your regular satellite channels in the bouquet menu!