2025.3.4
首页 ▸ Integrations ▸

Enigma2 (OpenWebif)

The Enigma2 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [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.

配置

要将 Enigma2 (OpenWebif) device 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

如果上述 My 按钮不起作用，您也可以手动执行以下步骤：

  • 浏览到您的 Home Assistant 实例。

  • 转到 设置 > 设备与服务。

  • 在右下角，选择 Add Integration 按钮。

  • 从列表中选择 Enigma2 (OpenWebif)。

  • 按照屏幕上的说明完成设置。

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.

从Home Assistant中移除集成实例

  1. 前往 设置 > 设备与服务 并选择集成卡片。
  2. 从设备列表中，选择要删除的集成实例。
  3. 在条目旁边，选择三个点 菜单。然后，选择 删除。