Enigma2 (Vu+, Dreambox) IPTV Setup
Expert-level IPTV configuration for Enigma2-based satellite receivers.
Table of Contents
Requirements
Security Reminder
Set a root password if default is blank: passwd
. Never leave SSH with empty passwords.
Method A — Plugin
Recommended • JediMaker Xtream / Xtreamity
Install Plugin
Menu → Plugins → Download Plugins (Green Button). Find 'JediMaker Xtream' or 'Xtreamity' in extensions category.

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

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

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

Method B — SSH
Advanced • Command line installation
Find IP + SSH in
Get device IP from Menu → Information → About. Use PuTTY/Terminal: ssh root@192.168.x.x

passwd
.
Copy command block
Use the specific wget command from your welcome email to download and execute the installation script.
wget -O /etc/enigma2/iptv.sh "[YOUR-PROVIDER-URL]" && chmod +x /etc/enigma2/iptv.sh && /etc/enigma2/iptv.sh
Script creates bouquets + EPG
The script will create bouquets and EPG data. Restart GUI when prompted.
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.