Elseed - A simple program to display caller-id information on your TiVo
=======================================================================

NOTE: This software comes with no warranty. I accept no responsibility 
for anything that might happen to your hardware/software/configuration 
as a result of using this software. For all I know, this software 
might make your TiVo explode. USE THIS SOFTWARE AT YOUR OWN RISK. 

WHAT IS ELSEED?
---------------

This is a simple little C program that will open your modem device 
on your TiVo, listen for caller-id information, and then display the 
caller's name and number on your TV screen. This software is 
supposed to (and does as far as I can tell) not interfere with the 
daily call that Tivo makes and the monthly(?) call to DirecTV that 
the DirecTivo makes.

WHAT DO I NEED?
---------------

1. A DirectTivo (DirectTV/Tivo Combo box). This software has only been 
   tested on a Phillips DirectTivo DSR6000 running TiVo software version 
   2.5.1. This may work on standalone Tivos or DirectTivos running other 
   software versions, I have no idea. Let me know if you get it working 
   on different hardware/software.
2. Your phone line attached to your Tivo.
3. Caller-ID service from your telephone company.
4. Some way to get this program onto your Tivo. (Enable bash on the serial 
   port and upload using rz OR take out your drive and copy this software 
   onto the root partition OR TivoNet/TurboNet FTP, etc.)

INSPIRATION
-----------

I decided to write this software after seeing TivoCID by JLC which is 
available here: http://pvrhack.sonnik.com/tivo/jlc/. Unfortunately 
it actually runs caller id software on another computer with a 
different modem that has to have caller-id capability and sends 
information to your Tivo over an ethernet card (or PPP over the serial port).
I decided to see if the modem inside the Tivo was capable of doing 
caller-id. Once I found out that it was, it was pretty easy to get this 
software up and running on the Tivo, thus requiring a lot less 
hardware/software/setup.

BORROWING SOFTWARE
------------------

I shamelessly stole the source code from 2 different projects and 
hacked them together to create this software. The two piece 
of software I "borrowed" were:

elcid - http://elcid.sourceforge.net/
    A simple C-based caller-id program

playitsam - http://minnie.tuhs.org/Programs/Playitsam/
    I only stole the OSD (On-screen display) code from playitsam
    to do the OSD stuff for elseed

    NOTE: Evidently playitsam borrow osd.c, osd.h, and font.h 
    from embeem's tivobvi 1.03. Check out:

    http://tivo.samba.org/download/mbm

    For more info on that project and other great tivo hacks. 
    Thanks embeem!

I also looked at the code in mgetty+sendfax to figure out a way to 
attach myself to a modem device while still allowing other programs 
to dial-out (I.E. The Tivo daily call).

LICENSE
-------

This software is free software (open source) released under the GNU 
Public License (GPL). See COPYING file in this distribution for more 
details.

THANKS
------

Thanks to the following people:

- embeem for the osd routines and nicepri and the cross-compiler information 
  and for being an all-around helpful person.
- jlc for writing tivocid which gave me my idea
- sporadic@linux.wku.edu for writing elcid, upon which this code is based
- All the other tivo hackers who came before me and made my life easier

INSTALLING THE SOFTWARE
-----------------------

See INSTALL file in this distribution.

CONTACT
------

All code Copyright (C) Greg Gardner <greg@bah.org>
