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

Written by:                  Sascha Volkenandt <sascha@akv-soft.de>
                             Andreas Regel <andreas.regel@powarman.de>

Project's homepage:          http://www.magoa.net/linux/index.php?view=osdpip

Latest version available at: http://www.magoa.net/linux/index.php?view=osdpip

See the file COPYING for license information.


Requirements:
-------------

- vdr 1.3.8 or higher
- libavcodec from ffmpeg (http://ffmpeg.sourceforge.net) version 0.4.8 or
  higher


Description:
------------

OSD Picture-in-Picture is a PlugIn that displays the current channel in a 
small box on the screen (default upper right corner). You can switch up and 
down now, watching the progress of the previous channel in the box. Quality is 
not too good yet, and only I-Frames are displayed. 
The plugin supports four modes:
 - greyscaled (16 shades of grey)
 - greyscaled (256 shades of grey)
 - 256 colors with fixed palette
 - 128 colors with variable palette
They all work with an ordinary vdr installation.
The plugin has the possibility to choose the PiP size (in the setup menu from
predefined sizes) and position (by moving it around using the cursor keys) as
well as crop dimensions.

ATTENTION: To have the position saved, you have to enter the plugin's setup
menu and hit the ok button.

The plugin lets you choose the MPEG frames to decode and display (in the setup
menu). For slower machines it is further possible to set an additional frame
dropping.

The plugin is able to show some channel and schedule info in a second window
when switching channels. In setup menu you can change it's position, size and
the amount of information shown.


Installation:
-------------

Let's say osdpip's version is 0.0.1 and vdr's version is 1.3.8. If you 
use anything else please exchange the version numbers appropriately (this
way I don't have to update this section all the times;) ).

cd vdr-1.3.8/PLUGINS/src
tar xvfz vdr-osdpip-0.0.1.tgz
ln -s osdpip-0.0.1 osdpip
cd ../..

If you have a VDR version lower than 1.2.25, you will have to patch it using
the file vdr-osd.diff. This patch fixes a bug in VDR regardings osd usage.

patch -p1 < PLUGINS/src/osdpip/patches/vdr-osd.diff

After applying it you have to recompile your VDR.

If you have ffmpeg installed, "make plugins" should do just fine now, but if
you have it next to your vdr folder (e.g. as the DXR3 plugin needs it), you
have to compile with "make FFMPEG_STATIC=1 plugins". Ffmpeg must then be
present in a folder (or symlink) called "ffmpeg".


Controls:
---------

Normal Mode:
Up/Down      Switch channel up/down
Left/Right   Select channel group (only when info window enabled)
1-9          Select channel (only when info window enabled)
Red          Swap PiP channel with currently viewed channel
Green        Switch to move mode
Ok           Show/hide channel info window
0            Switch back to PiP channel and exit PiP
Back         Exit PiP without switching back

Move Mode:
Cursor keys  Move PiP window around
Green        Switch to normal mode
0            Switch back to PiP channel and exit PiP
Back         Exit PiP without switching back

