⚙️ Setup Guide6 Minute Read

Configuring IPTV on Enigma2 / Zgemma Boxes Using Putty (SSH Guide)

Enigma2-based receivers (including Zgemma, Vu+, and Dreambox) are exceptional, highly configurable Linux devices. However, since they are satellite/cable hybrid boxes, the IPTV installation process differs significantly from simply downloading an app on a Firestick. It demands basic SSH (Secure Shell) knowledge using software like Putty.

What You Need

Step 1: Locate Your Zgemma IP Address

Before establishing a connection, you must identify the local network address of your box.

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

Step 2: Establish a Putty (SSH) Connection

  1. Launch the Putty application on your computer.
  2. In the "Host Name (or IP address)" field, enter the IP address from 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 pop up.

Step 3: Authenticate with the Box

The terminal will prompt you for login credentials. By default, virtually all Enigma2 images (such as OpenATV or VIX) share the same default credentials:

Step 4: Run the IPTV Script

After successfully accessing the root command line of your Zgemma box:

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

The script will execute. It automatically downloads the bouquets (channel groupings) and EPG data directly into your receiver's memory. The Zgemma typically reboots on its own. Once it powers back up, all IPTV channels will appear alongside your standard satellite channels in the bouquet menu!