Go to file
louis 9f351151ed left alignment of folders menu 2013-07-20 11:48:00 +02:00
icons Version 0.0.6 2013-07-09 00:17:42 +02:00
po added possibility to choose folder for instant recording 2013-07-18 17:59:59 +02:00
services Version 0.0.6 2013-07-09 00:17:42 +02:00
themes Version 0.0.6 2013-07-09 00:17:42 +02:00
COPYING Initial push tvguide 0.0.1 2013-01-17 13:16:44 +01:00
HISTORY color buttons displayed as configured in VDR 2013-07-19 15:42:16 +02:00
Makefile Version 0.0.6 2013-07-09 00:17:42 +02:00
README Updated README 2013-07-13 07:47:26 +02:00
channelcolumn.c changed channel jump logic 2013-07-15 17:27:55 +02:00
channelcolumn.h Version 0.0.6 2013-07-09 00:17:42 +02:00
channelgroup.c display of additional EPG pictures in detailed epg view 2013-06-03 09:52:54 +02:00
channelgroup.h display of additional EPG pictures in detailed epg view 2013-06-03 09:52:54 +02:00
channelgroups.c Fixed bug in channel groups color display 2013-06-03 10:01:52 +02:00
channelgroups.h Added channel group support 2013-05-31 13:58:22 +02:00
config.c added possibility to choose folder for instant recording 2013-07-18 17:59:59 +02:00
config.h added possibility to choose folder for instant recording 2013-07-18 17:59:59 +02:00
detailview.c page scrolling with keys left and right in detail view 2013-07-17 16:43:57 +02:00
detailview.h page scrolling with keys left and right in detail view 2013-07-17 16:43:57 +02:00
dummygrid.c Fixed possible crash 2013-07-12 16:00:18 +02:00
dummygrid.h Fixed possible crash 2013-07-12 16:00:18 +02:00
epggrid.c Version 0.0.6 2013-07-09 00:17:42 +02:00
epggrid.h Version 0.0.6 2013-07-09 00:17:42 +02:00
footer.c color buttons displayed as configured in VDR 2013-07-19 15:42:16 +02:00
footer.h color buttons displayed as configured in VDR 2013-07-19 15:42:16 +02:00
grid.c whitespace cleanup 2013-05-26 11:38:05 +02:00
grid.h Version 0.0.6 2013-07-09 00:17:42 +02:00
headergrid.c Version 0.0.6 2013-07-09 00:17:42 +02:00
headergrid.h whitespace cleanup 2013-05-26 11:38:05 +02:00
imageloader.c Version 0.0.6 2013-07-09 00:17:42 +02:00
imageloader.h Version 0.0.6 2013-07-09 00:17:42 +02:00
messagebox.c avoided nasty font pixelation effects with theme iceblue 2013-05-28 17:23:33 +02:00
messagebox.h whitespace cleanup 2013-05-26 11:38:05 +02:00
osdmanager.c Version 0.0.6 2013-07-09 00:17:42 +02:00
recmanager.c recording folder also choosable for series timers 2013-07-19 15:30:41 +02:00
recmanager.h recording folder also choosable for series timers 2013-07-19 15:30:41 +02:00
recmenu.c Version 0.0.6 2013-07-09 00:17:42 +02:00
recmenu.h Version 0.0.6 2013-07-09 00:17:42 +02:00
recmenuitem.c left alignment of folders menu 2013-07-20 11:48:00 +02:00
recmenuitem.h left alignment of folders menu 2013-07-20 11:48:00 +02:00
recmenumanager.c recording folder also choosable for series timers 2013-07-19 15:30:41 +02:00
recmenumanager.h recording folder also choosable for series timers 2013-07-19 15:30:41 +02:00
recmenus.c left alignment of folders menu 2013-07-20 11:48:00 +02:00
setup.c added possibility to choose folder for instant recording 2013-07-18 17:59:59 +02:00
setup.h Added setup option to switch functionality of keys Blue and OK 2013-06-01 11:08:17 +02:00
statusheader.c added frame around scaled video picture 2013-06-02 10:36:57 +02:00
statusheader.h whitespace cleanup 2013-05-26 11:38:05 +02:00
styledpixmap.c Version 0.0.6 2013-07-09 00:17:42 +02:00
styledpixmap.h Version 0.0.6 2013-07-09 00:17:42 +02:00
switchtimer.c Version 0.0.6 2013-07-09 00:17:42 +02:00
switchtimer.h Version 0.0.6 2013-07-09 00:17:42 +02:00
timeline.c Version 0.0.6 2013-07-09 00:17:42 +02:00
timeline.h whitespace cleanup 2013-05-26 11:38:05 +02:00
timer.c Version 0.0.6 2013-07-09 00:17:42 +02:00
timer.h Version 0.0.6 2013-07-09 00:17:42 +02:00
tools.c Version 0.0.6 2013-07-09 00:17:42 +02:00
tvguide.c changed service call 2013-07-12 17:23:16 +02:00
tvguideosd.c blue button also available in detail view 2013-07-19 15:34:52 +02:00
tvguideosd.h changed channel jump logic 2013-07-15 17:27:55 +02:00

README

This is a "plugin" for the Video Disk Recorder (VDR).

Written by:                  Louis Braun <louis DOT braun AT gmx DOT de>

Project's homepage:          http://projects.vdr-developer.org/projects/plg-tvguide 

Latest version available at: http://projects.vdr-developer.org/projects/plg-tvguide/files

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
See the file COPYING for more information.

