Frequently Asked Questions




We were starting to get a bit overwhelmed with FAQ threads, so I figured I'd consolidate them and put them in one spot. I'm leaving the Roku 2 alert alone for now as I want people to see it more easily and it should ultimately be a temporary issue (hopefully...).

Please take a look through this before opening up a new thread, it would be greatly appreciated. There's a pretty good chance you'll find your answer already in these forums somewhere, and that's always going to be faster and better than starting a new thread.



Limitations and Known Bugs

List of known bugs, limitations and work arounds.


- [s]Discovery does not work on Windows based PMS. Fix coming shortly.[/s]

- [s]Playback fails silently for some media when on wireless. Work around is to reduce the quality/bandwidth setting until it will play./s

- [s]Bad quality for SD content: Bug in ffmeg -[/s]

- [s]Linux PMS discovery broken. Fix coming.[/s]

- Some people are seeing issues with no content showing up. Looks like an issues with the network interface. Check for work arounds.

- Initial audio stutter on some media. Quick fast-forward brings things back into sync.

- Media only marked as partially watched after playing

- [s]Aspect ratio is incorrect on some videos (anamorphic?)/s


- [s]No 5.1, only 2 channel/s

- [s]Local network only (for now)[/s] s[/s] myPlex support was added in v2.0

- [s]Video only support for now. Audio and photo support coming.[/s] Audio and photo support were added in v2.0

- [s]myPlex support is not yet implemented.[/x] myPlex support was added in v2.0

- [s]No direct play. Looks like people want this. I'll look into adding it.[/s] Direct Play was introduced in v2.0 and gets refined in every update

- [s]Mark as watched needs to be added.[/s] Added in v2.0

- [s]Folder based navigation (for home movies/etc. without metadata) is currently very limited.[/s] The By Folder view was fixed in v2.0

