This page is part of archived documentation for openHAB 2.5. Go to the current stable version

# TiVo Binding v1

This binding works with older TiVo units which support the v1.0 protocol. TiVo units that implement the newer v1.1 API (opens new window) will encounter some incompatibility. If you find that button commands (pause, play, record) work, but nowshowing does not work, you likely have a Tivo that implements the v1.1 protocol.

# Prerequisites

Enable Network Remote Control (opens new window) on your TiVo.

# Binding Configuration

This binding can be configured with the file services/tivo.cfg.

Property Default Required Description
host Yes Your Tivo's hostname or IP address

# Item Configuration

The format of item binding configuration strings is

tivo="<command>"

where <command> is one of:

  • tivo
  • info
  • guide
  • window
  • record
  • clear
  • enter
  • play
  • reverse
  • pause
  • forward
  • replay
  • slow
  • advance
  • cc_on
  • cc_off
  • standby
  • nowshowing
  • num0
  • num1
  • num2
  • num3
  • num4
  • num5
  • num6
  • num7
  • num8
  • num9
  • live_tv
  • thumbs_up
  • thumbs_down
  • channel_up
  • channel_down

# Examples

Switch Tivo_Button "Tivo Button" { tivo="tivo" }
Switch Tivo_Recordings "Tivo Recordings" { tivo="nowshowing" }
Switch Tivo_Standby "Tivo Standby" { tivo="standby" }

Turn any TiVo Switch ON in a rule or script to send the configured command to your TiVo.

For example, the following code in a rule simulates a press of the "tivo" button on the remote control, gives the Tivo 3 seconds to wake up, then jumps to the recording list:

Tivo_Button.sendCommand(ON)
createTimer(now.plusSeconds(3)) [ | Tivo_Recordings.sendCommand(ON) ]

The following code in a rule will put the Tivo in standby:

Tivo_Standby.sendCommand(ON)