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.