Version 0.6.0
Abstract
I am, on prinipal, opposed to any DRM technology; I will fight it at every level. If you are so inclined, please read Appendix B, Law vs. Ethics for my full opinion on DRM. The hymn program is just one part of a larger fight against DRM; it frees my music so that it can be played anywhere I want to play it.
This document will show you how to use hymn to free your iTunes Music Store purchases from Apple's "FairPlay" DRM scheme.
INFORMATION WANTS TO BE FREE.
Table of Contents
Table of Contents
This chapter will tell you what you need to do to get your system set up to use hymn.
At the time of this writing, using hymn on Windows systems is easier than non-Windows systems. To use hymn on Windows systems you only need to have iTunes installed and have the computer authorized through iTunes to play all of the tracks you wish to decode. No other setup should be necessary.
At the time of this writing, using hymn on non-Windows systems is slightly more difficult than on Windows systems. In order to decrypt music tracks on a non-Windows sytem, you must have access to an Apple iPod portable music player. The iPod must be the one and only device connected to the FireWire (IEEE 1394) bus. Furthermore, all of the songs you wish to decode must have been copied to the iPod through iTunes using a computer authorized through iTunes.
On some systems, it may be necessary to set an environment variable that tells hymn your "iPod id". The environment variable is named IPODID and is the GUID of the connected iPod once it is mounted.
How to determine your iPod id:
- GNU/Linux
bash$ dmesg | grep ieee1394 | grep GUID- *BSD
(If you know, email me!)
Table of Contents
There are, as of this writing, two different user interfaces for hymn. There is a command-line interface (CLI) that works on most Unix-like platforms (Linux, OS X, *BSD, etc.) and Windows. There is also a graphical user interface (GUI) written using the Cocoa platform that works on Mac OS X.
In order to run hymn using the CLI, you must be somewhat familiar with command prompts in general. On Unix-like systems, there are generally programs called "terminal emulators" or "shell windows" that will allow you to type commands at a prompt using the keybaord. On Windows systems, there is a command processor called CMD.EXE. The hymn command syntax is as follows:
hymn [-l n] [-x ext] [-v] {file1} [[file2 ... fileN]] [destdir]
- -l n
The hymn program has some built-in logging facilities that allow you to monitor the progress of what is going on. These logging messages may aid in debugging why hymn may not be working in your environment. The logging level can be set to a number between 0 (no logging) and 5 (maximum logging) and defaults to level 1.
- -x ext
By default, the output file(s) will be written with a .m4a file extension. This option allows you to override that default and specify any extension you want (such as mp4, aac, etc.)
- -v
Display version and copyright information about the program.
To use the Mac OS X GUI, simply double-click the application icon to load hymn. You will be presented with a window with a status bar at the top, a progress meter, an empty text pane and a few action buttons.
![[ Mac OS X (Cocoa) GUI Screenshot
]](cocoa_ui-screenshot-predrag.png)
Use of the GUI is fairly straightforward. Find the .m4p files on your disk that you'd like to convert. When you've found them, drag them onto the hymn window. When you do so, the songs you dragged will be listed in the text pane and the Convert and Clear buttons will become enabled.
![[ Mac OS X (Cocoa) GUI Screenshot
]](cocoa_ui-screenshot-postdrag.png)
At this point, you can either drag more files onto the window, convert the listed files, or clear the listed files and start over. Once you have the files listed that you wish to convert, click the Convert button. After you do so, the conversion process will begin, giving you status updates along the way.
![[ Mac OS X (Cocoa) GUI Screenshot
]](cocoa_ui-screenshot-converting.png)
After the songs have finished converting, the Convert button will become disabled and hymn will tell you it has finished converting the files. At this point, you can either drag new files to be converted or quit the program.
![[ Mac OS X (Cocoa) GUI Screenshot
]](cocoa_ui-screenshot-done.png)
If errors occurred during the conversion, they will be displayed in the status bar in red. See Chapter 3, Troubleshooting for help with correcting these errors.
![[ Mac OS X (Cocoa) GUI Screenshot
]](cocoa_ui-screenshot-error.png)
This chapter is meant to give more in-depth technical info when things don't go as expected. It lists all of the known error messages, what they mean, and how to attempt to resolve them.
- 3.1. Couldn't open file: <filename>
- 3.2. Couldn't determine file size of <filename>.
- 3.3. Couldn't allocate <size> bytes.
- 3.4. Tried to read <size> bytes, read only <size>.
- 3.5. Couldn't write file: <filename>
- 3.6. Couldn't find iTunes key or an iPod.
- 3.7. Couldn't get DRM key for user.
- A.1.1. On which platforms does hymn work?
- A.1.2. Can I use hymn on a non-Windows platform without an iPod?
- A.1.3. hymn runs fine, but the files it outputs crash iTunes / Winamp / Quicktime, etc. What's wrong?
- A.1.4. My iPod is not detected properly. What's wrong?
- A.1.5. The kbps seems to have dropped from 128kbps to somewhere between 125kbps and 127kbps. Is this okay?
- A.1.6. Why aren't the iTunes copyright and "explicit -- parental advisory" tags copied?
- A.2.1. Why are you trying to promote music "piracy"? Shouldn't musicians make money, too?
- A.2.2. But if you don't promote "piracy", why release the program to the public and not just use it for yourself? After all, don't you know that people will misuse it?
- A.2.3. Aren't you afraid of being prosecuted under the DMCA?
| A.2.1. | Why are you trying to promote music "piracy"? Shouldn't musicians make money, too? |
First of all, I buy all of my music. In fact, most of the music I buy these days comes from the iTunes Music Store. However, I want to be able to play the music I buy wherever I want to play it without quality loss, since I PAID FOR that quality. I want musicians to make money. I want Apple to make money. I don't condone sharing music through P2P networks with the masses, though I believe making a mix CD or playlist for a friend is okay. I also think the RIAA are a bunch of crooks, but that's another story. Secondly, hymn leaves the apple ID embedded in the output file, so anyone who shares the decoded files on P2P networks is bound to be prosecuted under copyright law. | |
| A.2.2. | But if you don't promote "piracy", why release the program to the public and not just use it for yourself? After all, don't you know that people will misuse it? |
I believe there are other people who want to use my program legitimately, just as I use it. I don't believe the majority of the people who use my program will use it so that they can share their files on Kazaa, especially since their apple ID is embedded in the files. Anyway, in order to use my program, you had to pay for music on the iTunes Music Store to begin with. These are the people who are willing to pay for their music. Besides, should a baseball bat manufacturer stop manufacturing baseball bats just because someone may use the baseball bat to beat another person's head in? | |
| A.2.3. | Aren't you afraid of being prosecuted under the DMCA? |
Yes. That's why this is an anonymously developed project. However, I didn't actually write the code that cracks the DRM. Other people did. I'm just using their code in my program. So, technically, I'm not violating the DMCA. |
- A.3.1. I'm not a developer. Will there be a binary release soon so I don't have to try to compile this program to use it?
- A.3.2. Are there plans for a GUI frontend for my platform?
Many people want to buy music in a pure digital format. They would rather buy an album or a song online to save themselves the trouble of "ripping" a CD to a compressed digital format. Every time a new technology comes along that will make copying music easier, the people who depend on the revenue stream of music sales accept the technology in three phases:
Attempt to fight it through legislation.
Attempt to fight it with technology.
After (1) and (2) have failed, figure out a way to make money from it
This time around, the phases all got blended together. When the idea of internet music distribution was first popularized with the MP3 format, the recording industry (RIAA) panicked. They lobbied congress to outlaw MP3 players. At the same time, they tried to create technology that would limit the ability to copy such songs (DRM technology). Then, at the same time, they crafted a law called the DMCA that would make it illegal to try to circumvent copy-protection technology. Shortly after that, they began trying to capitalize on the new technology (internet music distribution) in order to create new revenue streams. And at the same time as that, they have started a public relations war calling friends who share music "pirates" as if people are raping and pillaging.
This time around it is different. The DMCA passed in the United States. There is a treaty called the WIPO treaty that enforces copyrights across national borders. At the same time, they have managed to convince most consumers that people who share music with their friends are "pirates" and that DRM is in their best interests. It is not
I wrote hymn because I, on principal, disagree with DRM. Although I clicked "accept" when presented with Apple Computer's license agreement for the iTunes Music Store, I did not do so because I accepted it. I did it because I wanted to buy music in a high-quality format without the inconvenience of plastic, paper and a bunch of songs I didn't want. Although according to the DMCA I am in the wrong, I do beleive that I am ethically in the right. I will never "accept" DRM. I will fight it through technology and activism. It is just plain wrong. We, the consumers of music are not pirates, criminals, enemies or terrorists, despite what the public relations campaign of the RIAA would have people believe.
- AudioCoding.com
(http://audiocoding.com/) This project is responsible for the FAAD2 library the source code of which I used as a reference while trying to figure out the Protected AAC file format.
- MPEG4IP
(http://www.mpeg4ip.net/) This project is responsible for the MP4v2 library that was used by early versions of hymn. It is no longer used.
- m4p2mp4
(http://www.techfreaks.org/utilities/m4p2mp4.zip) The source code for the first version of hymn was derived from a Windows-only program called m4p2mp4.
- VideoLAN
(http://videolan.org/) This project is responsible for the VLC Media Player that was the first end-user software to include support for decrypting protected AAC files. The code in hymn that reverse-engineers the DRM is kept in sync with the VLC project.
- Jon Lech Johansen
(http://nanocrew.net/) Jon is the person who first reverse-engineered the FairPlay DRM scheme. He is more widely known for his work on DeCSS, which was a program that allowed DVDs to be played on unsupported devices and operating systems, such as Linux. He is also a VideoLan developer.
- Apple Computer
(http://www.apple.com/) Apple creates excellent products. OS X is the most usable commercial operating system I've ever experienced. The iPod is great little device. The iTunes Music Store is a great way to buy music. Technologically speaking, I am enamored with almost everything they do. Ethically / legally speaking, however, they are (unfortunately) just as bad as most other big corporations.