README.md

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

[email protected]

License

References