English user manual
- Editions and labels
- Program activation (PRIVE)
- Startup and configuration
- Main window
- Enigma2
- IPTV and M3U
- IPTV movies and series
- EPG
- Recording and timeshift
- Playback and video modes
- TV mode and phone remote
- DLNA, Chromecast and M3U TV
- Tools
- Settings
- Files, logos and picons
- Keyboard shortcuts
- Troubleshooting
- What is new in PRIVE
1. Editions and feature labels
| Edition | Reference version | Scope |
|---|---|---|
| Standard / no PRO | v3.63 | Enigma2 and IPTV playback, M3U, EPG, remote control, casting, PiP, audio/subtitle tracks and core tools. |
| PRO | v4.03 | Adds recording, Enigma2 reconnect, advanced settings, IPTV movies/series, TMDb, PL/EN language and two visual themes. |
| ULTRA | v4.14 AUTO | Adds automatic GPU/CPU selection, timeshift, recording library, picons, signal meter, IPTV reconnect, local logos and stability fixes. |
| PRIVE TV | v4.38 | Contains everything from ULTRA and adds license activation, COMPATIBILITY video mode, per-computer device profiles, an SQLite database, IPTV provider profiles with alternate sources, separate Enigma2 and IPTV EPG guides, advanced recording rules, a tuner panel, TV mode, a phone remote, a tray icon and a configurable toolbar. |
How PRIVE differs from ULTRA PRIVE ONLY
- Mandatory per-computer license activation before the main GUI starts.
- COMPATIBILITY video mode for machines where Enigma2 produced audio without video.
- A settings profile stored separately for each computer, plus a compatibility wizard.
- An SQLite database
hpl_media.dbfor M3U playlists, EPG, history and provider profiles. - IPTV provider profiles, alternate channel sources and automatic failover.
- Separate full-size Enigma2 EPG and IPTV EPG guides instead of the Bouquet EPG window.
- Automatic EPG recording rules, an Enigma2 tuner panel and Windows 11 notifications.
- Full-screen TV mode and a remote control operated from a phone browser.
- A system tray icon, a configurable toolbar and responsive, wrapping command bars.
- A redesigned IPTV player and Enigma2 VIDEO/Cinema modes sharing the same HUD layout.
2. Program activation PRIVE ONLY
The PRIVE TV edition requires a license activated for one specific computer. Until a valid activation code is entered, the main window does not start — only the Program activation required dialog appears. This dialog is in English.
Step by step
hplink.soft@proton.me.HPL ink Enigma2+ IPTV PRIVE TV v4.38.A successful activation shows Activation completed. The program will start normally. and the program continues to its normal startup. Later sessions do not repeat the activation.
License scope
- A license can be perpetual or valid until a given date. After it expires, the activation window appears again.
Other editions of the program: hplspam1-jpg.github.io/HPL-ink-Software
3. Startup and initial configuration
Requirements
- 64-bit Windows 11.
- An Enigma2 receiver with OpenWebif enabled, on the same network as the PC.
- An M3U/M3U8 playlist when IPTV is required.
- 64-bit VLC when the external VLC button or functions requesting its location are used.
- A TMDb API key for movie/series details and posters. PRO + ULTRA Create or sign in to a TMDb account, open Account settings → API on a desktop browser, accept the terms and request a developer key. Official guide: TMDb Getting Started.
Portable operation
- Extract the complete program folder. Do not move the EXE away from its libraries and subfolders.
- Run
HplEnigma2IptvWinUI.exe. - If the application folder is writable, data is stored next to the EXE. Otherwise, the program uses
%LocalAppData%\HplEnigma2Iptv. - In PRIVE, Tools → Portable data manager reports the current mode, the data folder and the SQLite database size, and exports or imports the complete data set. PRIVE ONLY
Connecting to Enigma2
Locate VLC selects the VLC executable. VLC opens the current stream in the external player and is useful for diagnostics.
4. Main window
The following drawing is a privacy-safe UI diagram. It contains no IP address, login or user-specific path.
ENIGMA 2
Bouquets / folders
• Channels in bouquet
IPTV
M3U groups
• IPTV channels
PLAYBACK
The third button row, the status bar and the Enigma2 EPG, IPTV EPG and Recordings buttons belong to the PRIVE edition. PRIVE ONLY
- Always on top keeps application windows above other windows.
- Favourites, Recent, History open stored playback entries.
- Receivers manages saved Enigma2 devices.
- Shortcuts displays and edits keyboard bindings.
- Tools opens diagnostics and additional functions.
- Settings opens advanced configuration. PRO + ULTRA
Command bar in PRIVE PRIVE ONLY
PRIVE arranges the buttons in several rows that wrap automatically as the window width changes. The row starting with Always on top and the last row starting with VIDEO are right-aligned, while the volume row is left-aligned. The alignment is preserved after wrapping.
Bouquet EPG has been replaced by two separate buttons, Enigma2 EPG and IPTV EPG. Recordings, Timeshift, IPTV Movies and IPTV Series were added as well.
Configurable toolbar
Select Tools → Configurable toolbar. The window lists every command with a check box; cleared commands disappear from the bar. Show all restores the full set, and the new layout is applied after the program is restarted.
Commands that can be hidden: Always on top, Favourites, Recent, History, Receivers, Shortcuts, Tools, Settings, Save, Bouquets, M3U, EPG XML, Download EPG, M3U TV, DLNA, Chromecast, Remote, Enigma2 EPG, IPTV EPG, Search, PiP, M3U editor, Recordings, Tracks, Audio, Video, Cinema, Record, Stop, Timeshift, IPTV Movies, IPTV Series.
Status bar PRIVE ONLY
The bottom of the window shows E2, Internet, VLC, EPG and M3U indicators. Colour reflects the state of each item, and the EPG indicator additionally distinguishes current, expiring, expired and unconfigured data.
System tray icon PRIVE ONLY
The program adds an icon to the Windows notification area. Its context menu offers Show program, Restore all windows, Stop playback and Close program. Windows are restored onto the virtual desktop currently in use.
GUI scale and computer profile PRIVE ONLY
Window size, interface scale, decoding mode, network profile, buffer and startup volume are stored separately for each computer under This computer profile in Settings, and take effect after a restart. The default window width is 1700 pixels and the Enigma2 and IPTV columns share the same width.
5. Enigma2
Loading and playing channels
- Complete the connection fields and select Save.
- Select Bouquets. Red bold entries represent bouquets/folders.
- Select a bouquet and double-click a channel.
- Current and next EPG appears below the video when the receiver supplies it.
The channel context menu provides Play, Add to favourites, Show EPG and Copy URL. The bouquet context menu loads the bouquet or copies its service reference.
Remote control
Remote opens the virtual Enigma2 remote, including navigation, number, media and REC keys. Commands are sent through OpenWebif.
Enigma2 reconnect PRO + ULTRA
After a stream failure, the program attempts to resume playback. Manual Stop prevents reconnect for the stopped channel. The function can be disabled in Settings.
Channel picons ULTRA ONLY
Picons appear in the E2 list and above the player. They can be placed in Picon\Enigma2 next to the EXE or downloaded from the receiver with Picon manager.
Signal strength ULTRA ONLY
Select Tools → Signal strength. The window shows SNR, SNR dB, AGC, BER and lock state for the current E2 service, refreshing every two seconds.
EPG in the channel list PRIVE ONLY
The Enigma2 channel list shows the current programme title in neon green. Data is fetched for the whole bouquet once it is selected and refreshed automatically every 60 seconds.
Enigma2 tuner panel PRIVE ONLY
Select Tools → Enigma2 tuner panel. The window reports receiver tuner status with the time of the last update and a Refresh button. If the receiver exposes no tuner data, a message is displayed instead.
COMPATIBILITY mode PRIVE ONLY
COMPATIBILITY is intended for computers where Enigma2 produced audio without video. The picture is then rendered in a native VLC window (HWND) with software decoding, bypassing the WinUI VideoView and Direct3D11 path.
- AUTO (GPU → COMPATIBILITY) starts with GPU and switches the machine to compatibility mode when no frames are displayed.
- The working mode is stored in the computer profile and reused on later startups.
- In the normal GUI view the native video window is clipped to the EPG panel and does not cover it. VIDEO and Cinema modes use the full player area.
- Tools → Playback parameters reports which path is actually rendering the picture.
6. IPTV and M3U playlists
Loading a playlist
- Select M3U and open an
.m3uor.m3u8file. - Groups appear in the IPTV panel. All displays all live TV channels.
- Select a group and double-click a channel.
- IPTV opens in a separate window and can run concurrently with Enigma2.
M3U editor
M3U Ed. edits channel name, group, URL and logo. Auto logo assigns available graphics. PRO and ULTRA can rebuild the editable list from the currently loaded playlist. PRO + ULTRA
Custom group order PRO + ULTRA
Right-click a group and choose Move up or Move down. All remains pinned at the top.
IPTV player
The window includes Pause/Play, Stop, Video, Cinema, volume control, current EPG and a channel logo when available. Closing IPTV does not close the main program.
IPTV reconnect ULTRA ONLY
Live channels receive up to three reconnect attempts at five-second intervals. VOD movies and series are not restarted after their natural end.
IPTV provider profiles PRIVE ONLY
Select Tools → IPTV provider profiles. A profile pairs an M3U playlist with its EPG file, so switching providers no longer requires picking files again.
- Add — create a profile and give it a name.
- Add M3U — select the playlist for this profile.
- Select EPG — assign the EPG file or address.
- Set active — mark the profile as the default one.
- Load profile — immediately load the channels and EPG of the selected profile.
Profiles, M3U channels, EPG and history are kept in the SQLite database hpl_media.db, which speeds up loading of large playlists.
Alternate channel sources PRIVE ONLY
Right-click an IPTV channel and choose Alternate sources. A channel can hold several backup addresses, each with its own name and priority.
- Add stores a new source; an invalid URL is rejected with a message.
- Play selected starts a chosen source manually.
- A watchdog detects missing video or stalled data and switches the channel to the next source by priority.
- After a switch the player shows the Alternate source status without changing the channel name. When nothing responds, the status becomes No working source.
Channel logos PRIVE ONLY
An IPTV channel logo is selected in this order: EPG/XMLTV icon → tvg-logo from the M3U playlist → local logo folder. The order applies both to the channel list and to the playback window. EPG shown next to M3U channels uses neon blue #00d4ff.
IPTV player in PRIVE PRIVE ONLY
The IPTV window uses a black HUD drawn over the picture. The top area shows the logo, channel name, playback state and a clock; the bottom area shows NOW ON AIR and UP NEXT EPG, a progress bar and the full control set. The HUD hides three seconds after playback starts and returns on mouse movement.
| Control | Function |
|---|---|
| Pause / Play | Pauses and resumes playback. Space. |
| Back / Forward 15 s | Seeks within VOD items. ← and →. |
| Stop, Restart | Stops the stream or reconnects it. |
| Volume, Mute | Volume slider, mute button and mouse-wheel control. |
| Aspect | Automatic, 16:9, 4:3, Fit and Fill. |
| A/V | Selects audio and subtitle tracks directly for items played through LibVLC. |
| Technical information | Engine, state, resolution, codec, bitrate, buffer, available tracks and current position. |
| Video, Cinema | Enlarged picture and full screen. F11 and Esc. |
- Double-clicking the picture toggles full screen, and the cursor hides after two idle seconds in cinema mode.
- VOD positions are stored; reopening an item offers From start or resume.
- The IPTV window size and position are remembered per computer.
- The Always on top option covers the IPTV window as well.
- In the Black theme every surface of the window uses
#000000.
7. IPTV Movies and IPTV Series PRO + ULTRA
Requirements
- The M3U playlist should identify media through paths or metadata such as
/movie/and/series/. - Enter a TMDb API key in Settings.
- The provider account must allow the selected movie or episode to play.
IPTV Movies
- Load M3U and select IPTV Movies.
- Open a movie folder to display the poster wall and search box.
- Select Download posters to cache missing images.
- Open a movie to see poster, year, rating, director and overview, then select Play.
IPTV Series
Items are organised as series → season → episode. Select an episode and start playback.
Resume VOD ULTRA ONLY
ULTRA stores the position of movies, series and local recordings. The next session can continue or use Start over.
Changes in PRIVE PRIVE ONLY
- IPTV Series opens at the first folder level of the playlist, like IPTV Movies: folders → series → seasons → episodes.
- The poster wall covers all movies and offers year filtering, sorting and tile density control.
- Posters are taken from the playlist
tvg-logofield first; a missing or broken link automatically falls back to the local cache or TMDb. - The VOD library provides watched / unwatched / To watch filters and manual correction of the TMDb query.
8. EPG
EPG XML
EPG XML loads a local XMLTV file. Gzip-compressed data is also supported. Entries are matched to IPTV channel names.
Download EPG
Download EPG opens the download window. Enter the source address and destination, normally epg.xml. “Valid until” reflects the actual final programme in the data.
Bouquet EPG
Select an Enigma2 bouquet first, then Bouquet EPG. The window displays programmes for channels in that bouquet.
Enigma2 EPG and IPTV EPG guides PRIVE ONLY
Both windows share the same layout, open at the size of the main GUI on the right-hand side of the desktop and use fonts one step larger.
- The left column lists Bouquets (Enigma2) or Groups (IPTV). The memory-heavy “All” entry has been removed.
- Each channel shows its picon, list position, NOW and NEXT programmes, a description and a progress bar. Current programme times are displayed in neon yellow.
- The Search channel box filters by part of the name and the favourites only switch limits the view to favourites.
- ◀ earlier, ▶ NOW and later ▶ shift the timeline.
- Selecting a channel opens Channel EPG with the full schedule and programme descriptions.
- Play starts the channel using the rules of its source. Record is available in the Enigma2 guide only.
EPG source profiles PRIVE ONLY
The Download EPG window has been extended into EPG sources and mapping. Select a ready Source profile or enter a Custom URL (.xml / .gz) and use Download and validate.
- A new file is parsed and checked before it replaces a working
epg.xml. - When a source fails, the program moves on to the next backup source in the profile.
- EPG validity is calculated from actual programme dates and channel coverage. The status distinguishes current, expiring, expired and unconfigured data.
- Expired EPG is downloaded automatically when a URL has been saved.
- XMLTV time zones, including
+HHMMoffsets and UTC, are supported, as are gzip files regardless of their extension.
EPG mapping report PRIVE ONLY
Mapping report opens the M3U-to-XMLTV channel matching overview. The program uses tvg-id, tvg-name, aliases and cautious similar-name matching in that order, and caches the result in epg_mapping.json. The report lists matched, ambiguous and missing entries, with Rebuild mapping and Copy report available.
Record from EPG PRO + ULTRA
Use Record for the selected programme. Depending on the command and window, the program creates an Enigma2 timer or starts a local recording.
EPG reminders PRO + ULTRA
Enable reminders in Settings, select 5-15 minutes, optionally restrict to Favourites and enter comma-separated keywords.
9. Recording and timeshift
Record and recording schedule PRO + ULTRA
Record saves the current Enigma2 stream in Recorded next to the EXE. Press Record again or Stop to finish. The schedule window reads Enigma2 timers and requires receiver confirmation when deleting one.
Recording library ULTRA ONLY
Tools → Recording library lists TS, MP4, MKV and AVI files in Recorded. It supports playback, rename, delete, size and date information.
Recording monitor ULTRA ONLY
Displays elapsed time, file size, write speed and free disk space.
Timeshift ULTRA ONLY
- Start an Enigma2 channel and select Timeshift.
- The live stream is buffered to a temporary file.
- Pause and seek within the available buffer.
- Return to LIVE or stop timeshift. The temporary file is removed.
Advanced EPG recording PRIVE ONLY
Select Tools → Advanced EPG recording. The window defines rules that search the EPG on their own and schedule recordings on the receiver.
- Rule name — any description that identifies the rule in the list.
- Title keyword or phrase — a required field compared against programme titles.
- Channel (optional) — restricts the rule to a single channel.
- Lead margin (min) and Tail margin (min) — extra recording time before and after the programme.
- Rule enabled — includes the rule in scanning.
- Do not record the same title again — skips repeats already scheduled or recorded.
- Save rule, then Scan EPG and schedule.
After scanning, a report lists Matched programmes, Added to schedule, Skipped as duplicates and Errors. Receiver schedule opens the Enigma2 timer list. Scanning requires an enabled rule and a loaded Enigma2 bouquet.
Notifications and recording protection PRIVE ONLY
- Windows 11 notifications report the start and end of a recording. They can be disabled in Settings.
- Recording checks free disk space and shows the projected file size.
- Closing the program during a local recording requires confirmation and warns that receiver timers may keep recording.
10. Playback and video modes
VIDEO
In the main window, VIDEO enlarges the Enigma2 video area and hides control panels. ULTRA requires an active E2 channel and displays a message otherwise. ULTRA ONLY: no-source guard
Cinema / F11
Enters full screen. Esc returns to the GUI and restores the default window size.
PiP
Opens a small MiniPlayer window. Closing PiP does not close the application.
Tracks
Displays VLC audio and subtitle tracks available for the current item. The active track is highlighted.
Audio
Audio-only mode hides video while keeping sound, for example for radio services.
Stop
Stops Enigma2 in the main window. Stop in IPTV affects only the IPTV window. In PRIVE, stopping runs off the UI thread with a timeout, so a stalled player cannot block the program — it is detached and a new VLC instance is created.
Video and Cinema modes in PRIVE PRIVE ONLY
The Enigma2 VIDEO and Cinema modes match the IPTV window one to one.
- The top HUD shows the picon, channel name, playback state and a clock.
- The bottom HUD shows EPG, a progress bar and the full player control set: Pause, 15-second seek, Stop, Restart, Mute, volume, aspect ratio, A/V and technical information.
- The OSD hides after three idle seconds and returns on cursor movement — including over the native VLC surface in COMPATIBILITY mode.
- The picture scales with the window, and the former Enigma2 bar and GUI status bar are hidden in this mode.
- VIDEO and Cinema require an active Enigma2 channel; without a source the program shows a message and keeps the full GUI.
11. TV mode and phone remote PRIVE ONLY
TV mode
Select Tools → TV mode. The picture plays directly in a full-screen VLC window, while the channel list and controls act as an overlay.
- The mode starts the current channel as soon as it opens.
- The overlay provides a Search channels box, a Channels list and the Play and Hide buttons.
- A separate button shows or hides the whole control overlay.
- The mode closes automatically when Video or Cinema is selected, playback is stopped, or another channel is started in the main window.
Phone remote
Select Tools → Phone remote. The program starts a local HTTP server on the LAN so a phone browser can act as a remote control.
- Set the Port and select Start.
- The window shows the page address and a locally generated QR code. Copy address places the address on the clipboard.
- Open the address on the phone and enter the PIN.
- Authorisation is kept in a random, expiring HTTP-only session, so the PIN is not requested for every command.
12. Canal+ Online, DLNA, Chromecast and M3U TV
Canal+ Online and Polsat Box
Opens the integrated HPL Streaming module. Run opens operator pages in the original Microsoft Edge browser and displays My List. Authentication takes place on the operator website.
DLNA
Select DLNA, set the search duration and choose Search devices. VPN, Wi-Fi client isolation and firewall rules can block SSDP discovery.
Chromecast
Select Chromecast, the target device and source. The IPTV context menu also provides Send to Chromecast. The receiving device must be able to reach the source URL.
M3U TV
Starts a local HTTP server for the loaded playlist. Load M3U first. The window shows server URL, status and request count.
13. Tools
The Tools button opens a selection list. Highlight an entry and select Open. The table below follows the order used in PRIVE and shows availability in the other editions.
| Tool | Standard | PRO | ULTRA | PRIVE |
|---|---|---|---|---|
| Global E2 + IPTV search | ✓ | ✓ | ✓ | ✓ |
| Connection diagnostics | ✓ | ✓ | ✓ | ✓ |
| Computer compatibility wizard | - | - | - | ✓ |
| Playback parameters | - | - | - | ✓ |
| Signal strength | - | - | ✓ | ✓ |
| Enigma2 tuner panel | - | - | - | ✓ |
| Advanced EPG recording | - | - | - | ✓ |
| Recording library and monitor | - | - | ✓ | ✓ |
| TV mode | - | - | - | ✓ |
| Phone remote | - | - | - | ✓ |
| IPTV provider profiles | - | - | - | ✓ |
| Picon manager | - | - | ✓ | ✓ |
| Portable data manager | - | - | - | ✓ |
| Configurable toolbar | - | - | - | ✓ |
| Encrypted profile / backup | - | ✓ | ✓ | ✓ |
| Legacy JSON profile | ✓ | ✓ | ✓ | ✓ |
Connection diagnostics
Shows the portable data directory, receiver IP, ports, VLC, EPG state, M3U server and an OpenWebif test. The password is not displayed.
Enigma2 and playback diagnostics PRIVE ONLY
Run full test checks the network, OpenWebif, LibVLC, video and audio. The result includes the graphics adapter, driver version, active decoding mode and the actual video output path.
- Apply recommended profile stores the recommended GPU/CPU/COMPATIBILITY mode and buffer size for this computer and switches the active path immediately.
- Create ZIP bundle saves a privacy-safe diagnostic package.
Computer compatibility wizard PRIVE ONLY
The wizard analyses the computer and reports Recommended decoding, Recommended buffer and Recommended GUI scale. Apply recommendations stores them in this computer's profile and Run again repeats the analysis.
Playback parameters PRIVE ONLY
A live panel reports channel, source, engine, state, decoding mode, video output, resolution, codec, buffer, displayed and lost frames, decoded and lost audio, and the number of audio and subtitle tracks.
Portable data manager PRIVE ONLY
The window reports the operating mode (portable — data next to EXE or LocalAppData — EXE folder is read-only), the program folder, the data folder, the SQLite database path and size, and every data file. Open data folder, Export data, Import data and Refresh are available. Restart the program after an import.
Profiles and backup
An encrypted profile protects its data with a password. Legacy JSON may contain the receiver password in plain text and must be stored carefully.
14. Settings - every option from top to bottom PRO + ULTRA
Select Settings in the upper-right corner. The controls appear in the following order from the top. Scroll vertically and select Save settings when finished.
- Language and theme.
- Interface language - select Polski (PL) or English (EN). Restart the program to apply it.
- GUI theme - Black (classic) or Futuristic HUD. Restart to apply the new appearance.
- This computer profile. PRIVE ONLY
- Automatically apply device profile - the program uses the settings stored for this specific computer at startup.
- Decoding for this computer - AUTO (GPU → COMPATIBILITY), GPU, CPU or COMPATIBILITY.
- Network profile and Playback buffer (ms) - transport settings for this computer.
- GUI scale, Window width and Window height - interface size and scale; they take effect after a restart.
- Startup volume - the audio level applied when the program starts.
- Startup profile.
- Auto-connect to receiver - automatically uses the active Enigma2 receiver after startup.
- Play last channel - attempts to resume the most recently watched item.
- Restore last session and open tools - restores the Video mode, volume and tool windows from the previous session. PRIVE ONLY
- Window at startup - None, Streaming Canal+/Polsat, Remote control or Download EPG.
- Network quality preset - LAN uses the smallest buffer, WiFi a medium buffer and Mobile the largest, safest buffer for weaker connections.
- Network/live buffer (ms) - range 150-10000 ms. A larger value usually reduces interruptions but increases startup time and live delay.
- Automatically adapt buffer to stream quality - enables the adaptive buffer. Minimum buffer (ms) and Maximum buffer (ms) set the range and Current buffer shows the value in use. PRIVE ONLY
- EPG reminders.
- Enabled - turns programme reminders on.
- Minutes before the programme - select 5 to 15 minutes.
- Favourites only - limits reminders to favourite channels.
- EPG keywords - enter comma-separated phrases, for example
movie, match, news. The programme title and channel name are checked.
- Automatic updates. PRIVE ONLY
- Enable automatic background refresh - a scheduler refreshes data without user interaction.
- Interval (minutes) - how often the refresh runs.
- Refresh scope: EPG XMLTV, M3U playlist from the last selected file, Enigma2 bouquets and Missing Enigma2 picons.
- The refresh uses only previously saved sources and never opens file picker windows.
- Cache storage. PRIVE ONLY
- Automatically clean cache once a day - enables daily housekeeping of temporary data.
- Poster limit (MB) - maximum size of the IPTV Movies / Series poster cache.
- Diagnostic bundle limit (MB) - maximum size of the ZIP bundle folder.
- Log retention (days) - after how many days logs are removed.
- Clean now - immediate housekeeping; the program reports the number of deleted files.
- Playback and notifications. PRIVE ONLY
- Windows 11 notifications - system messages about recordings and playback events.
- Parental lock.
- Enabled - activates access control.
- New PIN - enter at least four digits and select Set PIN.
- Locked M3U groups - enter exact IPTV group names separated by commas.
- Locked Enigma2 bouquets - enter exact E2 bouquet names separated by commas.
- Backup.
- Backup .hplbackup - enter a password of at least four characters and choose where to save the encrypted configuration backup.
- Restore backup - enter the password and select an
.hplbackupfile. A wrong password or damaged file displays an error instead of closing the program.
- Other.
- Enigma2 video decoding - Auto, GPU or CPU. AUTO starts with GPU and switches the machine to CPU when audio is detected without video. ULTRA ONLY PRIVE adds the COMPATIBILITY mode and renames the automatic entry to AUTO (GPU → COMPATIBILITY). PRIVE ONLY
- Reset saved AUTO choice - removes the GPU/CPU decision stored for this PC so detection runs again. ULTRA ONLY
- Audio-only mode (radio) - disables video and keeps audio.
- Automatic Enigma2 reconnect - attempts to restart the current channel after a stream failure.
- Automatic IPTV reconnect - up to three attempts every five seconds for live channels; VOD is excluded. ULTRA ONLY
- TMDb API key - paste the v3 API key used by IPTV Movies/Series for details and posters. To obtain one, create or sign in to an account, open TMDb → Settings → API in a desktop browser, accept the terms and complete the short developer application. See the official TMDb guide. PRO + ULTRA
- Enigma2 picon folder (FTP) - enter the remote path, for example
/media/usb/pICON. ULTRA ONLY - Receiver FTP port - normally 21; change it only if the receiver FTP server uses another port. ULTRA ONLY
- Timeshift buffer folder - choose a fast drive with plenty of free space. An empty field uses the default application data folder. ULTRA ONLY
- Local channel logo folder - select a folder containing files named exactly like IPTV channels. ULTRA ONLY
- Save settings. The bottom button stores all changes and closes the window. Language and theme changes require a program restart.
15. Program files, logos and picons
Data directory
Portable mode stores data next to the EXE. When that folder is not writable, the program uses %LocalAppData%\HplEnigma2Iptv.
| File/folder | Purpose |
|---|---|
config.json | Enigma2 connection and VLC path; the password is protected. |
app_settings.json | Advanced settings, receivers, shortcuts and preferences. |
m3u_channels.json | M3U editor changes. ULTRA v4.13+ ONLY |
favorites_e2.json, history.json, last_played.json | Favourites and playback history. |
epg.xml, epg_info.json | EPG data and metadata. |
Recorded | Local Enigma2 recordings. PRO + ULTRA |
Posters\Movies | Poster cache in M3U group subfolders. PRO + ULTRA |
Picon\Enigma2 | Local E2 picons. ULTRA ONLY |
hpl_media.db | SQLite database: M3U channels, EPG, history, IPTV provider profiles and alternate sources. PRIVE ONLY |
epg_sources.json, epg_mapping.json | EPG source profiles and the M3U-to-XMLTV matching cache. PRIVE ONLY |
session_state.json | Last session and the list of open tool windows. PRIVE ONLY |
vod_library.json, vod_progress.json | VOD library and stored playback positions. PRIVE ONLY |
Diagnostics | Diagnostic ZIP bundles and logs. PRIVE ONLY |
Timeshift | Timeshift buffer when no custom folder is selected. ULTRA ONLY |
Sounds | Spoken status messages used by the program. |
Local channel logo folder ULTRA ONLY
A file name must match the channel, for example TVP 1 HD.png. Supported formats are PNG, JPG, JPEG, WEBP and ICO. Priority: M3U tvg-logo → EPG icon → local folder.
Picon names ULTRA ONLY
The file name is the E2 service reference with colons replaced by underscores, for example 1_0_19_290E_1EDC_71_820000_0_0_0.png. PNG, JPG and JPEG are supported.
16. Keyboard shortcuts
| Default key | Action |
|---|---|
| F11 | Cinema mode |
| M | Mute |
| Ctrl+V | Video mode |
| Ctrl+F | Global search |
| Ctrl+P | MiniPlayer PiP |
| Ctrl+A | Audio-only mode |
| Ctrl+R | Recently watched |
| S | Stop playback |
| Esc | Return from Video/Cinema to the GUI |
The Shortcuts window lets the user select an action, enter a new binding and save it. ULTRA and PRIVE do not trigger global bindings while a text input has focus.
Playback window keys PRIVE ONLY
| Key | Function in the IPTV window and in VIDEO/Cinema mode |
|---|---|
| Space | Pause / resume |
| ← / → | Seek 15 seconds (VOD items) |
| F11 | Full screen |
| Esc | Return to the window or to the GUI |
| Mouse wheel | Volume control |
| Double click | Toggle full screen |
17. Troubleshooting
Bouquets and EPG work, but Enigma2 has audio only
- Test the same stream with the VLC button.
- Check the stream port, usually 8001, and WEB port, usually 80.
- In PRO, use the alternative GPU/CPU build. PRO
- In ULTRA, select AUTO or CPU decoding and reset the saved AUTO choice. ULTRA ONLY
- In PRIVE, select the COMPATIBILITY mode or run Tools → Computer compatibility wizard and choose Apply recommendations. PRIVE ONLY
- Select a larger buffer preset when sound or video is interrupted.
Live IPTV works, but a movie does not
Test the URL in VLC, verify account validity and concurrent connection limits. VOD uses LibVLC while live channels may use another playback engine.
Posters are missing
Check the TMDb key, internet connection and cleaned title. Open the movie folder and select Download posters.
DLNA or Chromecast is not found
The PC and device must be on the same network. Temporarily disable VPN, check Wi-Fi client isolation and allow private-network firewall access.
Temporary directory warning
“Failed to remove temporary directory” usually comes from an installer or updater. Close processes using TEMP, restart Windows and delete only the specified unused temporary folder.
Settings are not stored next to the EXE
Move the program to a user-writable folder or check %LocalAppData%\HplEnigma2Iptv. In PRIVE, Tools → Portable data manager reports the current mode.
The program asks for activation again PRIVE ONLY
- Registry and temporary-file cleaners can delete the license data.
- Send a new request code to the address shown in the activation window.
An IPTV channel switches to another source PRIVE ONLY
The Alternate source status means the watchdog detected missing video or stalled data and moved to a backup source. Edit the list and priorities from the channel context menu → Alternate sources. No working source means no address responded.
EPG does not match IPTV channels PRIVE ONLY
Open Download EPG → Mapping report. Review the ambiguous and missing entries, correct channel names in the M3U editor or add an alias, then select Rebuild mapping.
18. What is new in PRIVE PRIVE ONLY
A summary of the changes introduced after ULTRA v4.14 that were not covered by the previous manual.
| Version | Key changes |
|---|---|
| v4.38 | Mandatory license activation before the main GUI starts, a separate product identifier. |
| v4.35 - v4.37 | Enigma2 Video and Cinema modes matching the IPTV window one to one: top and bottom HUD, automatic OSD hiding, picture scaling. IPTV watchdog and failover to backup sources. Neon yellow programme times across EPG views. TV mode closing on playback changes. |
| v4.33 | Removal of the “All” entry from the EPG guides, guide windows at GUI size, full-screen TV mode, phone remote with a PIN session and QR code, shutdown protection during recording, EPG rule reports. |
| v4.32 | Separate Enigma2 EPG and IPTV EPG guides with groups, picons, Now/Next, search, favourites filter and recording for Enigma2 only. |
| v4.30 - v4.31 | Compatibility wizard, central playback controller, adaptive buffer, SQLite database, IPTV provider profiles, advanced EPG recording rules, tuner panel, Windows 11 notifications, portable data manager, responsive GUI and configurable toolbar. |
| v4.28 - v4.29 | Source order for IPTV channel logos and IPTV Movies posters based on tvg-logo with a cache/TMDb fallback. |
| v4.23 - v4.27 | COMPATIBILITY mode with a native VLC window, safe playback stopping, video clipping to the EPG panel and extended video diagnostics. |
| v4.20 - v4.22 | EPG source profiles, validation of downloaded files, channel mapping with a report, XMLTV time zone handling, EPG validity status and EPG in the Enigma2 channel list. |
| v4.19 | Tray icon, playback parameter panel, last-session restore, free-space checks before recording, cache and log limits. |
| v4.15 - v4.17 | Enigma2/VLC diagnostics with a recommended profile, device profiles, status bar, global search, background refresh scheduler, redesigned IPTV player with HUD, aspect ratios, track selector and a VOD timeline. |