NAME
    Net::MythTV - Interface to MythTV

SYNOPSIS
      use Net::MythTV;

      my $mythtv = Net::MythTV->new();
      my @recordings = $mythtv->recordings;
      foreach my $recording (@recordings) {
        my $filename = $recording->title . ' ' . $recording->start . '.mpg';
        $filename =~ s{[^a-zA-Z0-9]}{_}g;
        print $recording->channel . ', '
          . $recording->title . ' '
          . $recording->start . ' - '
          . $recording->stop . ' ('
          . $recording->size . ') -> '
          . $filename
          . "\n";
        $mythtv->download_recording( $recording, $filename );
      }

      # prints out something like:
      # BBC TWO, Springwatch 2009-06-11T19:00:00 - 2009-06-11T20:00:00
      #   (3184986020) -> Springwatch_2009_06_11T19_00_00_mpg
      # Channel 4, Derren Brown 2009-06-11T22:40:00 - 2009-06-11T23:10:00
      #   (1734615088) -> Derren_Brown_2009_06_11T22_40_00_mpg

DESCRIPTION
    This module provides a simple interface to MythTV using the MythTV
    protocol. MythTV is a free open source digital video recorder. Find out
    more at <http://www.mythtv.org/>.

    This module allows you to query the recordings and to download them to a
    local file. By default the MythTV protocol is only allowed on the local
    machine running MythTV.

METHODS
  new
    The constructor takes a hostname and port, but defaults to:

      my $mythtv = Net::MythTV->new();
      my $mythtv = Net::MythTV->new( hostname => 'localhost', port => 6543 );

  recordings
    List the recordings and return them as Net::MythTV::Recording objects:

      my @recordings = $mythtv->recordings;
      foreach my $recording (@recordings) {
        print $recording->channel . ', '
          . $recording->title . ' '
          . $recording->start . ' - '
          . $recording->stop . ' ('
          . $recording->size . ') -> '
          . $filename
          . "\n";
      }

  download_recording
    Downloads a recording to a local file:

      $mythtv->download_recording( $recording, $filename );

SEE ALSO
    Net::MythTV::Connection, Net::MythTV::Recording.

AUTHOR
    Leon Brocard <acme@astray.com>.

COPYRIGHT
    Copyright (C) 2009, Leon Brocard

LICENSE
    This module is free software; you can redistribute it or modify it under
    the same terms as Perl itself.