- VOB / TS files cannot be streamed. (Note that this is a limitation of the PMS and not the Roku client, and as such, won't be fixed until the server guys add support for transcoding raw DVD rips. In the interim, use something like MakeMKV to put it into a container format that PMS will work with.)


[NOTE: This is largely old information that hasn't been cleaned up...]

There are a handful of channels that aren't supported on the Roku, mostly things that have their own channel in the Roku store. But apart from that, there are no known issues with channels that are specific to the Roku. Because of that, you may want to test another Plex client (like Plex/Web) to see if the problem is specific to the Roku. If it's not specific to the Roku, you may find more knowledgeable people in either the channels forum or the Plex Media Server forum.

Troubleshooting Plex Channel Plugins

Please report any issues with Plex channel plugins here. By that I mean things like CBS, ESPN3, etc., not the basic Plex for Roku channel. Also, please note which version of the Plex channel you are using (official Plex, Plex Beta, Plex Grid, etc.) and whether or not you have tried to reproduce this under a regular Laika client (and what happened if you did).

Please do me a favor and check the list below first, as I will try to maintain a list of what you can expect to work and not.


Plex does not support Flash or Silverlight channels underneath Linux. While Flash does run under Linux, the code that is used to capture the audio/video is too complicated to port right now. And Silverlight itself doesn't run under Linux, it would have to be converted to using Moonlight with Mono. Your best bet for using channels is Windows Vista, Windows 7, or OSX.

Windows XP

The framework that Plex uses to capture video/audio output from Flash and Silverlight based channels is not supported under Windows XP (or earlier). Plex relies on some Windows system calls that weren't implemented until Windows Vista, so your best bet for channel support is to run Windows Vista, Windows 7, or OSX.


To properly capture audio for channels, Plex relies on Soundflower being configured. As I don't have a Mac myself, I don't know details, but I'm sure someone in the general Plex for Mac forums can help you out, as this is not specific to the Roku client at all.


  • ABC Family - plugin does not appear to work (tested under Roku, Android, and Laika)

  • ESPN3 - some elements appear to be broken in the plugin, but others have been fixed on the beta channel. Currently giving error 305 for all videos.

  • USA - plugin does not appear to work (tested under Roku, Android, and Laika)

  • Youtube - error "play failed: An unexpected problem (but not server timeout or HTTP error) has been detected."


  • ABC - works as of 1.7

  • Apple Movie Trailers - works as of 1.7.8

  • CBS - works as of 1.6

  • Hulu - MyHulu doesn't work, but watching TV episodes as of 1.6

  • NBC - works as of 1.6

  • The WB - works as of 1.6

The beta channel

You can add the beta channel here:

You'll want to go into the Channel Store on your Roku and exit it to trigger the installation. I'll be trying to keep that up to date with testing fixes while we keep the regular channel for stable major releases. Note that you can have both versions installed, side-by-side, without issue.


Update for version 2.2

As of version 2.2, we've added a way to get some logs off the device without having to install the channel in dev mode. You're still welcome to install in dev mode (it's open source and we love contributors!), but it's not usually necessary just for logs. The one exception to that is crashes, there's simply no good way for a channel to handle crashes and/or make logs available.

To get logs from version 2.2+:


[]Go to Preferences -> Logging -> Enable Logging

]Reproduce whatever it is you're having trouble with

[]Go to Preferences -> Logging -> Download Logs and follow the instructions


**How to enable development versions

This is not for the faint of heart, but for those folks looking to help troubleshoot crash related issues, read on! Bear in mind that you can have the official Plex (or Plex Beta) channel installed alongside the development version with no issues.

First of all, the Roku does not store logs anywhere. Instead, it has a network based console. Once your Roku has had development mode enabled, you can use a telnet program (such as Putty under Windows, or native terminal apps under OSX and Linux) to connect to port 8085 on your Roku. Two items of note: a) you can only debug applications which you have uploaded yourself, so you can't debug say Netflix or Amazon Unbox... or in our cause, the official Plex channel. B) You can only have one console session open at a time. If you're not getting any output on the console, confirm that you don't still have a previous session open (this confused me quite a bit one day...).

**To enable development mode:

Before you are able to load a development application to your box, you must enable development mode on your Roku Streaming Player. When you enter the special remote control sequence:

Home 3x, Up 2x, Right, Left, Right, Left, Right

(Are you having flashbacks to Mortal Kombat hidden command sequences yet?) You will be presented with the Developer Settings page where you can enable developer mode on the box. When developer mode is enabled, you can access the Application Installer page as specified in the next section.

If you would like to subsequently disable development mode on your box, simply enter the special remote code sequence again and select the “disable installer” option on screen.

**Using the Makefile

If you have developer tools installed on your computer, you can use the Makefile to simplify the steps that are described manually in the next sections. For example, on Mac OS X with developer tools, you can do the following:


]Get the source code you want to use (e.g. for the absolute latest)

[]Set an environment variable to point at the IP address of your Roku (e.g. export ROKU_DEV_TARGET=

]cd Plex (the directory with the Makefile)

[]make dev install

]telnet $ROKU_DEV_TARGET 8085


Creating the Zip File:

The simplest approach is to simply download the latest zip, but if you'd like to create it yourself, read on.

For us, you can download the source from github. The main public repository is here:, although each developer has their own fork which they develop on. When troubleshooting an issue with a developer, ask if you should be testing on their fork or the public repository, and where to go if they want you to test their fork. You can download a zip file of the source from github (you don't need to install a Git client) but you cannot directly upload this to your Roku as it's not in the right format. Extract the files from the Github zip file and go underneath the Plex folder. Make a copy of the manifest.template file named simply manifest. Zip up the following files/directories:

1. source/

2. images/

3. manifest

That zip file should then be able to be uploaded to your Roku.

To install a development channel:

Development applications are loaded onto the device using a standard web browser. When enabled for development mode the device hosts a web page for installing your application. To access the installer page, do the following:

1. From your Roku Streaming Player, navigate to “Roku Player Settings”, “player info” to find the IP address of your box.

2. From your development workstation, open a standard web browser and type the following URL: http:// (for example:

3. You should see a page like the one displayed in Figure 1 (Application Install Page) below.

4. Click the “Browse” button and navigate to the location of the application zip file on your development machine as shown in Figure 2 (Application File Browser). The full path to the application .zip file should appear in the text field.

5. Finally, click the “Install” button to deploy the application to the box. The application should install and begin running immediately. You will see a message on the web page indicating it was successfully loaded as shown in Figure 3 (Application Installer page – Installation Complete)

6. Run the application with the application debug console open. When you telnet to the Roku Streaming Player on port 8085 (see section 8.1) you will see the debug console from your application. If there are any errors in your code, they will show up on this console. There is even a debugger attached to this port that will give you source file and line number information for script errors.


My Roku Can't See My PMS:

Standard questions:

1.) Do you have internet access on your Roku; can you use another channel such as Amazon Unbox or Netflix without problem? If you don't, you have a basic networking problem with your Roku that you need to resolve first.

2.) Do you have a firewall on your PMS server? If so, disable it and try again. This isn't long term advice-- this is just to help isolate the problem. If it resolves it, then you know you need to update your firewall to allow access to the PMS service.

3.) Can you ping your Roku from your PMS server? The Roku IP is listed under Settings > Network > Connection status. You should see something like "". Then you would (on a windows box) go to start, type in "cmd", and hit enter. This will bring up a command prompt window. Then you would type in "ping " where is the IP of your Roku (obviously, don't type in the < or the >). You should see something along the lines of:

<br />
C:\Users\Morgan>ping<br />
<br />
Pinging with 32 bytes of data:<br />
Reply from bytes=32 time=1ms TTL=64<br />
Reply from bytes=32 time<1ms TTL=64<br />
Reply from bytes=32 time<1ms TTL=64<br />
Reply from bytes=32 time<1ms TTL=64<br />
<br />
Ping statistics for<br />
    Packets: Sent = 4, Received = 4, Lost = 0 (0% loss),<br />
Approximate round trip times in milli-seconds:<br />
    Minimum = 0ms, Maximum = 1ms, Average = 0ms<br />
<br />
C:\Users\Morgan><br />

If you see something like this:

<br />
C:\Users\Morgan>ping<br />
<br />
Pinging with 32 bytes of data:<br />
Reply from Destination host unreachable.<br />
Reply from Destination host unreachable.<br />
Reply from Destination host unreachable.<br />
Reply from Destination host unreachable.<br />
<br />
Ping statistics for<br />
    Packets: Sent = 4, Received = 4, Lost = 0 (0% loss),<br />
<br />
C:\Users\Morgan><br />

Then you have a networking problem you need to resolve between your Roku and your PMS server.

4.) If all of the above don't work, make sure you try to manually enter the IP of your PMS server instead of just doing auto-detect. Auto-detect should usually work but not always. Note that we do have some plans to improve auto-detection in the future, but it can get tripped up by things like your PMS having multiple ethernet interfaces or virtualization (VirtualBox, VMWare, etc.) software installed.

5.) If all of the above still don't work, please open a new thread detailing what you did in steps 1-4, and paste the output of your PMS servers file (this should typically be http://:32400/servers -- for example, mine is, which looks like this:

<br />
<MediaContainer size="1"><br />
<Server name="storm" host="STORM.local." port="65535" machineIdentifier="2663d43e059fc59eef374af4788f12f3bcfa7b24" version=""/><br />
</MediaContainer><br />

Along with that, please post what your IP address for your Roku unit is as well.

And if possible, grab the logs from the Roku and attach those to your post. You can get the logs from inside the Plex channel by:

1) Go to Preferences -> Logging -> Enable Logging

2) Now try to add the server manually, so the useful information will be logged

3) Go to Preferences -> Logging -> Download Logs and follow the instructions



As of v2.0, Plex is an official channel available through the channel store! You can browse the channel store and install it from there, or you can install it using!details/13535/plex

Test/Beta channels

We occasionally have pre-release versions of the channel available for testing. Sometimes it's simply the latest and greatest, sometimes it might be a build with specific changes being used to track down a problem. In general, most users should stick to the official channel, we try to keep it both stable and updated pretty frequently. If you're helping us test or specifically know that a test build is available, you're welcome to run it. You can run the channels side by side without any problems. The channel most likely to be used for future testing is

Once you have the channel added on the Roku website, go to the Channel Store on your Roku device, and then exit it. This will force-check for updates and pull down the new channels. This is also what you can do if you want to check to see if the channel has been updated. (From 1.6 onwards, the preferences screen inside the channel will also show the version number.) Note that the Roku will update the channel within 24 hours of us pushing a new version to them, but this is a quick way if you know we've done so (like if one of us pushes out a fix to the beta channel, for example).

--Jonny and the Plex Roku Team


Update: Also see a recent thread on troubleshooting playback issues at

Troubleshooting Playback Issues

First off, try the beta channel first. Don't report an issue without stating that you tried the beta channel as well (and confirming the version of the channel you had installed). A lot of the time there are fixes to problems existing in the official channel that reside in the beta channel for some time before a new official release is done. There's no need to report issues that have already been fixed, since, well, we obviously already know about them. Bear in mind that you can run the beta version and the official version side-by-side, so really, there's no reason not to run both channels.

If you do still have a problems, please generate a clean log of the issue. By that, I mean:


[]Shut the PMS service down

]Delete the log files

[]Start the PMS service

]Perform the operation on the Roku client that fails playback

[]Shut the PMS service down

]Zip up the log file (Plex Media Server.log) and attach it to your forum post

[]Restart the PMS service


As for where the log files are located, the wiki page is here:

Reposting the common locations:

**Windows Vista/7/etc:

%LOCALAPPDATA%\Plex Media Server\Logs

**Windows XP/2003/etc.:

%USERPROFILE%\Local Settings\Application Data\Plex Media Server\Logs





[]/var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Logs


**Mac / OS X:





[*]How to change the images for the section icons

[*]General information about configuring Handbrake for Roku settings to support Direct Streaming





If you've gotten this far and read the posts above, and still have an issue, please post a new thread. Please leave comments on this thread to the contents of the FAQs, so that it remains a helpful reference for folks instead of getting cluttered with troubleshooting posts. If necessary, I will split posts off into new topics to keep this thread clean.

Thank you!


Is the Plex Beta Channel still available?

I was able to add it. However, when I tried to open it, it gave a message to go to the regular channel.


No, there is no beta active at this time since we released the official channel.


[quote name='Alan Morgan' timestamp='1334191954' post='254924']

No, there is no beta active at this time since we released the official channel.


Some of these FAQ sections are outdated and could use some updates. The limitations and known bugs part needs revision, as does the installation section. Also, the instructions for installing a development version are incomplete. The versions on github don't have a manifest file, so more complete instructions are in order.


Sorry just read the post about starting a new thread but can't seem to figure out how to delete a post. Sorry :/


Is there a reason the roku client doesn't come up as one of the remote devices available when choosing content from the android app? It works fine when running plex media center or the plex app on another android device.


[quote name='mineal81' timestamp='1351028276' post='305303']

Is there a reason the roku client doesn't come up as one of the remote devices available when choosing content from the android app? It works fine when running plex media center or the plex app on another android device.


Implementing the remote API on the Roku is pretty challenging, literally impossible because of some architectural decisions that were made early on in the development of the channel. But it's something I'd like to get working, so we may get it figured out eventually.


[quote name='Alan Morgan' timestamp='1328149666' post='236662']

Plex Media Server

To access your local content, you'll also need a Plex Media Server (PMS) running on your local network. If you are planning to play Plex channels on your Roku, make sure to disable compatibility checking on your PMS. This is done by going to the PMS web interface, like:


Then going to Preferences, then Advanced, checkmark "Disable capability checking", and click Done. This is necessary because not all channels are fully supported and play well with capability checking.


This is very out of date and probably now causes more issues than it solves. Forcibly disabling this checking means that you have much more potential of having things show up on your Roku that don't work and are set to not show on it for a reason. This was more applicable at one point in time but now you will probably have a better experience leaving the compatibility checking in place.


Getting Logs

For investigating tricky issues, we may ask you to share your logs. There are two logs that are interesting: logs from the Roku, and the logs from your Plex Media Server.

Remote Logging

The easiest way to share logs with Plex team members is usually to enable remote logging. When you enable remote logging on your Roku, for the next 20 minutes all log messages from both your Roku and your Plex Media Server will be sent to a logging service. A handful of Plex developers have access to those logs and can pull them up without you having to download or upload anything. Only Plex developers have access to the logs though, so other forum members won't be able to help you. To enable remote logging:

