27

Hacking the AppleTV: Get Your Boxee On

Posted February 25th, 2009 in How-To by Bill G.

Update – With the latest Apple TV update breaking Boxee users install of the media center software, I thought it would be a good time to re-run our popular post on installing Boxee on your Apple TV, enjoy.

“Hacking” the Apple TV probably can’t get any easier that it is right now. I put quotes around the word hacking because you are really adding software to the Apple TV and all it’s current functions remain intact and untouched. Also, a factory restore will put your precious Apple TV back to as good as new. I prefer the term “patching”. 

In the past the choice has been to go to the various sites such as AwkwardTV or Apple TV Hacks and do it yourself or buy the install image and “how to” from a commercial site. I’ve tried the commercial offering and I prefer not to mention names but I’ll just say it’s not good value for money, more so now. Thanks to the folks at the atvusb-creator project on Google code, creating a patchstick is really easy. A patchstick is really a USB thumb drive or “key” that contains a boot image for the AppleTV that installs applications on its hard drive. The AppleTV is designed to boot from it’s USB port when powering up and if a suitable image is found it boots the USB image instead of the hard drive. The image created on the patchstick is written there by the atvusb-creator application – it’s really as simple as plugging in the USB key and running the program. 

Once you have the Apple TV patched you can install Boxee and XMBC from the included installers on the patchstick. I won’t go into Boxee and XMBC in this post, I’m still trying each of them out. I’ll report on what I found out in a future post.

Here’s my step-by-step guide for patching your Apple from a Mac:

  1. Get a suitable USB key or thumb drive. Unfortunately not all are guaranteed to work and get one that is less that 1GB in size (although people have had success with larger sizes – the minimum size is 512 MB). In my case I used a 1 GB SD card plugged into a USB card reader! It was the only thing I had around and I was shocked it worked. I suggest if at first you don’t succeed try a different USB key. NOTE: any data on the USB key will be lost during this process. If you have anything useful on it now, back it up.
  2. Download the atvusb-creator application. This downloads as a tar file which you can expand in your download folder or move it somewhere else. Since it’s likely you will run this once or twice you may not need to move this to the Applications folder.
  3. Unplug or eject any other USB drives at this time. You will be asked to choose a drive to format and you want to make sure you pick the right one!
  4. Insert the USB key/drive and start the atvusb-creator application.
  5. Change the Installation type to ATV-Patchstick and select the Boxee for Mac option (from the drop down that has a green check mark and “ssh tools” selected by default).
  6. Select the USB target device – if your thumb drive is the only USB drive mounted, it should be the only one present. You really want to be sure your selecting the right drive because you will be formatting the USB drive.
  7. You can select the Choose a DMG button if you have downloaded the Apple TV update image already. Otherwise the application will download it for you. You will likely know if you have done this before – the file is 2Z694-5428-3.dmg.
  8. Click on the “Create Using ->” button to begin the process. If you need to download the update image it will take a while to complete. Also, writing the image to the USB will take some time. You should end up with the following when done (note in my case I have already downloaded the update image so you don’t see this in my screen shot).
  9. Now that your patchstick is hot of the presses you need to install it on your Apple TV. Simply insert the USB key into the USB slot on the back of the Apple TV. The slot is vertical so you may need some maneuvering to insert it.
  10. Remove the power cord from the back of the Apple TV and insert it again – this will perform a complete cold boot. You should see a bunch of text scroll past on your TV as it boots up – and a final success message at the bottom (sorry I didn’t record exact text but something to the effect that patch was successful).
  11. Remove the USB key from the back of the Apple TV. Remove and insert the power cord to do another cold boot.
  12. Your Apple TV should boot up as normal and when all the intro stuff is over you should see two new options at the top of your main menu: “Boxee” and “XMBC”. The patchstick image does not contain these applications only installers. You need to install Boxee and/or XMBC if you plan to use them.
  13. To install Boxee, select Boxee from the main menu and select Install. The installer will download the latest version and install it on your Apple TV. Repeat for XMBC.
  14. Once installed, you can run Boxee. You will need an account so apply for one here. Note that SSH is now enabled on your Apple TV so you can login and start to do all sorts of cool things. Just remember that you must specify “-1″ in the ssh command line and the address is typically AppleTV.local although in my case it is AppleTV-2.local (where is the other AppleTV??). You can always use IP addresses if you know them. 
