Home Assistant

Enigma2 (OpenWebif)

The enigma2 platform allows you to control a Linux based set-top box which is running Enigma2 with the OpenWebif plugin installed.

OpenWebif is an open source web interface for Enigma2 based set-top boxes.

To add a set-top box to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
media_player:
  - platform: enigma2
    host: IP_ADDRESS

Configuration Variables

Looking for your configuration file?
host string Required

The IP/hostname of the Enigma2 set-top box on your home network.

use_channel_icon boolean (Optional, default: false)

By default, a screen grab of the current channel is shown. If you prefer the channel icon to be shown instead, set this to true.

deep_standby boolean (Optional, default: false)

If set to true, when the user selects Turn Off, the box will go into “deep standby” mode, meaning it can be only awoken by the remote control or via Wake On Lan (if box supports that).

mac_address string (Optional, default: empty)

If specified, a Wake On Lan packet is sent to this MAC address, when Turn On is selected.

source_bouquet string (Optional, default: empty)

Provide a specific bouquet reference for the bouquet you would like to see loaded into the media player “Sources” interface.

port integer (Optional, default: 80)

Port which OpenWebif is listening on.

username string (Optional, default: root)

The username of a user with privileges to access the box. This is only required if you have enabled the setting “Enable HTTP Authentication” in OpenWebif settings. (e.g., on the remote by pressing Menu>Plugins>OpenWebif).

password string (Optional, default: dreambox)

The password for your given account. Again, this is only required if you have enabled the setting “Enable HTTP Authentication” in OpenWebif settings. (e.g., on the remote by pressing Menu>Plugins>OpenWebif).

ssl boolean (Optional, default: false)

Use HTTPS instead of HTTP to connect. This is only required if you have enabled the setting “Enable HTTPS” in OpenWebif settings. (e.g., on the remote by pressing Menu>Plugins>OpenWebif). You will need to ensure you have a valid CA certificate in place or SSL verification will fail with this component.

name string (Optional, default: Enigma2 Media Player)

A name for easy identification of the device.