Readme

This is a custom component for the media_player and notify platforms of Home Assistant.

It allows you to remotely control your enigma2 compatible satellite/cable receivers. It also allows you to send notification using the notify component.

You must install OpenWebif from your enigma2 image.

What is working:

Power status and power control: on, off, standby.
Loads all sources from first bouquet.
Loads all sources from specific bouquet.
Information about current channel program (EPG).
Volume regulation (mute, set, step)
Change channel (Selecting from source list or via Right/Left - from remote controller)
Change channel (using channel number)
Current channel and current event
Picon from current channel (default)
Screenshot from current channel
Supports authentication and multiple receivers
Sending notifications to the box (timeout and type of message can be selected) from picon)

Minimum Requirements

Homeassistant 0.88

Tested with OpenWebif versions:

0.2.7
1.3.0

Discussion:

Follow the enigma2 integration discussion on Home Assistant community forum.

Install:

To use the enigma custom component, place the file enigma directory from the root of the repositorie in to the folder ~/.homeassistant/custom_components/ where you have your home assistant installation

The custom components directory is inside your Home Assistant configuration directory.

This is how your custom_components directory should be:

custom_components
├── enigma
│   ├── __init__.py
│   ├── media_player.py
│   └── notify.py

Install with HACS:

Because enigma2 is already a core component of HA, it is not possible to add it to the default HACS store.

However it is possible to add it as a custom repository.

If you are using HACS, go to HACS -> Integrations and click on the 3 dots (top righ corner). Then choose custom repositories, and add this repository url (https://github.com/cinzas/homeassistant-enigma-player), choosing the Integration category.

That's it, and you will be notified by HACS on every release. Just click on upgrade.

Configuration Example:

By Default will load all channels from first bouquet

enigma: 
  devices:
    - host: 192.168.1.20
      port: 80
      name: Gigablue
      timeout: 20
      username: root
      password: your_password
      picon: picon

notify:
  - platform: enigma
    host: 192.168.1.20
    port: 80
    username: root
    password: your_password
    name: gigablue

Configuration Example 2 (using multiple devices and a pre-defined bouquet and icon from screenshot):

To get your bouquet references, open in your browser : http://box.ip/web/getservices

You can find your bouquet reference from as follows:

Example 1:7:1:0:0:0:0:0:0:0:FROM BOUQUET "userbouquet.favourites.tv" ORDER BY bouquet BOUQUET_NAME_HERE

In my case, if I want to load all channels from bouquet Sky Deutschland I have to look for: 1:7:1:0:0:0:0:0:0:0:FROM BOUQUET "userbouquet.dbe1e.tv" ORDER BY bouquet Sky Deutschland

Then copy the entire string, removing the bouquet name from the end

Example, where I want to load all bouques from the Sky Deutschalnd bouquet:

enigma: 
  devices:
    - host: 192.168.1.20
      port: 80
      name: Gigablue
      timeout: 20
      username: root
      password: your_password
      picon: picon
    - host: 192.168.1.21
      port: 80
      name: Dreambox 
      username: root
      password: your_password
      timeout: 20
      bouquet: '1:7:1:0:0:0:0:0:0:0:FROM BOUQUET "userbouquet.dbe1e.tv" ORDER BY bouquet' 
      picon: screenshot

Notifications

To send notification you can use your HA services page (see screenshot below). Choose your service notify.dreambox and add the following service data:

{ "message" : "Test 123",
  "data" : { 
      "displaytime" : "10",
      "messagetype" : "2"
      }
}

Change channel

To change channel you can use your HA services page (see screenshot below). Choose the service media_player.play_media, choose yourt entity media_player.dreambox and add the following service data (media_content_id is you channel number):

{ "entity_id" : "media_player.dreambox",
  "media_content_id" : "5",
  "media_content_type" : "channel"
}

Screenshots

Current channel (example 1)

Current channel (example 2)

Current channel options

Change channel from bouquet list

Call service to send a notification

Call service to change to specified channel number

Contact

joao.amaro@gmail.com

cinzas/homeassistant-enigma-player