Skip to content
Adam edited this page Jul 21, 2023 · 2 revisions

Introduction

This Indigo 2022.2+ plugin allows Indigo to act as a remote control for a network-connected Roku streaming player. All commands/buttons found on the standard remote can be sent to the Roku as well as several additional commands found on the mobile applications.

Note that the protocol exposed by the Roku devices, and utilized by this plugin, does not allow for state information about the Roku to be obtained (such as what current application/channel is active or what screen the Roku is currently showing).

Latest Versions for Previous Indigo Releases
Plugin Indigo 7.3 through 2022.1
Plugin Indigo 6 - Indigo 7.2

Hardware Requirements

This plugin should work with any Roku streaming player or Roku TV; you must be on Firmware version 2.8 in order to utilize the plugin's ability to download the channel icons for use on control pages.

The auto-discovery feature requires that the Roku and Indigo server be on the same subnet, though manual IP entry should allow remote control via a WAN interfaces (such as over a VPN connection).

Installation and Configuration

Obtaining the Plugin

The latest released version of the plugin is available for download via the Plugin store. Any beta releases will be released through the GitHub Releases (where you may also find the Plugin Store published versions.)

Configuring the Plugin

Upon first installation you will be asked to configure the plugin; please see the instructions on the configuration screen for more information. Most users will be fine with the defaults unless an email is desired when a new version is released.

Plugin Devices

When creating (or editing a device), in the Device Settings you will need to select from the list of Roku devices found on the network or else manually enter your Roku's IP address. Note that if you ever lose connection with your Roku device, you may need to return here to find/enter the IP Address again if it has picked up a new address on the network (the plugin will attempt to find the IP address if it or the server is restarted). Please read the other configuration instructions shown on screen as you may be able to adjust to optimize the performance of your Roku hardware.

Available Actions

Send Button Press

This action will send a network command that is equivalent to pressing the button on the remote (some buttons included are not found on the physical remote, but usually included in the mobile apps).

Roku TV devices may also support the Turn On and Turn Off commands via network.

Send Keyboard Text

This action will send text to the Roku as if it had been typed in via the onscreen keyboard or the mobile application's keyboard. Only alphanumerics and a handful of punctuation are currently supported.

Launch Channel/Application

This action will launch a particular channel on your Roku. Note that the list of available channels is loaded from your Roku device itself, so adding a new channel from the channel store will automatically add it to the list of channels from which you may choose in the action configuration dialog.

Tun to Station

For Roku TV based devices, this allows tuning the built-in tuner to a specific station; note that digital channels may require the sub-channel specification such as 1.1.

Download Channel Icons

This action will download all of the channel icons from the Roku (for channels currently added to the box). These will be saved in the format provided by the Roku devices (generally PNG, though JPG is an allowed format). The default directory is to the static images directory used by the Control Page Editor; however, you may override this in the action's settings dialog.