Getting started

If the app ist started for the first time, it will lead you to the configuration page. Please fill in the ip-address or hostname of your VDR and adjust port and protocol according to the configuration of vdr-plugin-restfulapi.

"Resource efficient loading" is recommended if the machine you run VDR on has not much power like ARM devices (Dockstar, Raspberry PI etc). Otherwise it is recommended to turn it off.

If you have vdr-plugin-streamdev-server installed on your machine you can turn "Use Streamdev" on. If your browser is capable of replaying h264 Streams in WebM or Matroska container you con turn on "Use HTML5 Player". Note that a special externremux.sh is needed to transcode the streams into a format your browser can decode. You can fetch a working example here. For further information read section Streaming. Configure protocol, host and port according to your setup.

The remaining configuration options should be fine and you are all set up. Please go back one page.

Once youre there, the EPG should start loading events from restfulapi. Now you can add a shortcut to your Home Screen. Please close your Browser and restart the app from there.

Now you can start browsing the EPG, set timers for events you don't want to miss and even watch live-tv or recordings.

Configuration

Most configuration default values should match your vdr plugins configuration. If not adjust accordingly.

User Interface

Startpage

You can choose which page to display on startup. Needs reload of app for changes to take effect.

Vibration

Vibrate on touch

Show images in EPG view

Whether or not display images in EPG view. Images are being processed by the browser to apply a transparency gradient which can have a high impact on your CPU. Disable if you are experiencing issues.

Language

Choose Language. Needs reload of app for changes to take effect.

Server Settings

Protocol

Choose on out of HTTP and HTTPS. Must be the same as protocol used to load the app itself. Restfulapi does not support SSL at the moment and probably never will. If you want to set up SSL you have to use a reverse proxy. An example on how to configure Apache as reverse Proxy can be found here.

Host

IP or Hostname of Restfulapi

Port

Port of Restfulapi. You must specify the port even if standard ports like 80 or 443 are used.

Resource efficient loading

Turn this on if your VDR machine is weak. The app fires requests for all channels on startup. Dockstars cannot handle this. Recommended to turn off otherwise as requests are fired synchronously than which has an high impact on loading time.

OSD Settings

OSD Delay (ms)

Time to wait after key press before OSD is refreshed.

OSD refresh interval (ms)

Time to wait before OSD is refreshed

Channel Settings

Show radio channels

Recommended to turn of as the app does not handle radio.

First Channel

Number of first channel to be displayed in EPG. Starts with 1

Max. Channels

Amount of Channels to be displayed. 0 = No Limit

Timer Settings

Recording lead time

Time margin before event starts (seconds)

Recording follow up time

Time margin after event ends (seconds)

Use VPS if available

Whether or not set VPS flag. Does not work well if xmltv2vdr, tvscraper or scraper2vdr is in use.

Streaming

Use StreamDev

Activate Streaming

Stream protocol

Choose one. Must be equal to protocol used to load the app itself, if HTML5 Player is used. VLC will open the stream in VLC if installed. HTTPS for VLC is currently not available.

StreamDev Host

Hostname/IP of StreamDev Server to be used

Port of StreamDev Server. You must specify the port even if standard ports like 80 or 443 are used.

Favoutites

Choose some favourite channels. The will appear in the drawer manu that appears on the start page if you hit the icon.

Use HTML5 Vidoe Player

Whether or not use the integrated HTML5 Video Player. No browser plugin needed.

StreamDev Parameter

Extra parameters for StreamDev externremux. Since bitrate and dimensions can be adjusted during playback, only needed if the HTML5 Player is not used. For further information have a look at the externremux.sh script.

Download

If enabled the HTML5 Video Player offers a button to download the transcoded stream. On Android this works, if you choose to open the download in Firefox for Android since the Android Download Manager cannot handle the stream.

Developer Options

Debugmode

Dump some debug messages to the browsers console.

EPG

  The EPG consists of two different views that you can toggle via context menu. The EPG-View shows upcoming events in a table manner, Channel-View shows one channel at the time, that can be changed by touching a channel icon.

  If streaming is enabled a long press on a channel icon loads the stream url. Your browser should ask which app you prefer to open the stream.

If streaming and html5 player is enabled a long press on a channel icon activates the html5 player in both views.

  Hitting an event in both views opens up a window with detailed information.

The event window offers three tabs. On the tools tab you can set a timer. Once set you can delete it again, deactivate it or edit the name and the path of the file

Timer

Recordings

EPG Search

OSD

Streaming