iTunes::Sid -- Apple iTunes SC Info common user database file interface
This module allows reading and writing of Apple iTunes type I<SC info.sid> databases, including the sidb and sidd files used by iTunes for storage of keys and certificates.
my $sid = iTunes::Sid( file => "sidb", $key => 'FIND', $iv => 'FIND' ); my $sid = iTunes::Sid( file => "sidb", regdata => 'filename', iTunes_platform => 'Darwin' ); Create an iTunes::Sid object. The file => $filename named argument specifies a data file to be read. The $key and $iv arguments are for decryption, if needed. regdata is a pathname of a file containing hardware data for key calculation. iTunes_platform => 'Darwin' means to look for an existing OS X installation on the mounted drives. The default is to look for an accessible Windows partition on which to find the SC Info data. my $sid = iTunes::Sid( file => 'SCINFOSIDB', regdata => 'filename' ); my $sid = iTunes::Sid( file => 'SCINFOSIDD', regdata => 'filename', scinfo_directory => '/media/windisk/ProgramData/Apple Computer/iTunes/SC Info' ); SCINFOSIDB and SCINFOSIDD are 'magic' file names indicating we should look for the SC Info/Sc Info.sid[b|d] files and open them if found. scinfo_directory is a location to look for the SC Info.sid? files. Remember to mount the Windows drive first, and take note of its assigned name once mounted. my $sid = iTunes::Sid( file => "SCINFOSIDB", REGDATAFILE => 'regdata' ); Read the Sc Info/Sc Info.sidb file using a key calculated from the regdata file created with the following Windows command file, run on the XP or Vista installation for which iTunes created its SC Info files: =========================================================================== @echo off rem file get_hwdata.cmd, run as "get_hwdata.cmd > \regdata" from Windows command prompt REG query "HKLM\HARDWARE\DESCRIPTION\System" /v SystemBiosVersion REG query "HKLM\HARDWARE\DESCRIPTION\System\CentralProcessor\0" /v ProcessorNameString REG query "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion" /v ProductId DIR C:\Windows\PROTOCOL.INI =========================================================================== See the examples directory also, and see the LINUX_HOWTO in the examples.
Not to be called directly-- this cleans up circular references, if any.
Read a file in for parsing.
Parse the data in the buffer.
$sid->WriteFile( file => "sidb2", $key => 'FIND', $iv => 'FIND' ); Write the (possibly modified) file to the filename given. $key and $iv are as in the new() method.
$sid->WriteFileEncrypted( file => "sidb2", $key => 'FIND', $iv => 'FIND' ); Write the (possibly modified) file to the filename given. The file is encrypted before writing (default is to use the key and iv used to decrypt originally).
Parse a container in the buffer position given.
Return the iTunes::Sid file type (sidb or sidd, etc).
Return an html tree structure for the Sid.
Dump data tree to a file, or to standard output by default.
my @list = $sid->FindAtom("key "); Find any or all atoms in the sid of a given type.
Get or set hardware ID (the MAC address OR a derived machine signature).
Get or set iv.
Get or set key.
Version of the sid file, from the vers atom.
Find the veeggie table and special shuffle case for the key's key.
Find and decode all the keys in the SC Info.sidb file.
Write all the decoded keys to files in the user's .drms directory file for use by VLC and compatible media players.
my $ok_check = check_encrypted_sid( $encrypted_sid_buffer ); Check an encrypted sid (in memory) for correct form to attemy decryption.
process_encrypted( $buf_ref, $key, $iv ); process_encrypted( $buf_ref, 'FIND', 'FIND' ); Process the memory referred to by the scalar reference $buf_ref to decrypt it using $key and $iv. Attempt to find $key and $iv if 'FIND' is specified, using iTunes 7 algorithms and local machine data.
my $key = get_sid_key( $mac ); Using iTunes / QuickTime based algorithms based on characteristics of the local machine, try to calculate the shuffled key for AES cryptography .
my $iv = get_sid_iv(); Return the default iTunes / QuickTime based iv for SC Info databases.
The following is intended for fair use of purchased music by the purchaser, not for piracy. In order to format the FairPlay keys used by iTunes for use by a music player such as VLC under Linux, the keys must be pulled from the SC Info.sidb file, translated using information in the SC Info. sidd file, and then written to a directory where VLC will read the keys for its use. Note that such use does not remove the DRM from the purchased music files themselves, but makes them far more useable under Linux, without resorting to Wine.
Procedure:
1. Set up a machine for dual boot under the iTunes installation OS (OS X or Windows). One partition is to boot OS X or Windows, another Linux. Make sure that your Darwin or NTFS partition is mounted at least for reading!
2A. (iTunes for Windows) Run the file ./examples/get_hwdata.cmd in the iTunes::Sid /examples directory in this distribution, which creates an output file as c:\regdata, as in
c:> get_hwdata.cmd Then reboot to Linux and mount the windows partion (it should be attached to /media/disk1/ or /media/disk2, etc). Run the file ./examples/get_keys_for_vlc.pl (the file pathname on line 10 may need to be changed to be directed to the output file of the Windows command file above).
2B. (iTunes for OS X) Dual boot may "just work" since the key is derived from the computer's LAN card MAC address. If attaching to the OS X machine over a network share, you may get the mac address of the source machine by running ./examples/print_mac.pl and redirecting this to a file, then copying that file to your home directory into a subdirectory called '.drms' and a file called 'mac' in that directory. iTunes::Sid will look for this file, and use it for the mac adddress if it finds that file.
3. Run the ./examples/get_keys_for_vlc.pl perl script to allow any DRM-laden iTMS purchases to play under VLC or other compatible media players.
If the above fails, you may be able to run the above under OS X or Windows, and then copy the drms directory and its keys to your linux home directory, renaming 'drms' to '.drms' and then run VLC to play music as usual. (The same must be done if the keys are generated under the /root account-- copy the /root/.drms directory to your home directory).
Initial setup almost requires a dual boot machine.
Searches for SC Info files are subject to file finding errors.
No doubt many others.
William Herrera ( wherrera@skylightview.com ).
Questions, feature requests and bug reports should go to <wherrera@skylightview.com>.
The U.S. Digital Millenum Copyright Act states in section 102, part (f): ----------------------------------------------------------------------- `(f) REVERSE ENGINEERING- (1) Notwithstanding the provisions of subsection (a)(1)(A), a person who has lawfully obtained the right to use a copy of a computer program may circumvent a technological measure that effectively controls access to a particular portion of that program for the sole purpose of identifying and analyzing those elements of the program that are necessary to achieve interoperability of an independently created computer program with other programs, and that have not previously been readily available to the person engaging in the circumvention, to the extent any such acts of identification and analysis do not constitute infringement under this title. `(2) Notwithstanding the provisions of subsections (a)(2) and (b), a person may develop and employ technological means to circumvent a technological measure, or to circumvent protection afforded by a technological measure, in order to enable the identification and analysis under paragraph (1), or for the purpose of enabling interoperability of an independently created computer program with other programs, if such means are necessary to achieve such interoperability, to the extent that doing so does not constitute infringement under this title. `(3) The information acquired through the acts permitted under paragraph (1), and the means permitted under paragraph (2), may be made available to others if the person referred to in paragraph (1) or (2), as the case may be, provides such information or means solely for the purpose of enabling interoperability of an independently created computer program with other programs, and to the extent that doing so does not constitute infringement under this title or violate applicable law other than this section. ----------------------------------------------------------------------
The portion of the DMCA quoted above allows usage of protected content to enable interoperability beween Linux and other systems. Therefore, since this package and related Perl code are primarily designed to allow Linux, Solaris, and Unix systems to achieve interoperability with iTunes and the iTunes Music Store, they ARE legal under the DMCA. We are somewhat concerned about the word "solely" in the text above, since this package works under OS X and Windows as well as Linux. For "solely" that reason, please also see the COPYRIGHT below.
Copyright (c) 2008 William Herrera. All rights reserved. Licensing Terms a) The terms of Perl itself, plus the following: b) UNDER NO CIRCUMSTANCES CAN THIS CODE BE USED FOR CIRCUMVENTION OF ANY TECHNOLOGICAL MEASURE WHICH EFFECTIVELY CONTROLS A PROTECTED MEDIA WORK UNDER THE DCMA (USA, 1998) OR EU COPYRIGHT DIRECTIVE (EUCD, ARTICLE 6, OF 2001), UNDER ANY OPERATING SYSTEM PLATFORM SUPPORTED BY APPLE COMPUTER CORPORATION FOR ITS ITUNES OR IPOD PLAYER SOFTWARE IN ANY APPLE CORPORATION DISTRIBUTED BINARY FORMAT OF ITUNES FOR THE PLATFORM UNDER WHICH THAT MEDIA IS TO BE PLAYED. AS OF 2008, PROHIBITED PLATFORMS INCLUDE THE IPOD, IPHONE, APPLE OS X, AND MICROSOFT WINDOWS, BUT NOT LINUX, BSD, OR SOLARIS. UNDER NO CIRCUMSTANCES CAN THE AUTHOR(S) OF THIS CODE BE HELD LIABLE FOR ANY INFRINGEMENT INVOLVING THE PROHIBITED PLATFORMS ABOVE. c) Use, storage, or distribution of this code implies that you accept that its intended purpose is legal and legitimate under any applicable US or EU law, as above, and agree that any and all risk as to the quality, performance, and legality of this code lies with you.
To install iTunes::Sid, copy and paste the appropriate command in to your terminal.
cpanm
cpanm iTunes::Sid
CPAN shell
perl -MCPAN -e shell install iTunes::Sid
For more information on module installation, please visit the detailed CPAN module installation guide.