NAME

Audio::M4P::Decrypt -- DRMS decryption of Apple iTunes style MP4 player files

DESCRIPTION

Originally derived from the DeDRMS.cs program by Jon Lech Johansen

SYNOPSIS

use Audio::M4P::Decrypt;

my $outfile = 'mydecodedfile';
my $deDRMS = new Audio::M4P::Decrypt;
$deDRMS->DeDRMS($mp4file, $outfile);

METHODS

new

my $cs = new Audio::M4P::Decrypt;

my $cs_conparam = Audio::M4P::Decrypt->new(
  strHome => '~', sPfix => '.', dirSep => '/' );

Optional arguments: strHome is the directory containing the keyfile directory. After running VLC on a .m4p file under Windows, MacOS X, and Linux, this should be found by the module automatically (APPDATA dir under Win32, ~/ under OS X and Linux). sPfix is '.' for MacOS/*nix, nil with Windows. dirSep is the char that separates directories, often /.

For debugging purposes, use eg: my $cs_conparam = Audio::M4P::Decrypt->new( DEBUG => 1, DEBUGDUMPFILE => 'm4ptree.html' );

DEBUG turns on debugging output. DEBUGDUMPFILE is an output file name to dump an html picture of the m4p data structure.

DeDRMS

my $cs = new Audio::M4P::Decrypt( forceclean => 1 );
$cs->DeDRMS('infilename', 'outfilename');

Decode infilename, write to outfilename. Reading slurps up an entire file, so output can overwrite the same file without a problem, we hope. Backup first. 'forceclean => 1' will also attempt to remove residual personal data from the file.

DecryptFile

$cs->DecryptFile('infilename', 'outfilename');

More descriptive alias for the DeDRMS method.

SEE ALSO

LWP::UserAgent::iTMS_Client

iTunes::Sid

NOTES

This software is designed to allow different but fair use of music by the 
purchaser of the music. In no way is this software intended to facilitate 
use of digital music files by parties other than the purchaser of the 
originally DRM-protected material. That is Fair Use, corporate entities. 

If you need to locate your iTMS keys, look for compatible versions of 
JHymn or FairKeys, or use the LWP::UserAgent::iTMS_Client Perl module.

Class Internal Functions

Decrypt

GetUserKey

AUTHOR

Original C# version: copyright Jon Lech Johansen B<jon-vl@nanocrew.net>. 
Perl version: William Herrera B<wherrera@skylightview.com>. 

SUPPORT

Questions, feature requests and bug reports should go to <wherrera@skylightview.com>.

COPYRIGHT

Copyright (c) 2003-2005 William Herrera. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.