Léon Brocard > Net-MythTV-0.33 > Net::MythTV

Download:
Net-MythTV-0.33.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.33   Source  

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.

syntax highlighting: