zynine edited this page Apr 8, 2017 · 15 revisions

Getting Started

1. Installation

Method 1 : WebTools Unsupported AppStore (UAS)

This is the best/preferred method. HDHR Viewer 2 can be updated easily through the WebTools UAS interface.

Method 2 : Manual Installation

Copy HDHRViewerV2.bundle to Plex Plug-in Directory.

  1. Git clone or download the latest github copy.

  2. Unzip and rename the folder to HDHRViewerV2.bundle

  3. Copy the folder to Plex Media Server plug-in folder. Read more: How do I find the Plug-Ins folder?

  4. Make sure the directory structure looks like:

  |_ HDHRViewerV2.bundle
    |_ Contents

Method 3 : Scripts

Run install scripts included. (Limited OS)

2. Initial Plug-in Settings/Preferences

Many Plex clients can't access the Plug-in Settings/Preferences. Use Plex/Web to configure it.

Starting with 0.9.0, multiple tuners are supported, and tuners are automatically discovered (requires internet connection). Tuners can be manually defined in the Plug-in Preferences/Settings HDHomeRun IP. You can manually list multiple tuners, with space delimited. See examples below.

Set HDHomeRun IP: auto

Example of manual discover + multiple tuner + automatic discovery.

Set HDHomeRun IP:

Up to 0.8.x:

Supports only 1 tuner, and tuner IP address have to be manually specified in settings.

Set HDHomeRun IP:

3. Generate required AC3 codec (PMS 0.9.17.x and above.)

Since Plex Media Server 0.9.17.x and above, there was a change in the Plex transcoder which caused playback issue on most clients for first time users. To fix this problem, download a short clip from your HDHomeRun device, and add it to your PMS library, and play it. Now try using the HDHR Viewer 2 again.

1. Download a short clip from your HDHomeRun tuner.

Download a short clip from your HDHomeRun device using your web browser:


Example (tuner_ip=; channel=2.1; duration=5 seconds):

2. Add to Plex Library

Add the videos to your Movies or Home Videos library.

3. Play the added video

Play the video and it should generate the required AC3 codec.

4. Now try using the plug-in.

Go to HDHR Viewer 2, and try playing a video stream.

Common Issues and Resolution

Android devices

Certain android devices will have issue with playback. This is due to Plex Media Server (PMS) not transcoding the ac3 audio stream to aac properly. You can try to change the audio codec listed Android.xml profile in PMS Resources folder from aac to mp3.

For other issues

Go to https://github.com/zynine-/HDHRViewerV2.bundle/issues?q=is%3Aissue+is%3Aopen+label%3A%22common+issues%22

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.