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.
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.
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