File	Date	Author	Commit
libosd	2006-08-29	John L. Chmielewski	[bc8a7a] See CHANGES File for Release 0.9
.hgtags	2010-01-08	convert-repo	[7fc638] update tags
CHANGES	2006-08-29	John L. Chmielewski	[bc8a7a] See CHANGES File for Release 0.9
FONTS	2005-09-02	Pete Morgan	[319d9d] out2osd source
INSTALL-TiVo	2006-08-29	John L. Chmielewski	[bc8a7a] See CHANGES File for Release 0.9
Makefile	2006-08-29	John L. Chmielewski	[bc8a7a] See CHANGES File for Release 0.9
README	2006-08-29	John L. Chmielewski	[bc8a7a] See CHANGES File for Release 0.9
ReleaseNotes	2006-08-29	John L. Chmielewski	[bc8a7a] See CHANGES File for Release 0.9
abbey_m1.ttf	2005-09-02	Pete Morgan	[319d9d] out2osd source
config.c	2005-09-02	Pete Morgan	[319d9d] out2osd source
config.h	2006-08-29	John L. Chmielewski	[bc8a7a] See CHANGES File for Release 0.9
out2osd.1	2006-08-29	John L. Chmielewski	[bc8a7a] See CHANGES File for Release 0.9
out2osd.c	2006-08-29	John L. Chmielewski	[bc8a7a] See CHANGES File for Release 0.9
out2osd.conf	2006-08-29	John L. Chmielewski	[bc8a7a] See CHANGES File for Release 0.9
out2osd.h	2006-08-29	John L. Chmielewski	[bc8a7a] See CHANGES File for Release 0.9

Read Me

OUT2OSD - output to On Screen Display

OUT2OSD is a program that outputs text to the TiVo OSD.

It displays on either a Series1 or a Series2 TiVo using libosd
    http://www.dealdatabase.com/forum/showthread.php?t=34159&page=1&pp=15
modified for the cross compilers at http://tivoutils.sourceforge.net/

The original version used the osd routines (osd.c and osd.h files) from:
    http://http://tivo.samba.org/download/mbm/tivovbi-1.03.zip

OUT2OSD can display the contents of one or more files or the
output of a program.  Each file should have 16 lines or less
and 33 columns max, if using the built-in font.  It will also
use freetype fonts, although on a ppc TiVo (Series 1) it seems
too slow.  The environment variable $FONT_PATH should be set, in
order to use freetype fonts: FONT_PATH=$FONT_PATH:/var/hack/share/fonts

An example of typical usage: echo "Hello TiVo" | out2osd
will display Hello TiVo on the first line of the display.

OUT2OSD will read a config file, if present, to set things
like: line, column, foreground, background, and delay.
Command line options will override config file settings.
The config file can be changed, by a command line option,
from using the default file: /var/hack/etc/out2osd.conf

############
# Compile: #
############

OUT2OSD will compile using these cross compilers for Linux:

    http://tivoutils.sourceforge.net/
        usr.local.powerpc-tivo.tar.bz2 (x86 cross compiler for Series1)
        usr.local.mips-tivo.tar.bz2 (x86 cross compiler for Series2)

Obtain libosd-0.4.1 from:

    http://dealdatabase.com/forum/showpost.php?p=180776&postcount=48

Obtain libosd-7.x-patch from:

    http://www.dealdatabase.com/forum/showthread.php?p=259207#post259207

    libosd-7.x-patch:   apply to libosd-0.4.1 to create libosd-0.4.2
                        rename libosd-0.4.1 to libosd-0.4.2

Included libosd patches:

        jamie.patch:        apply to libosd-0.4.2
        libosd-0.4.2.patch: apply to libosd-0.4.2 after jamie.patch

Results of patches:

        libosd-7.x-patch:   libosd 0.4.1 becomes libosd 0.4.2
        jamie.patch:        adds multiple lines to freefonts
                            fixed multiple lines from always starting in col 1
        libosd-0.4.2.patch: patched source for series 1 above compiler use
                            Patched Makefile to accept SERIES=x1 for ppc
                            and SERIES=x2 for mips using the above compilers

Included header file for Series1 x86 cross compiler

        stdint.h: cp -p stdint.h /usr/local/tivo/include/stdio.h

The jamie patch was sent to me by Jamie from www.dealdatabase.com

OUT2OSD requires the following libraries to compile:

    http://www.dealdatabase.com/forum/showthread.php?t=34159&page=4&pp=15
        libosd-0.4.1 

    http://freetype.sourceforge.net/download.html
        freetype-2.1.9.tar.bz2

    http://sourceforge.net/project/showfiles.php?group_id=32355
        libpng-1.2.7.tar.bz2

    http://www.gzip.org/zlib/
        zlib-1.2.1.tar.bz2