diff --git a/README b/README index de9ef0f..b38cf6e 100644 --- a/README +++ b/README @@ -29,7 +29,9 @@ Requirements Description ----------- -"TvGuide" is a highly customizable 2D EPG viewer plugin. +"TvGuide" is a highly customizable 2D EPG viewer plugin. The "Search & Recordings" +Menü provided by the red button allows to search in the EPG and manage timers, +search timers, series timers and switch timers in an convenient way. Installation ------------ @@ -54,6 +56,11 @@ During a "make install" the Icons are automatically copied from /themes/ to /themes/ +If directories for channel logos or icons are set via startup +parameters, images are searched first in these directories. If the image +is not available, an additional search in the according default directory +will be performed. + 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: @@ -81,7 +88,12 @@ 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 +Blue: Depends on configured Mode: + Default: Favorites Menu, Switch to channel in + detailed EPG View + Optional: Switch to currently selected channel + Optional: Open detailed EPG view (OK switches + then to channel) Numeric Keys: If Setup Option "Functionality of numeric Keys" is configured to "Jump to specific channel", the numeric keys are used for channel number @@ -97,38 +109,49 @@ 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. + the involved timers can be adapted to solve the conflict. Alternatively + reruns can be searched and used to solve timer conflicts. - Delete / Edit Timer: if a timer already exists for the currently selected broadcast, this timer can be deleted or edited. +- Timer Timeline: displays active timers per day +- Create Search Timer: create an search timer with epgsearch. The most + important options can be defined directly in the menu, expert options + are available via the "advanced options" button. +- Manage Search Timers: edit, delete and check results of search timers - 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 +- Check for Timer Conflicts: check for timer conflicts 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 search & recordings menu is intended to present a convenient interface to different VDR core recording features and additional epgsearch features. -The main goal is to reach better usability for "non expert users". Some -advanced features like editing or deleting search timers and creating epgsearch -templates are not implemented. For these "expert settings" the epgsearch plugin -(or the VDR schedules menu replaced by epgsearch) have to be used directly. +The main goal is to reach better usability for "non expert users". 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. +jump to the next page of the list. Pressing up on the first / down on the +last list item jumpps to the end / start of the list. If the Option "Use folders for instant records" is set, both during creating an instant records and a series timer you can choose the directory where the recordings will be stored. As possible folders all entries from VDRs /folders.conf will be used. These entries can be edited via OSD -through VDRs Timers Menu. +through VDRs Timers Menu. These folders are also provided to choose a folder +for a search timer. + +Favorites Menu: if configured, the blue key provides a favorite menu. In this +menu the current scheduling ("What's on now") and the next upcomming Shows +("What's on next") can be listed. Via the Plugin Setup Menu up to four user +defined times can be configured with a dedicated description (for instance +"Primetime" for 8:15 pm). These user defined times are also shown as options in +the favorites menu. Finally all search timers with the option "use as favorite" +enabled are displayed in the favorites menu. By selecting this entry, all hits +for this search timer are shown. Setup Options ------------- @@ -152,6 +175,8 @@ Setup Options select between jumping x channels back/forward or to the previous / next channel group - Keys Blue and OK + Blue: Favorites in normal view, channel switch in det. EPG View, Ok: det. EPG View + or Blue: Channel Switch, Ok: Detailed EPG or Blue: Detailed EPG, Ok: Channel Switch @@ -165,10 +190,6 @@ Setup Options - Huge Step (Keys 4 / 6) in hours Hours to jump vertically with keys 4 / 6 - Time Format (12h/24h) -- Use folders for instant records. If set to yes, when creating an instant record - or a series timer you'll be asked about the folder for the recordings. -- Use Remotetimers: Timers are handled not locally but on a VDR Server defined - with the remotetimers plugin. - Display Reruns in detailed EPG View * Screen Presentation: @@ -179,20 +200,22 @@ Setup Options - Width/Height of Channel Header (% of osd width/height) - Width/Height of Timeline (% of osd width/height) - Number of Channels to display +- Height of Headers (Status Header and EPG View Header, % of osd height) - 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 names in Header - Display channel groups - Width/Height of channel groups (% of osd width/height) -- Show Channel Logos +- Display current time baseline +- Show Channel Logos show / hide channel logos, if logos are shown: - Logo Extension jpg / png - Logo width ratio - Logo height ratio +- Text Border in Detailed EPG View (in pixel) - Show EPG Images show / hide EPG images, if images are shown: - EPG Image width ratio @@ -208,3 +231,30 @@ Setup Options 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 + +* Recording Menus and Favorites + +- Use folders for instant records. If set to yes, when creating an instant record + or a series timer you'll be asked about the folder for the recordings. +- Use Remotetimers: Timers are handled not locally but on a VDR Server defined + with the remotetimers plugin. +- Use "What's on now" in favorites +- Use "What's on next" in favorites +- Use user defined time 1 (to 4) in favorites + - Description (1 - 4) + - Time (1 - 4) +- Limit channels in favorites: if set to yes, only the configured channel range + is used to display favorite results (except for search timer favorites) + - start channel + - stop channel + +* Image Caching + +- Create Log Messages for image loading: enable debug messages for image loading +- Limit Logo Cache: if set to "no", every channel logo is cached. if set to "yes", + only the amount configured for "Maximal number of logos to cache" is cached, all + other logos are always loaded "on the fly" + - Maximal number of logos to cache +- Number of logos to cache at start: number of logos to pre cache at plugin startup + (a too large number causes a slower VDR start) +- Information about image cache sizes \ No newline at end of file