1) Make sure you have a myPlex account connected to your Roku. The logs are indexed by myPlex username, so the option is only available when you have an account connected.

2) Enable logging on your Roku. It's under Preferences -> Logging.

3) Enable remote logging. Also under Preferences -> Logging.

4) Reproduce whatever problem you were having. Remote logging only lasts for 20 minutes, so reproduce the problem right after turning it on.

5) Post a description of the problem in the forums if you haven't already. Then just let us know your myPlex username and about when you turned on the logging so we can find it.

Roku Logs

The Roku doesn't have logging in a traditional sense. The device doesn't have a filesystem we can write to, so there are no logs from previous times you've used the channel, and nothing you can copy off of the box. But we have developed a way to store some log messages while you're using the channel. To get those logs:

1) Enable logging on your Roku. It's under Preferences -> Logging

2) Reproduce whatever problem you're seeing. Log messages aren't stored when logging is disabled, so you need to enable logging before you see the problem.

3) Download the logs. In a web browser on your computer, go to your_roku_ip_address:8324/logs. If you go to Preferences -> Logging -> Download logs there are specific instructions, including the exact URL to put in your browser.

Remember, logs are only stored while the channel is running. So you can't reproduce a problem, then exit the channel, then go back in and expect to see anything interesting in the logs.

Plex Media Server Logs

Your Plex Media Server keeps a log file that's often useful, Plex Media Server.log. Where exactly the file is stored depends on your operating system. See [the wiki]( for details.


Sharing Media Samples

If you're having problems playing specific media files, you may be asked to share a file. It can be very difficult to diagnose playback problems without access to the actual file. There are a few ways you can do this.

Share via myPlex

If you're Plex Media Server is published to myPlex, you can simply share the section with whoever is asking for the sample. You only need to enable this sharing temporarily. And feel free to create a special test section with just the file you want to share and just share that section. There's no need to share everything.

Create a smaller sample file