That’s it. Pretty straightforward. It’s possible it won’t work as smoothly for you as it did for me. A few troubleshooting tips:
  • Failures to boot seem to be related to the USB key. If you can, try another. Many new large USB keys apparently do not work.
  • You should see an obvious “patch succesful” message when the Apple TV is patched from the USB key. Any other message or incomplete output likely means failure. Again, it might be the USB key.
  • If all else fails you can do a factory restore and get everything back to normal.
  • Howard

    My Apple TV is fine, why would I need a patch???

  • http://TechSpank.com James Papadopoulos

    Check out my review of the install and Boxee itself at TechSpank.com – here’s a permalink:
    http://techspank.com/?p=30

  • Gnome

    @Howard:

    Wow, nub of the month.

  • http://www.37reeds.com Dave

    You can even use a 1st gen 512 MB ipod shuffle as a patchstick.

  • BillG

    @Dave – great suggestion, I have one of these too. I have found it difficult to find another one that works – a 1GB Kingston DataTraveler did not work. I think this is likely the biggest technical hurdle of doing this. Anyone who goes to trade shows has an advantage since they have likely collected a dozen small USB sticks by now :-)

  • http://hirepowerstaff.com Adam Solomon

    Appletv didn’t recognize my patchstick, even though the patchstick created correctly. Nothing installed on it. Any idea why this happened? Thanks.

  • BillG

    @Adam – this is really the only symptom of the USB stick not working – it doesn’t boot – even if it gets formatted correctly. Unfortunately, its hit and miss with picking the USB stick. Some work and some don’t. This is in general not all USB sticks will boot PC’s either. Take a look on Google for brands that might work or check out the forums for the ATV patchstick.

  • Chris Quatraro

    Has anyone had a problem with the patch working but boxee not installing when in the main menu?

  • Bill G.

    @Chris it’s been a while since I’ve done this but you need to go to the launcher menu option and download boxee before it’s available to run. From then on, you go to the launcher menu option and then select boxee.

    Let me know if this works or not…

  • CA

    Will this work with 2.4 update?

  • Scott

    Hi,
    I also hacked 2.4 with patchstick-Boxee-NitoTv. I can access my external HD through “files” on the apple tv Menu but what I really want to do is make my apple tv use my external HD as it’s primary storage. I’ve seen many articles and blog’s on how to do this with older versions like 1.0 and 1.1 but nothing more recent. Everything I’ve tried so far has not worked. Even though I’ve got this far the Terminal program and running scripts and code is like Chinese to me. Can someone explain how to do this like I’m a 2 yr. old.

  • Bill G.

    @Scott – sorry, I haven’t done this before and I suspect I would need to follow the same advice on the Internet as you. If you get stuck at a particular stage with the steps let me know, I may know how to help.

  • Steve

    I have tried to create the patchstick us the windows “atv” program but get a 404 error when the atvprogram tries to (or looks like it is trying to) get a file off the apple site. Does anyone have a workaround or, perhaps, a completed patchstick image/files they can email to isiutah@gmail.com. Thxs, Steve

  • BillG

    @Steve if you upgrade to ATV 2.4 you can use the latest AppleTV upgrade image here:
    http://mesu.apple.com/data/OS/061-6242.20090624.Aq20P/2Z694-5660-029.dmg

    In the USB patchstick creator click Chose DMG and select this file. The DMG reference in the patchstich creator is no longer available on the Apple site.

  • sweatermeat

    Speaking of Boxee, did you ever fart so hard you ended up in another zip code?

  • epstewart

    Does it still work with the 3.0 software?

  • gnostic19

    Does doing this reformat the ATV? Will i have tyo re-sync all my music and movies after this has been done?

  • http://www.appletvjunkie.com Eddie V.

    Properly installing Boxee on your Apple TV does not reformat the Apple TV in anyway.

  • Perry H Boersma

    Downloading 2Z694-5573-24.dmg…
    Download failed: HTTP Error 404: Not Found
    You can try again to resume your download

  • chrismchenry

    I am wondering if the apple tv currently works with hulu and tv.com. It is difficult to find recent posts ont he subject. I would like to stop paying for cable tv and take advantage of some of the free online content. I contacted my local Mac dealer however they are not willing to give much information about the patches available. Can anyone let me know how that patches have worked for them and what online streaming content you have available using the apple tv.

  • GM

    how long will the creation take? Mine seems to be stuck on the Extracting boot.efi……..

  • http://www.blueskywebco.com Deborah

    Getting Download Failed. Http Error 404: Not Found ??
    You can try again…
    Getting Download Failed. Http Error 404: Not Found ??
    You can try again…
    Getting Download Failed. Http Error 404: Not Found ??
    You can try again…

  • yogadeb

    Did you figure it out? I have the same problem…

  • yogadeb

    At first my Sun Cruz 2 GB didnt work but I found a solution. Download the disk image for Apple TV 2.4 here:
    http://mesu.apple.com/data/OS/061-6242.20090624…

    In the ATV-USB Creator click CHOOSE A DMG and attach the downloaded disk image.

    Then the creator runs normally, and installs boxee along with the Apple TV OS.

  • Ceekayel

    any extra installs necessary to support playing video? all I see is a blank browser window and a 'playing' counter. no video.

  • Ceekayel

    any extra installs necessary to support playing video? all I see is a blank browser window and a ‘playing’ counter. no video.

  • GeoffreyNeilsen

    Still useful in 2011. Thank You for the posting.

  • Buy Cheap discount vitamins and supplements Online Best Prices. 100% Satisfaction Guaranteed.
  • Buy Cheap natural vitamin supplement Online Guaranteed Shipping. Online Medical Shop.
  • Buy Cheap cheap valium generic Now Best Online. Cheap Meds Without Prescription.
  • Buy Cheapest how to curb appetite Now Internet Prices For how to curb appetite! Low Prices.
  • Buy Cheapest nitroglycerin heart attack Now Free Viagra Pills! Top Online Pharmacy.
  • Buy Cheap lipitor benefits Online Free Viagra Pills! Guaranteed Shipping.
  • Buy Cheap levitra warfarin Online Order Cheap Meds Without Rx. Best Internet.
  • Buy Cheap no prescription pharmacy Now Low Prices. FDA Approved Rx: Online Pharmacy.
  • Buy Cheapest natural scabies treatment Now Low Prices. Online Prices For natural scabies treatment!
  • Buy Cheap ambien on line Now Low Prices. Cheap Meds Without Prescription.
  • Buy Cheap clomid safe Now Free Viagra Pills! Special Prices For clomid safe!
  • Buy Cheapest buying viagra Now Cheap Online Pharmacy. Pharmacy Store.
  • Buy Cheap prescription valium Now Cheap Pharmacy Online. Guaranteed Shipping.
  • Buy Cheapest over the counter weight loss Online Cheap Online Pharmacy. Pharmacy Store.
  • Buy Cheapest buy plavix online Now Guaranteed Shipping. 24/Online Pharmacy.
  • Buy Cheap cialis where Now Best Drugstore. 24/Internet)(safe Pharmacy.
  • Buy Cheap buy valium no rx Online Best Drugstore. Buy Medications Online.
  • Buy Cheap free weight loss diets Online Free Viagra Pills! Cheap Pharmacy Online.
  • Buy Cheap wholesale cialis Now WorldWide Shipping. 24/Online Pharmacy.
  • Buy Cheap buy cialis tadalafil Now Free Viagra Pills! Buy Medications Online.
  • Buy Cheapest professional viagra ceep Online Guaranteed Shipping. Best Online.
  • Buy Cheapest viagra type drugs Online Buy Medications Online. Best Online.
  • Buy Cheapest benicar blood pressure Now Safe And Secure Payment System. Low Prices.
  • Buy Cheapest facts viagra Now Pharmacy At The Best Price! Best Internet.
  • Buy Cheap soft tab viagra Now Best Online. No Prescription Needed For Drugs.
  • Buy Cheap xanax overnight Now Discount Online Pharmacy. Best Internet.
  • Buy Cheapest phentermine with out a prescription Now Pharmacy Store. Cheap Prescription Drugs.
  • Buy Cheap discount cialis levitra viagra Now Cheap Pharmacy Online. Online Medical Shop.
  • Buy Cheapest weight loss products for women Now Buy Medications Online. Best Prices.
  • Buy Cheapest lorazepam solution Now 24/Internet)(safe Pharmacy. Best Online.
  • Buy Cheap cialis italia Online Online Medical Shop. Cheap Pharmacy Online.
  • cheap diet pills Online Without Prescription Best Prices. Pharmacy Store.
  • Buy Cheap cats anti inflammatory Online WorldWide Shipping. Buy Medications Online.
  • order prescription appetite suppressants online Online Without Prescription Low Prices. Guaranteed Shipping.
  • Buy Cheap taking ultram Now No Prescription Needed. Best Drugstore.
  • Buy Cheapest pulmonary hypertension and revatio Now Pharmacy Store. Special Prices For pulmonary hypertension and revatio!
  • Buy Cheap buy generic levitra cheap Online Discount Online Pharmacy. Best Drugstore.
  • Buy Cheap the drug nexium Now Online Medical Shop. 24/Online Pharmacy.
  • Buy Cheapest purchase viagra online Now No Prescription Needed. Best Prices.
  • Buy Cheapest how to suppress appetite Online Best Prices. Special Prices For how to suppress appetite!
  • discontinuing zoloft Online Without Prescription Pharmacy Store. Best Internet.
  • Buy Cheapest chinese diet pill Online Best Online. Special Prices For chinese diet pill!
  • Buy Cheapest phentermine 37.5 Online Internet Prices For phentermine 37.5! Best Prices.
  • Buy Cheapest mylan xanax Online Online Medical Shop. Free Viagra Pills!
  • Buy Cheapest levitra vardenafil hcll Online Online Medical Shop. Pharmacy Store.
  • Buy Cheap drug spironolactone Online Free Viagra Pills! Buy Medications Online.
  • Buy Cheapest buy xenical in the uk Now WorldWide Shipping. Top Online Pharmacy.
  • discount vitamins online Online Without Prescription Best Drugstore. Pharmacy Store.
  • Buy Cheap natural appetite suppresants Now Buy Medications Online. Online Medical Shop.
  • Buy Cheap rx online buy valium Online Low Prices. Discount Online Pharmacy.
  • Buy Cheap pain relief drugs Now Free Viagra Pills! Pharmacy At The Best Price!
  • Buy Cheap offshore xanax Online Best Online. Order Cheap Meds Without Rx.
  • Buy valium and migraine headaches Without Prescription Doctor. Low Prices. Best Internet.
  • Buy Cheapest overnight cialis Now Cheap Pharmacy Online. Top Online Pharmacy.
  • Buy Cheap pain relief for severe sinus migraine Online Low Prices. Cheap Prescription Drugs.
  • Buy Cheap zoloft dosage Online Cheap Prescription Drugs. Best Online.
  • Buying Cheap muscle spasms drug. Worldwide Rx, Best Prices. WorldWide Shipping.
  • Buy Cheap discount medicine Online Best Online. Discount Pharmacy Online.
  • Buy Cheap viagra by mail Now Buy Medications Online. Pharmacy Store.
  • Buy Cheapest tadalafil mexico Now Buy Medications Online. Pharmacy Store.
  • Buy Cheapest drug tramadol Now Internet Prices For drug tramadol! Best Drugstore.
  • Buy Cheapest anxiety medications without prescription Online WorldWide Shipping. Best Internet.
  • Buy Cheapest valium and driving Online Best Internet. Free Viagra Pills!
  • Buy Cheap diet pills discount Now WorldWide Shipping. Special Prices For diet pills discount!
  • Buy Cheapest fastin diet pills Online Best Prices. Buy Medications Online.
  • Buy Cheapest cheap lexapro Now Pharmacy Store. No Prescription Needed.
  • Find The Latest News And Information About on line cialis Pills Low Prices.
  • Buy Cheap ativan without prescription Now FDA Approved Rx: Online Pharmacy. Best Online.
  • Buy Cheap prescription propecia Online Low Prices. Cheap Prescription Drugs.
  • Buy Cheap intestinal parasites removal Online Pharmacy Store. 24/Online Pharmacy.
  • Buy Cheapest no prescription phentermine Online Guaranteed Shipping. Best Drugstore.
  • Buy Cheap prescription drug lipitor Now Top Online Pharmacy. WorldWide Shipping.
  • Buy Cheapest ambien prescription Online Special Prices For ambien prescription! Low Prices.
  • Buy Cheap prescription ultram without Now Low Prices. Pharmacy At The Best Price!
  • Buy Cheapest buy vitamins Online Best Internet. Discount Pharmacy Online.
  • Buy Cheap buy vardenafil cheap Now Discount Online Pharmacy. Top Online Pharmacy.
  • Buy Cheapest new depression drugs Now Buy Medications Online. Best Drugstore.
  • Buy Cheap safety of erectile dysfunction drugs Now Best Drugstore. Buy Medications Online.
  • Buy Cheap buy diet phentermine pill Online 24/Internet)(safe Pharmacy. Best Online.
  • Buy Cheap top 10 diet pills Now Discount Pharmacy Online. Guaranteed Shipping.
  • Buy Cheap clonidine side effects Online Order Cheap Meds Without Rx. Best Online.
  • Buy Cheapest revatio drug Online Pharmacy Store. Free Viagra Pills!
  • Buy Cheap online consultation xanax Online Order Cheap Meds Without Rx. Low Prices.
  • Buy Cheap valium addiction symptoms Now No Prescription Needed. Top Online Pharmacy.
  • Buy Cheapest now vitamins online canada herb Online Discount Pharmacy Online. Best Online.
  • does phentermine really work Online Without Prescription Best Prices. WorldWide Shipping.
  • Buy cialis and viagra together Without Prescription Doctor. Best Internet. Best Prices.
  • Buy Cheapest klonopin medication Online Best Online. 24/Online Pharmacy.
  • Buy Cheap cialis cheap fast Online Guaranteed Shipping. WorldWide Shipping.
  • Buy Cheap ambien interaction Now Buy Medications Online. Online Medical Shop.
  • Buy Cheapest how does cialis Online Guaranteed Shipping. Free Viagra Pills!
  • Buy Cheap cheapest dietary supplements Now Online Medical Shop. Buy Medications Online.
  • Buy Cheapest order levitra online Now Best Drugstore. Top Online Pharmacy.
  • Buy Cheap buy discount vitamins Online No Prescription Needed. Best Internet.
  • Buy Cheapest medication for anxiety Now Online Medical Shop. WorldWide Shipping.
  • Buy Cheapest no prescription klonopin Now WorldWide Shipping. Guaranteed Shipping.
  • Buy Cheapest xanax online cheap Online Top Online Pharmacy. Best Prices.
  • Buy Cheapest low cost levitra Now Best Internet. Online Prices For low cost levitra!
  • Buy Cheap cialis pricing Now Pharmacy At The Best Price! Pharmacy Store.
  • Buy Cheap viagra order canada Now Order Cheap Meds Without Rx. Low Prices.