Skip to content

Enigma2 (Vu+, Dreambox) IPTV Setup

Expert-level IPTV configuration for Enigma2-based satellite receivers.

Recommended: Plugin
Advanced: SSH
10-20 min • Intermediate
Table of Contents

Requirements

Security Reminder

Set a root password if default is blank: passwd. Never leave SSH with empty passwords.

A

Method A — Plugin

Recommended • JediMaker Xtream / Xtreamity

1

Install Plugin

Menu → Plugins → Download Plugins (Green Button). Find 'JediMaker Xtream' or 'Xtreamity' in extensions category.

Enigma2 plugins download menu
Tip: Plugin locations may differ between OpenATV and OpenPLI images.
2

Add Xtream Playlist

Open plugin → Playlists → Add. Enter Host, Username, Password from your Neo4K welcome email.

JediMaker Xtream playlist configuration
Tip: Double-check the host URL format (http:// or https://).
3

Create Bouquets

Select playlist → Create Bouquets. Choose categories and enable EPG download.

Creating bouquets in JediMaker Xtream
Tip: Enable EPG download and keep auto-update on for best experience.

Reload GUI

If prompted, restart GUI or reboot receiver to see new bouquets in TV list.

Enigma2 GUI reload prompt
Tip: A GUI restart is usually faster than a full reboot.
B

Method B — SSH

Advanced • Command line installation

1

Find IP + SSH in

Get device IP from Menu → Information → About. Use PuTTY/Terminal: ssh root@192.168.x.x

SSH connection to Enigma2 device
Security: Default login is often 'root' with no password. Set one with passwd.
2

Copy command block

Use the specific wget command from your welcome email to download and execute the installation script.

Example command structure:
wget -O /etc/enigma2/iptv.sh "[YOUR-PROVIDER-URL]" && chmod +x /etc/enigma2/iptv.sh && /etc/enigma2/iptv.sh
Important: Use the exact command from your Neo4K welcome email, not the example above.

Script creates bouquets + EPG

The script will create bouquets and EPG data. Restart GUI when prompted.

Tip: Script output will show progress. Any errors are usually permission-related.

Accessing Channels

📺

Press TV or Bouquet button on remote. Neo4K channels appear in category folders.

EPG & Timezone

Set correct timezone in Menu → Setup → System for accurate EPG times.

Audio & Subtitles

Use Audio button for track selection during playback.

Auto-Updates & EPG

♾️

Plugin Auto-Refresh

Most plugins have built-in auto-refresh options. Enable in plugin settings for daily updates.

Manual Cron Example (Read-Only)

For reference only - do not modify without expertise:

0 4 * * * /etc/enigma2/iptv.sh >/dev/null 2>&1

Refreshes at 4 AM daily (example only)

Troubleshooting

Bouquets not showing
  • • Restart GUI (Menu → Standby/Restart → Restart GUI)
  • • Clear old bouquets: delete files in /etc/enigma2/
  • • Ensure playlist was saved correctly in plugin
  • • Check if bouquets.tv file exists and has correct permissions
Login failed
  • • Verify Host/Username/Password exactly as provided
  • • Check server URL scheme (http:// vs https://)
  • • Ensure device has internet connection
  • • Test credentials on another device first
  • • Check if account is active with provider
No EPG data
  • • Enable EPG download in plugin settings
  • • Set correct timezone (Menu → Setup → System)
  • • Force XMLTV update in plugin
  • • Wait 24-48 hours for initial EPG population
  • • Check EPG file permissions in /etc/enigma2/
Stutter/Buffering issues
  • • Use Ethernet connection instead of Wi-Fi
  • • Disable Wi-Fi power saving in network settings
  • • Test with VPN off to rule out ISP throttling
  • • Check device CPU usage during playback
  • • Try different video decoder settings
SSH authentication issues
  • • Set root password with passwd command
  • • Ensure SSH service is enabled (usually port 22)
  • • Check firewall settings on device
  • • Try connecting from same network first
  • • Some images use 'root' and image-specific passwords
Remove/Reset bouquets

Plugin method: Use plugin menu to delete playlists/bouquets

Manual method: Remove files from these locations:

  • /etc/enigma2/bouquets.tv
  • /etc/enigma2/userbouquet.*.tv
  • /etc/enigma2/*.xml (EPG files)

Warning: Always backup files before deletion

Frequently Asked Questions

JediMaker Xtream vs Xtreamity differences?

Both plugins offer similar functionality for Xtream Codes API. JediMaker Xtream is more widely available and frequently updated. Xtreamity offers a different UI and additional features like VOD management. Choose based on availability in your image's feed.

How to remove bouquets safely?

Use the plugin's delete function first. If manual removal is needed, backup the entire /etc/enigma2/ directory before deleting any userbouquet.*.tv files. Always restart GUI after changes to refresh the bouquet list.

Where are bouquets stored?

Main bouquet list: /etc/enigma2/bouquets.tv
Individual bouquets: /etc/enigma2/userbouquet.[name].tv
EPG data: /etc/enigma2/epg.dat and XML files

Can I mix satellite (DVB) + IPTV bouquets?

Yes, absolutely. Enigma2 can manage both satellite DVB-S/S2 channels and IPTV streams in the same bouquet system. You can create mixed bouquets or keep them separate. Use the channel editor to organize them as desired.

Timeshift/recording with IPTV?

Depends on the plugin and stream format. Most IPTV streams support recording if they're in a compatible format (TS streams work best). Use a fast USB 3.0 drive or internal SSD. Some streams may be encrypted or protected against recording.

Audio track issues (AC3/AAC)?

Use the Audio button during playback to change audio tracks. For persistent issues, try Menu → Setup → Audio/Video → Audio → turn off AC3 passthrough. Some streams need specific audio decoder settings in the image.

Which Enigma2 images work best for IPTV?

OpenATV, OpenPLI, and OpenVIX all support IPTV plugins well. OpenATV has the most extensive plugin feeds. OpenPLI is lightweight and stable. Choose based on your device compatibility and preferred interface.