NAME
    Net::TiVo - Perl interface to TiVo.

INSTALLATION
    
    % perl Makefile.PL 
    % make
    % make test
    % make install

REQUIREMENTS
    
    XML::Simple
    Log::Log4perl
    LWP::UserAgent

PLATFORMS

    I have tested it on the following platforms, but it should work on any platform
    that runs Perl, and meets the above requirements.
    
    FreeBSD v6.1

SYNOPSIS
      use Net::TiVo;
        
      my $tivo = Net::TiVo->new(host => '192.168.1.25', mac => 'MEDIA_ACCESS_KEY');

      for my $folder ($tivo->folders()) {
          print "--->", $show->as_string(), "<---\n";
          for my $show ($folder->shows()) {
              print $show->as_string(), "\n";
          }
      }     

ABSTRACT
    "Net::TiVo" provides an object-oriented interface to TiVo's REST
    interface. This makes it possible to enumerate the folders and shows,
    and dump their meta-data.

DESCRIPTION
    "Net::TiVo" has a very simple interface, and currently only supports the
    enumeration of folder and shows using the XML/HTTPS interface. The main
    purpose of this module was to provide access to the TiVo
    programmatically to automate the process of downloading shows from a
    TiVo.

METHODS
    folders()
        Returns an array or reference to an array containing a list of
        Net::TiVo::Folder objects.

SEE ALSO
    Net::TiVo::Folder, Net::TiVo::Show

AUTHOR
    Christopher Boumenot, <boumenot@gmail.com>