Requirements
------------

- Clone Git Repository: git clone git://projects.vdr-developer.org/vdr-plugin-tvguide.git
- VDR version >= 2.0.0
- Installed ImageMagick for showing png/jpg Channel Logos, EPG Images and menu icons
- for scaling the video picture to fit into the VDR menu window please use
  softhddevice plugin revision 87c1c7be (2013-01-01) or newer.
- Installed epgsearch Plugin for extended search & recording features.
- Installed remotetimers Plugin for creating timers on a vdr server remotely from a 
  vdr client.


Description
-----------

"TvGuide" is a highly customizable 2D EPG viewer plugin.

Installation
------------

After "normal" Plugin installation you have to care about the paths for the
used Icons, the channel logos and epg images. The following paths can be set
at startup:

-l path, --logodir=path
    Path to the logos (Default: <vdrconfdir>/plugins/tvguide/channellogos/).

-i path, --epgimages=path
    Path to the epgimages (Default: <vdrconfdir>/plugins/tvguide/epgimages/).

-c path, --icons=path
    Path to the icons directory (Default: <ressourcedir>/plugins/tvguide/epgimages/).

ResourceDirectory is taken from your VDR configuration (make.config or vdr.pc).

During a "make install" the Icons are automatically copied from <PlgSourceDirectory>/icons/
to the default path. Included Theme files are also copied from <PlgSourceDirectory>/themes/
to <ConfigDirectory>/themes/

I recommend to use channel logos from https://github.com/3PO/Senderlogos
To download them just change in the directory you want to place the logos
and do a:

git clone https://github.com/3PO/Senderlogos.git logos

An update of the logos can then be done with a "git pull" just inside this
directory.

For S2-6400 Users: Disable High Level OSD, otherwise the plugin will not be
loaded because lack of true color support

For Xine-Plugin Users: Set "Blend scaled Auto" as OSD display mode to achieve
an suitable true color OSD.

For Xineliboutput Users: Start vdr-sxfe with the --hud option enabled

Usage
-----

Remote Control Keys:

Up/Down/Left/Right:    Navigation in the EPG grid
Ok:                    Detailed EPG View of the selected grid
                       2nd Ok closes the detailed view
Red:                   Search & Recording Menu
Green / Yellow:	       Jump (default) five channels back / forward
Blue:                  Switch to currently selected channel
1 / 3:                 Big jump (default 3h) back / forward in time
4 / 6:                 huge jump (default 24h) back / forward in time
7 / 9:                 jump to previous / next prime time (8pm)
Exit:                  closes plugin

In Search & Recording menu the following options are available:

- Instant Record: create a timer for the currently selected program. An
  check for timer conflicts will be performed, if a timer conflict occurs,
  the involved timers can be adapted to solve the conflict.
- Delete / Edit Timer: if a timer already exists for the currently selected
  broadcast, this timer can be deleted or edited.
- Create Series Timer: create a periodical timer for a dedicated time on
  dedicated days.
- Create Search Timer: create an search timer with epgsearch. The most
  important options can be defined directly in the menu, alternatively
  epgsearch templates can be used to define the searchtimer options.
- Create Switch Timer: create a switch timer for the currently selected
  program.
- Search: search with epgsearch
- Search in Recordings: check if a recording already exists for the currently
  selected program.
- Check for Timer Conflicts: check for timer conflicts with epgsearch.

The navigation through the search & recording menu can be done easily with
up/down, left/right and the ok key. In scrolling lists, with left/right
(after the first/last option of the displayed list element is selected) you
jump directly to the top/bottom of the list.

Setup Options
-------------

* General Settings:

- Show Main Menu Entry
  Display "tvguide" in main menu
- Replace VDR Schedules Menu
  If set to "yes", the original VDR schedules menu will be replaced by tvguide
- Theme
- Rounded Corners
  Use rounded corners for displayed boxes
- Channel Jump Mode (Keys Green / Yellow)
  select between jumping x channels back/forward or to the previous / next 
  channel group
- Keys Blue and OK
  Blue: Channel Switch, Ok: Detailed EPG 
  or
  Blue: Detailed EPG, Ok: Channel Switch
- Hide last Channel Group
  If set to yes, the channels of the last channel group will not be displayed
- Big Step (Keys 1 / 3) in hours
  Hours to jump vertically with keys 1 / 3
- Huge Step (Keys 4 / 6) in hours
  Hours to jump vertically with keys 4 / 6
- Time Format (12h/24h)
- Display Reruns in detailed EPG View

* Screen Presentation:

- Display Mode
  Choose between horizontal or vertical display of the channels. All further
  width / height settings are dependend of this setting
- Width/Height of Channel Header (% of osd width/height)
- Width/Height of Timeline (% of osd width/height)
- Number of Channels to display
- Height of Footer
- Display status header
  - Height of status header (% of osd height/height)
  - Scale video to upper right corner
  - Rounded corners around video frame
- Display Channel Names in Header
- Display channel groups
  - Width/Height of channel groups (% of osd width/height)
- Show Channel Logos	
  show / hide channel logos, if logos are shown:
  - Logo Extension
    jpg / png
  - Logo width
    in Pixel
  - Logo height
    in Pixel
- Show EPG Images
  show / hide EPG images, if images are shown:
  - EPG Image width
    in Pixel
  - EPG Image height
    in Pixel
	
* Fonts and Fontsizes:

- Font:
  Used Font, all Fonts installed on your system are shown
- adjust various font sizes:
  the defined value is added to / subtracted from the default font size