What is Enigma2Utility?
There are two version of Enigma2utility. This page is for the MacOsX version. You can find the page from the beta IOS version: here
Enigma 2 Utility is a channel editor for Enigma2 receivers that runs on 64Bit MacOX. You can use it to watch live tv or your recordings from your mac. It also can be used to manage your timers and the media player. It also gives you some control over the receiver.
The tool is provided as is, without warranties or guarantees of any kind". use it at your own risk.
How to install it IPTV configuration Where can I find the program ? First time you launch the program How to use it Receivers info Receivers settings Streaming recordings Watching live TV Timers Editing Timers Access to EPG Control the receiver Control the Media Player Export files Localize the program to your own language FeedbackSimply drag Enigma2Utility to your application folder
To use this program you have to have SFTP enabled on your receiver
To check if it is on, type the following command in a terminal : sftp root@your_receivers_ip
The receiver should answer by asking your password and letting you in
This program stores your password to connect to your receiver in the prefs file in clear. The file is saved in the Local directory path as defined in the preferences. Remember to delete this file if you think it is needed .
If you want to watch live TV or the recordings on your receiver, you have to have VLC installed in your applications folder.
The first time you run the program, fill in the preferences then restart the app.
preferences window :
The program expects IPTV configuration like the following example. You can use #SERVICE 4097, #SERVICE 5001 or #SERVICE 5002.
The parameter number 4 must be a unique channel identifier for your IPTV channel. In this example I use numbers from 0 to 10.
18/06/2023 : version 2.4.5 available
Solved a bug that could result in selecting the wrong channel when making or editing a timer.
18/06/2023 : version 2.4.6 available
Solved a small user interface bug.
29/06/2023 : version 2.4.7 available
Solved a number of bugs that could crash the program when the receiver is off or when it can't be reached on the network.
27/02/2024 : version 2.4.8 available
Updated the SWT library. Solved a bug that could crash the program on non expected EPG data. New Icon
Download latest version: here
Before running the program please check the md5 checksum of the .dmg file. It should be : 68eb368a362c42d3618fee36169abda2
The first time you try to run it you will see this message.
You have to click on Open.
Channel Editor :
This program allows to download your channel lists from your receivers, change the channels order, add new channels to existing bouquet and send back the lists to your receiver. It is also possible to create, rename and delete bouquet for Tv or Radio.
All the changes you make on the channel lists are first made only in memory. When you use the "Save changes locally" command, the configuration files are updated on your computers working directory. You then need to use the "upload changes to receiver" command to send the changes to your receiver.
1- Edit the preferences to put the settings to contact your receiver
2- use the download from receiver command to download the settings from your receiver
3- use the show user lists command to show the lists available, if you click on a list you can see it's content
4- use the show main channel list command to show all the channels available on your receiver
5- You can use drag drop to add new channels to your lists and to change the order of the channels in the list
6- The main channel list can show only TV, only Radio or both according to the checkboxes.
7- when ready use the save changes locally to store your change
8- Use the upload changes to receiver to send your changes back to your receiver
This program has some support of sub-bouqet and alternates in the Channels Tab. It does not support them in the rest of the program. I will not be able to add support for sub bouquets and alternates in other parts of the program as long as the OpenWebif web API in Enigma2 doesn't support them.
This program has only been tested with a receiver running OpenATV 6.4. I will expand support to other receivers when possible.
You can download the program icons from your receiver using the appropriate command in the editor menu.
The PICON directory in the preferences window has to be set first to where the program icons are stored on your receiver.
After restating the program, the channel lists include the program icons.
You can add a new bouquet using the New TV bouquet command in the editor menu.
To rename the bouquet, select it and press the return key.
When you have finished, click somewhere else on the list with the mouse.
It is also possible to delete an existing bouquet. To do it you have to use the "delete bouquet" command in the "Editor" menu. Deleted bouquet files, are taged with the ".del" extension. They are not uploaded to the receiver.
You can add a new IPTV channel to your bouquet by clicking on the Add IPTV channel button.
Put the program on the Settings tab. You can now use the Receivers info command in the info menu.
Put the program on the Settings tab. You can now use the Receivers settings command in the info menu.
From the Watch recordings tab you have access to the recordings stored on your receiver. Simply select the file and click on the Play File button to watch the file. If you click on a file you can see the description and file length and tags if available. You can delete a recording by clicking on the delete button.
You can edit the recording's name and the tags linked to the recording.
Select one of your bouquet and click on the Watch TV button. VLC will open on the first channel from the bouquet. To change channel simply click on the playlist button in VLC.
You can select another channel in VLC's playlist.
In this tab you have access to the timers on your receiver. You can add a new one, delete an existing timer or change an existing one.
To edit a timer double click on it. To add a new timer click on the button Add new timer. You can choose the disk where you want to record to. To delete a timer, select it and click on the Delete Timer button.
To access the Electronic Program Guide, first select the bouquet then select the channel. To see the EPG it has to be broadcast by the channel. May not work for IPTV.
Mode one: see the full EPG for a Channel
The button watch on TV lets you change the channel on the TV to the program you have selected.
Mode two: see what's now and next on all the channels of a bouquet.
You can Wake up you receiver, put it in standby, put it in deep Standby, rebbot it or reboot only enigma2. You can also send messages to the TV Screen.
You can make an instant recording of the channel shown on your TV. You can record only the current program or make an unlimited recording. You can also change the sound level going to the TV, choose the audio track being used and put the sound on mute.
It is also possible to make changes to the list of tags of your receiver.
You can create an enigma2 location for your media player files to be able to access them in the watch recording tab
You can Load an existing Play List and start the media player. This must be an existing file ending with .e2pls like test.e2pls and it must exist in the appropriate directory, usually it is /etc/enigma2/playlist/
You can Play the play list, pause, stop, play the next file, play the previous file, Shuffle the files, clear or exit the media player.
If you click on the refresh button, it shows you the files that are in the media player directory on the receiver. You can drag drop a file on the list to add it to the receiver.
You can select a number of recordings on your receiver and download them to your computer. The programm creates an Enigma2Utility folder in the Movies folder you have in your home directory and saves your downloads in it. It is then easy to transfert the file on other devices like Phones or Ipads.
If you click on Cancel or on the dialogs red cross while the program downloads a file it will finish to download the file that it is currently downloading but will not download the other remaining ones.
If you ask to quit the Enigma2utility program while it is downloading, it will finish the remaining downloads before quitting the program.
The program will select the language according to the language set on your MacOSX. English and French are included in Enigma2utility. It will default to English if the language used in the Finder is not available in Enigma2utility. It is easy to add another language in the program.
1- select Enigma2utility in the Finder and use the right-click to open the package.
2- open the contents/app directory
3- make a copy of the "LocalizationBundle.properties" file in the same directory. Give it a name according to he language you want to use. For example you can use "LocalizationBundle_de.properties" for German or "LocalizationBundle_es.properties" for Spanish
4- Open your new file. For each line of the file you have to translate everything that is on the right of the "=" sign. Try to keep a translation that has about the same length as the sentence in English.
5- Save the changes and start Enigma2Utility.
If you would like to give me feedback or do some bug reports about this program please use this forum using French or English.