Sunday, January 08, 2012

Jailbreaking your Apple TV 2 to watch Hulu


Below are the steps I took to get Hulu up and running on my Apple TV 2 (hereafter referred to as ATV) using the latest firmware 4.4.4.

Since it took some effort to get all the steps right, I figured I'd try to save someone else some time and post the instructions here.

(Credit where credit is due: This post has been largely based on an anonymous post at the Firecore blog comments section.  That original post is available here:
The anonymous post was left at Tue Aug 30, 2011 6:51 pm, but was based on the 4.3 Firmware. So thanks to that anonymous poster!)

What you will need:

-Apple TV2 (Black)
 with aluminum remote.
-Mac

-Latest version of iTunes

-Latest version of Seasonpass from Firecore, available for free download here: http://support.firecore.com/entries/387605 
-A micro USB cable to fit the back of ATV
(This did NOT come with your Apple TV, and is required to connect the ATV directly to your computer so you can perform the jailbreak. You can get this online cheap. Or perhaps you already have such a cable. . . they are often sold with Blackberry phones. Just make sure it’s a “micro” cable, NOT a “mini” cable.  Here’s an example of one: http://www.amazon.com/gp/product/B001K7I62Q?ie=UTF8&tag=atfl-20&linkCode=as2&camp=1789&creative=390957&creativeASIN=B001K7I62Q  )

1. Download and install the untethered “Seasonpass” – Latest Version – from http://support.firecore.com/entries/387605.  This is the software that will “jailbreak” your ATV, so that you can install non-Apple software on it.  You can also read about this process to see what it does here: http://blog.firecore.com/6434
 
2. Run Seasonpass and follow instructions at this site: http://support.firecore.com/entries/387605 
This may take 20 minutes or so.  When you are done, read on below.

Your ATV is now jailbroken. (Don’t worry, if you decide you want to go back to the original factory settings, you can always go to “Restore” in the Settings section of your Apple TV.)

3. Hook your ATV back up to your TV and make sure it can successfully connect to the internet/your network. You should see a temporary Firecore emblem in the lower right corner of the menu, indicating the unit was successfully jailbroken.

Now you want to install some software on your jailbroken ATV. This will require the use of the Terminal app on your mac to SSH into your ATV.  For that you’ll need to know your ATV’s IP address.

4. On your Apple TV go to Settings à General à Network and note the IP address.  Should be something similar to 192.168.0.186

5. Open the Terminal application on your mac and type the following:
“ssh –l root 192.168.0.186” and hit return.
(Don’t actually type the quotes, just what’s inside them. And use the actual IP address of your particular ATV, which is likely different from the number I used above)

6. You will be asked for a password.  Unless you have changed it, the default password is “alpine”. You are free to change this later if you wish, using the command “passwd”.  But it’s not necessary.

7. Update apt sources - type “apt-get update”


8. Install NitoTV - type “apt-get install com.nito.nitoTV”

(NitoTV is a feature that allows you to easily install other programs on your ATV from the ATV’s menu system, so you won’t have to use the command line as much.)

9.  Type “killall AppleTV”.  This will restart the Apple TV menu system so you can see the new software (NitoTV) you just installed.

10. On your ATV, go to NitoTV and install XBMC, updatebegone, and openSSH.  XBMC is the Xbox Media Center software which will allow you to watch Hulu.  updatebegone stops the ATV from auto updating or nagging you about updating to the next Apple Firmware update, since you won’t want to update the firmware until the next jailbreak update comes out.  (Otherwise you’d lose your jailbreak when updating to the next Apple firmware.) OpenSSH just makes it easier to install the Hulu plugin for XBMC later.  (not completely sure that openSSH is necessary, but oh well)

XBMC has now been installed! But it’s not ready to stream Hulu just yet. . .

Now we need to install the bluecop repository, which is just a zip file containing “add-ons” that will augment XBMC and allow it to stream Hulu.  You can see a post about this plugin, with instructions on how to install it, here:

If you are savvy enough with SFTP and the command line to follow the instructions at the link above, go for it and you are done!  If you need a bit more explanation, see below.

11.  Download the .zip file for the bluecop repository from the above link to your mac.

12. In the terminal application on your mac, exit out of the SSH session you started earlier with your ATV by typing “exit”.  Then navigate to wherever the zip file you just downloaded is.  For example, if the zip file went into your Downloads directory, you would type: “cd” and hit return to change directory to your home directory, and then “cd Downloads” (and hit return) to go to your Downloads directory.  Make sure the zip file is in there by typing “ls repository*”.  This will display the file (full name is repository.bluecop.xbmc-plugins.zip) if it is there.  It will display nothing if you are in the wrong directory.

13. Type the following: “sftp root@192.168.0.186” (again, use the correct IP address) This sets up a SFTP: secure file transfer protocol session which will allow you to transfer the zip file from your mac to the ATV.

14. Type “cd /private/var/mobile/Media” (this will change directory to a Media folder on the ATV where XBMC will know to look for this zip file.)

15. Type “put repository.bluecop.xbmc-plugins.zip” (this will actually transfer the zip file from your mac to the ATV)

16. Type “quit” to exit SFTP.

17. On the ATV, go to XBMC.  Then go to System --> Add-ons --> “Install from zip file”


18. Browse to var/mobile/media (the folder where you put the zip file), find “repository.bluecop.xbmc-plugins.zip” and press OK (Bluecop is already enabled)


19. Go to System --> Add-ons --> get add-ons, find “bluecop Add-on Repository” click OK, choose video add-ons, find Hulu and install it. Note that after it is “enabled”, you can select the plugin again and select “configure” to enter your Hulu login information.  Whether you are a HuluPlus subscriber or just a user of free Hulu, the login can be handy because it allows you to configure your “subscriptions” (which shows you like) on Hulu.com via a computer and web browser, and then you can conveniently access just those subscriptions in XBMC on the ATV, instead of having to search or browse through thousands of shows using the remote.

20. Finally, back out to the front XBMC main menu and go to Videos -> Video add-ons. Find Hulu and enjoy (should work with both regular Hulu and Hulu Plus).

At this point you should be able to watch free Hulu on XBMC on your ATV! Life now has meaning.

P.S.: You may have noticed there are other video add-ons in the bluecop repository besides Hulu.  For example there is one that is supposed to let you watch Amazon OnDemand content, one for ESPN that claims to allow you to watch live streaming sporting events via ESPN.com on the ATV.  Feel free to install these and try them out for yourself.