This repo and channel have been deprecated. Please install the official Plex version through the Roku Channel Store. The channel store is also available on your Roku device.
You don't need to download or install anything from Roku, but you should take a look at Roku's developer site. In addition to the downloadable PDF documentation, you can browse the docs online. Roku's docs are well above average.
Before you can actually install Roku channels from source, you need to make sure your Roku is in "dev" mode:
- Using the Roku remote, press
Home-Home-Home-Up-Up-Right-Left-Right-Left-Right
- Choose to Enable the Installer
You only need to do this once, it will remain in dev mode. If you ever want to exit dev mode you can use the same remote sequence.
There's a Makefile that should take care of everything for you. You just need to set an environment variable with the IP address of your Roku. Assuming you're in a unix-like environment:
export ROKU_DEV_TARGET=192.168.1.2
(substituting your IP address...)cd Plex
make install
There are some additional targets in the Makefile, like make rel install
to
build a release, but you don't generally need them. One other nicety is the
ability to take a screenshot using make screenshot
.
Note: Some Roku versions are beginning to require HTTP authentication for
the installer. This is somewhat handled, but not necessarily robustly, so
you may need to make some tweaks. You can set environment variables for
ROKU_DEV_USERNAME
and ROKU_DEV_PASSWORD
, which default to rokudev
and
plex
respectively.
The Roku doesn't have logging per se, but dev channels are able to write messages to a console that you can tail using telnet. It's as simple as
telnet $ROKU_DEV_TARGET 8085