homeassistant-tivo

Tivo component for Home Assistant (updated for Homeassistant 0.92.X)

Based on ideas from the following sites:

https://community.home-assistant.io/t/control-tivo-box-over-telnet/12430/65
https://www.tivocommunity.com/community/index.php?threads/tivo-ui-control-via-telnet-no-hacking-required.392385/
https://community.home-assistant.io/t/tivo-media-player-component/851
https://charliemeyer.net/2012/12/04/remote-control-of-a-tivo-from-the-linux-command-line/

Working functions:

1. Channel up and down - uses previous and next track buttons
2. Power buttons
3. FWD and REV
4. PLAY and PAUSE
5. Retrieval of program title and image info using zap2it - must use your own account information

Available but not integrated into gui, etc:

1. Open guide, tivo menu, live tv, now playing

Copy the tivo folder to your CONFIG_DIR/custom_components/ directory. This should now look like:

CONFIG_DIR/custom_components/tivo/media_player.py

It requires the following configuration:

media_player:
  - platform: tivo
    host: 192.168.0.22
    name: Tivo
    port: 31339
    device: 0
    debug: 0
#    zapuser: your_zaptoit_email_login
#    zappass: !secret zap2it_pass

1. Set debug to 1 for additional logging
2. Do not add zapuser/zappass to configuration.yaml unless you have a valid Zap2iT account. Add your zap2it password into secrets.yaml - note that our example does not encode the password, which you can change:

zap2it_pass: whateverYouChose

You can also let the tivo component use zeroconf configuration to find and construct your TiVo entities. Just remove the host key. In this case, the configuration would look like:

media_player:
  - platform: tivo
#    zapuser: your_zaptoit_email_login
#    zappass: !secret zap2it_pass

The entity names will be the name of the TiVo unit with the string _tivo added to the end. You can customize the entity names in the customization.yaml file. If you need to change the TiVo port for a specific unit, you can't use the zeroconf configuration.

This works by opening a socket connection to the Tivo device on its default port 31339. Then using the following protocol, it can perform several commands:

https://www.tivo.com/assets/images/abouttivo/resources/downloads/brochures/TiVo_TCP_Network_Remote_Control_Protocol.pdf

Then it reads the response and should try to parse that information to determine status. Simply connecting without sending a command, as we do in init, responds with status such as:

CH_STATUS 0613 LOCAL

This means channel status, channel 613, and channel was set by the remote. If we set the channel, it should say REMOTE instead of LOCAL, or RECORDING if a recording is in process.

Goals:

1. Start recording, end recording
2. switch and possibly navigate screens

The protocol should be capable of the above but it is unclear to me how to connect that to hass.

Issues:

1. Socket timeout occurs when connecting to a Tivo which is currently playing a recording,
    etc. (i.e. not in LiveTV mode)  This should be captured now but requires further testing...

More to come...