geertsmichael / ziggonext

Custom component to integrate Ziggo Mediabox Next into Home Assistant

Ziggo Mediabox Next

Breaking changes!!

Sensors are added to this component. Therefore the configuration for this component has changed. Check the configuration section below!

Description

A media player component for Home Assistant that creates a media player and a sensor for each Ziggo Media Box Next in your account.

Prerequisites

• You need a Ziggo account with a Ziggo Media Box Next.
• The energy mode needs to be set to high ("Hoog" in Dutch), otherwise you are not able to switch the device on in the media player.

HACS Installation

1. Make sure you've installed HACS
2. In the integrations tab, search for ZiggoNext.
3. Install the Integration.
4. Add ziggonext entry to configuration (see below)

Manual installation

1. Open the directory (folder) for your HA configuration (where you find configuration.yaml).
2. If you do not have a custom_components directory (folder) there, you need to create it.
3. In the custom_components directory (folder) create a new folder called ziggonext.
4. Download all the files from the custom_components/ziggonext/ directory (folder) in this repository.
5. Place the files you downloaded in the new directory (folder) you created.
6. Add ziggonext entry to configuration (see below)
7. Restart Home Assistant

Configuration

ziggonext:
  username: !secret ziggo_username
  password: !secret ziggo_password  

The id's for media_players and sensors are generated based on the name provided by Ziggo. You can adjust your box name in the settings on the ziggogo.tv website.

Parameters

Parameter	Type	Required	Description
username	string	yes	Your Ziggo username
password	string	yes	Your Ziggo password
country_code	string	no (default 'nl')	Your country code. Currently supported: nl, ch, be-nl, be-fr*

* Not tested

Service to change channel

service: media_player.play_media
service_data:
  entity_id: media_player.ziggobeneden
  media_content_id: 401 # Any channel number, 'Netflix' or 'Videoland'
  media_content_type: channel # 'channel' when media_content_id is channelnumber, 'app' when media_content_id is 'Netflix' or 'Videoland' 

Custom services

This service can be called to start a recording. Note that this shows a pop-up on screen and confirmation is required.

service: ziggonext.record
service_data:
  entity_id: media_player.ziggobeneden

This service can be called to rewind or fast-forward. Note that this command can be called multiple times to speed up. To stop this action, you can call the standard media_player.play service on the same entity.

service: ziggonext.rewind
service_data:
  entity_id: media_player.ziggobeneden

service: ziggonext.fast_forward
service_data:
  entity_id: media_player.ziggobeneden

Credits

• The excellent start from IIStevowII for a single settopbox inspired me!
• The nodejs script NextRemoteJs from basst85 used as reference to compare results.
• Contributions by:
  • shortwood
  • michael-geerts