2025.1.4
Home ▸ Integrations ▸

Enigma2 (OpenWebif)

The Enigma2 integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] 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.

Prerequisites

Your device needs to have the OpenWebif plugin installed. On most devices it is installed by default, if not, it is available via the Plugins menu within your Enigma2 distribution.

Please beware that the OpenWebif setting “Require client cert for HTTPS” is not supported.

Configuration

To add the Enigma2 (OpenWebif) device to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Enigma2 (OpenWebif).

  • Follow the instructions on screen to complete the setup.

Host

The IP address or hostname of your device.

Port

The port number of the OpenWebif service running. (default: 80).

Username

The username, if HTTP(S) authentication is enabled.

Password

The password, if HTTP(S) authentication is enabled.

Uses an SSL certificate

Whether HTTPS is enabled.

Verify SSL certificate

Whether the SSL certificate should be verified.

Configuration options

The integration provides the following configuration options:

Turn off to deep standby

Shuts the device down (called Deep Standby) on turning off the device. Important: When the device is in Deep Standby, it can no longer be reached! Turning on the device is only possible via one of the following methods: Wake on LAN, Power button on the device, or the Remote control.

Bouquet to use as media source

Sets the bouquet to use for the source list.

Entities

Currently, the following entity is exposed:

Media player

The following actions are supported:

  • Play/Pause
  • Channel up and down (using the previous/next track buttons in the media player controls)
  • Volume control
  • Channel switching via source list

The bouquet for the source list can be configured via the Configuration options.

Data updates

This integration fetches data from the device every 15 seconds by default.

Troubleshooting

Getting a 403.6 IP address rejected error on setup

Description

OpenWebif has a protection by default, so that only devices in the same subnet can connect to the device.

Resolution

There are two possible solutions to resolve this problem:

  • Enable HTTP(S) authentication (recommended for security)
  • Enable the OpenWebif setting “Enable access from VPNs”

Note

If you choose to enable VPN access without authentication, ensure your network is properly secured as OpenWebif is not designed for publicly facing the internet.

Remove integration

This integration follows standard integration removal, no extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three-dot menu. Then, select Delete.