The [help center]( has an article with more instructions.


Here are my roku logs:

Roku version: 5.1 build 1195 (025.01E01195A)
App version: 2.6.7
Roku model: Roku 2 XD
Display type: HDTV
Anamorphic support: true
Successfully joined multicast group:
Created GDM player advertiser
######## Creating Grid Screen ########
Using broadcast address
GDM sendto address: /
Sent 23 bytes
Registry Server list string:\\b41495c36c3e5752729ee40e8eff87cd94ec1ee4
Server token:\\b41495c36c3e5752729ee40e8eff87cd94ec1ee4
Setting up home screen content, server count: 1
Creating URL transfer object for
Capabilities: protocols=http-live-streaming,http-mp4-streaming,http-mp4-video,http-mp4-video-720p,http-streaming-video,http-streaming-video-720p;videoDecoders=mpeg4,h264{profile:high&resolution:1080&level:40};audioDecoders=aac
Creating URL transfer object for
Validated myPlex token, corresponds to
Creating URL transfer object for
Final analytics data: v=1&tid=UA-6111912-18&cid=42f9fbce-db4d-1d2b-dd95-a469d1a9925d&sr=1280x720&ul=en-us&cd1=Plex%20for%20Roku&cd2=12A18A102977&cd3=Roku&cd4=5.1%20build%201195&cd5=Roku%202%20XD&cd6=2.6.7&an=Plex%20for%20Roku&av=2.6.7&ea=Shutdown&cm1=0&ev=110&ec=App&el=&t=event
Final analytics data: v=1&tid=UA-6111912-18&cid=42f9fbce-db4d-1d2b-dd95-a469d1a9925d&sr=1280x720&ul=en-us&cd1=Plex%20for%20Roku&cd2=12A18A102977&cd3=Roku&cd4=5.1%20build%201195&cd5=Roku%202%20XD&cd6=2.6.7&an=Plex%20for%20Roku&av=2.6.7&sc=start&ea=Start&ev=1&ec=App&el=&t=event
Final analytics data: v=1&tid=UA-6111912-18&cid=42f9fbce-db4d-1d2b-dd95-a469d1a9925d&sr=1280x720&ul=en-us&cd1=Plex%20for%20Roku&cd2=12A18A102977&cd3=Roku&cd4=5.1%20build%201195&cd5=Roku%202%20XD&cd6=2.6.7&an=Plex%20for%20Roku&av=2.6.7&cd=Home&t=appview
Pushing screen -1 onto view controller stack - Home
Loading beginning of row 0, Channels
Creating URL transfer object for
Successfully kicked off 1 requests for row 0, pending requests now: 1
Loading beginning of row 1, Library Sections
Creating URL transfer object for
Successfully kicked off 1 requests for row 1, pending requests now: 1
Total initial grid load took: 56ms
Starting global message loop
Received message: 'HTTP/1.0 200 OK
Content-Type: plex/media-server
Resource-Identifier: b41495c36c3e5752729ee40e8eff87cd94ec1ee4
Port: 32400
Updated-At: 1385321856


GDM discovery found server at
GDM discovery ignoring already configured server
Built GDM player response:HELLO * HTTP/1.0
Name: Roku 2 XD
Port: 8324
Product: Plex/Roku
Content-Type: plex/media-player
Protocol: roku
Version: 2.6.7
Resource-Identifier: 12A18A102977

Creating URL transfer object for
Successfully kicked off 1 requests for row 2, pending requests now: 1
Creating URL transfer object for
Successfully kicked off 1 requests for row 3, pending requests now: 1
Got a 200 response from (type servers, row invalid)
Got a -28 response from - Connection timed out after 30012 milliseconds
Got a -28 response from - Connection timed out after 30013 milliseconds
Loaded 0 elements in row 0, now have 0
Got a -28 response from - Connection timed out after 30065 milliseconds
Loaded 0 elements in row 1, now have 0
Creating URL transfer object for
Successfully kicked off 1 requests for row 4, pending requests now: 1
Got a -28 response from - Connection timed out after 30008 milliseconds
Loaded 0 elements in row 2, now have 0
Got a -28 response from - Connection timed out after 30000 milliseconds
Loaded 0 elements in row 3, now have 0
Creating URL transfer object for
Successfully kicked off 1 requests for row 5, pending requests now: 1
Got a 200 response from (type playlist, row 5)
Loaded 1 elements in row 5, now have 1
Got a 200 response from (type playlist, row 4)
Loaded 1 elements in row 4, now have 1
Loaded 0 elements in row 6, now have 0
Loaded 1 elements in row 7, now have 1
Final analytics data: v=1&tid=UA-6111912-18&cid=42f9fbce-db4d-1d2b-dd95-a469d1a9925d&sr=1280x720&ul=en-us&cd1=Plex%20for%20Roku&cd2=12A18A102977&cd3=Roku&cd4=5.1%20build%201195&cd5=Roku%202%20XD&cd6=2.6.7&an=Plex%20for%20Roku&av=2.6.7&cd=Preferences%20Main&t=appview
Pushing screen 2 onto view controller stack - Preferences Main
Registry Server list string:\\b41495c36c3e5752729ee40e8eff87cd94ec1ee4
Server token:\\b41495c36c3e5752729ee40e8eff87cd94ec1ee4
Final analytics data: v=1&tid=UA-6111912-18&cid=42f9fbce-db4d-1d2b-dd95-a469d1a9925d&sr=1280x720&ul=en-us&cd1=Plex%20for%20Roku&cd2=12A18A102977&cd3=Roku&cd4=5.1%20build%201195&cd5=Roku%202%20XD&cd6=2.6.7&an=Plex%20for%20Roku&av=2.6.7&cd=roListScreen&t=appview
Pushing screen 3 onto view controller stack - roListScreen
Final analytics data: v=1&tid=UA-6111912-18&cid=42f9fbce-db4d-1d2b-dd95-a469d1a9925d&sr=1280x720&ul=en-us&cd1=Plex%20for%20Roku&cd2=12A18A102977&cd3=Roku&cd4=5.1%20build%201195&cd5=Roku%202%20XD&cd6=2.6.7&an=Plex%20for%20Roku&av=2.6.7&cd=roParagraphScreen&t=appview
Pushing screen 4 onto view controller stack - roParagraphScreen