tivo-remote2.1.0 • Public • Published
Control your TiVo DVR over the network
tivo-remote is a Node.js library that allows you to control your TiVo DVR over your local network. It's especially useful for integrating into a home automation system.
tivo-remote is distributed through NPM:
npm install tivo-remote# or, if you prefer:yarn add tivo-remote
tivo-remote provides both discovery and control capabilities. To monitor the local network for TiVo devices, try something like this:
Once you have a device object, you have a number of control commands at your disposal:
Send an IR code to the DVR. The list of supported codes is very long; For details, see Ircode
Send a key code to the DVR. The list of supported codes is very long; For details, see KeyboardCode
"Teleport" to a given location in the DVR UI.
Tune the DVR to the given channel. If the forced flag is set, the DVR will be tuned even if a recording is in progress (canceling the recording).
Once you're finished with the device object, call deinit() to close the underlying network connection.
The name of this device.
The unique ID of this device.
The IP address of this device.
1.0 -> 2.0
The difference between 1.0 and 2.0 shouldn't be noticeable to most users, even though it is technically an API break. Version 1.0 exposed a module compiled with Babel such that it was necessary to use
const TiVoDiscovery = default
if the including project was not also compiled with Babel. Version 2.0 resolves this so both
require work as their respective users expect.
tivo-remote is built to support Node.js version 6.0 or higher.
Getting set up for development is very easy:
git clone <your fork>cd tivo-remoteyarn
And the development workflow is likewise straightforward:
# make a change to the src/ file, then...yarn buildnode dist/example.js# or if you want to clean up all the leftover build products:yarn run clean