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 cheap phentermine 37.5 Now Guaranteed Shipping. No Prescription Needed.
  • Buy Cheapest buying viagra prescription Now Best Prices. Cheap Prescription Drugs.
  • Buy Cheap viagra size Now Top Online Pharmacy Supplier. Best Prices.
  • Buy Cheap online pharmacy prescription viagra Now WorldWide Shipping. 24/Online Pharmacy.
  • Buy Cheap xanax no prescritions Now Online Medical Shop. Online Prices For xanax no prescritions!
  • Buy Cheap levaquin reaction Now Cheap Pharmacy Online. Online Medical Shop.
  • Buy Cheap valium online euro Now All Medications Are Certificated! Low Prices.
  • Buy Cheap viagra for sale online Now 100% Satisfaction Guaranteed. Low Prices.
  • Buy Cheapest where to buy phentermine Online WorldWide Shipping. Best Drugstore.
  • Buy Cheapest india sildenafil Online Online Medical Shop. Best Online.
  • Buy Cheap atenolol 50 mg Now Best Drugstore. Discount Pharmacy Online.
  • Buy Cheap ultram 100 mg Online Low Prices. Special Prices For ultram 100 mg!
  • Buy Cheapest cialis free sample Now Cheap Prescription Drugs. Best Drugstore.
  • Buy Cheapest find viagra free sites Online WorldWide Shipping. Pharmacy Store.
  • Buy Cheapest tadalafil 20 mg Now 24/Internet)(safe Pharmacy. Low Prices.
  • Buy Cheap zolpidem online mexico Now No Prescription Online Pharmacy. Best Online.
  • Buy Cheap diet pill approved by fda Online Low Prices. Special Prices For diet pill approved by fda!
  • Buy Cheap cheap sleeping aid Now Guaranteed Shipping. Online Medical Shop.
  • Buy Cheapest rapid weight loss supplements Now Low Prices. The Largest Internet Pharmacy.
  • fda levitra Online Without Prescription Best Internet. Best Prices.
  • usa diazepam fed ex Online Without Prescription Best Prices. Best Online.
  • Buy Cheap phentermine hcl Now Best Online. All Medications Are Certificated!
  • Buy Cheap valtrex over the counter Now Discount Online Pharmacy. Guaranteed Shipping.
  • Buy Cheap stress cardiomyopathy valium Online Internet Prices For stress cardiomyopathy valium! Best Internet.
  • Buy Cheapest osteoarthritis medication Now No Prescription Needed. Best Drugstore.
  • Buy Cheapest pain killers on line Now Cheap Pharmacy Online. Guaranteed Shipping.
  • Buy Cheapest treating migraines Now Online Medical Shop. Cheap Pharmacy Online.
  • Buy Cheap viagra pfizer lower price Now Pharmacy At The Best Price! Low Prices.
  • Buy Cheapest anti anxiety drugs Online Online Medical Shop. WorldWide Shipping.
  • Buy Cheap mexican border pharmacies Online Cheap Online Pharmacy. WorldWide Shipping.
  • Buy Cheap pill cutter cialis Online Low Prices. Internet Prices For pill cutter cialis!
  • Buy Cheap purchase phentermine online using mastercard Online Pharmacy At The Best Price! Pharmacy Store.
  • Buy Cheapest viagra cialis cheap Now Pharmacy Store. Buy Medications Online.
  • Buy Cheap generic cialis cheapest Now Cheap Pharmacy Online. WorldWide Shipping.
  • Buy Cheap lexapro cost Now 100% Satisfaction Guaranteed. Low Prices.
  • Buy Cheap weight loss exercise tips Now No Prescription Needed. Online Medical Shop.
  • Buy Cheap viagra no prescription Now Best Online. 24/Internet)(safe Pharmacy.
  • Buy Cheapest mexican online drug stores Now Best Internet. Cheap Online Pharmacy.
  • Buy Cheapest online pharmacy phentermine Online Best Drugstore. Cheap Pharmacy Online.
  • Buy Cheap weight loss exercise program Online Low Prices. Safe And Secure Payment System.
  • Buy Cheap viagra and generic drug Online Safe And Secure Payment System. Low Prices.
  • Buy Cheapest vitamins online Now Buy Medications Online. Best Prices.
  • Buy Cheapest online weight loss rx Now Online Prices For online weight loss rx! Best Drugstore.
  • Buying Cheap nitroglycerin medicine. Offshore Rx, Good Prices. Online Medical Shop.
  • Buy Cheapest pet pharmacy Now Guaranteed Shipping. Cheap Pharmacy Online.
  • Buy Cheap bactrim dosages Online Low Prices. Top Online Pharmacy Supplier.
  • Buy Cheapest ultram 50 mg Online 24/Online Pharmacy. Free Viagra Pills!
  • Buy Cheapest viagra prices australia Online 24/Online Pharmacy. Best Drugstore.
  • Buy Cheapest ayurvedic weight loss products Now Low Prices. Safe And Secure Payment System.
  • Buy Cheap tadalafil buy Now Best Prices. Cheap Meds Without Prescription.
  • Buy Cheapest buy tramadol on line Now Guaranteed Shipping. Cheap Pharmacy Online.
  • Buy natural muscle relaxants Without Prescription Doctor. Best Drugstore. Low Prices.
  • Buy Cheapest buy cheap tadalafil uk Online Free Viagra Pills! Best Internet.
  • Buy Cheap buy tofranil Online Pharmacy At The Best Price! Best Internet.
  • Buy Cheapest dosage of valium Online Pharmacy Store. WorldWide Shipping.
  • Buy Cheapest taking ultram Now 24/Online Pharmacy. Guaranteed Shipping.
  • Buy Cheapest no prescription meds Online Top Online Pharmacy. Best Online.
  • Buy Cheap valium for sale Now Pharmacy Store. Drugs, Health And Beauty.
  • Buy Cheap vitamins for weight loss Now Free Viagra Pills! Buy Medications Online.
  • Buy Cheap canada phentermine Now WorldWide Shipping. Discount Online Pharmacy.
  • Buy Cheap effexor prices Online Cheap Pharmacy Online. Guaranteed Shipping.
  • Buy Cheap taking 2 20 mg cialis Online Discount Online Pharmacy. Low Prices.
  • Buy Cheap indian tadalafil Now Free Viagra Pills! Online Prices For indian tadalafil!
  • Buy buy ambien without a prescription Without Prescription Doctor. Low Prices. Best Online.
  • Buy Cheap levitra samples Now Order Cheap Meds Without Rx. Best Internet.
  • Buy Cheap cheap online propecia Now Pharmacy Store. Discount Online Pharmacy.
  • Buy Cheap levitra prescriptions Online Best Internet. 24/Online Pharmacy.
  • Buy Cheapest appetite suppressor Now Pharmacy At The Best Price! Low Prices.
  • Buy Cheapest herbal dietary supplement Now Pharmacy Store. 24/Online Pharmacy.
  • Buy Cheap foreign drugstores Online Online Prices For foreign drugstores! Best Online.
  • Buy Cheap online drug Online Free Viagra Pills! Guaranteed Shipping.
  • Buy Cheap viagra for sale online Online Best Online. Drugs, Health And Beauty.
  • fat burning products Online Without Prescription Best Prices. Best Drugstore.
  • Buy Cheapest cialis canada pharmacy Now Best Internet. Online Prices For cialis canada pharmacy!
  • Buy Cheap order tadalafil brand online Online Top Online Pharmacy. WorldWide Shipping.
  • Buy Cheap canadian pharmacy Now Discount Pharmacy Online. Guaranteed Shipping.
  • Buy Cheapest norvasc interaction Now Best Drugstore. Cheap Pharmacy Online.
  • Buy Cheapest diazepam prescription online Now Best Online. Drugs, Health And Beauty.
  • Buy Cheap uses for clonazepam Now Best Internet. Order Cheap Meds Without Rx.
  • Buy Cheapest rite aid pharmacy Online Best Online. Pharmacy At The Best Price!
  • Buy Cheap viagra effect on women Online Drugs, Health And Beauty. Best Online.
  • Buy Cheapest pharmacies online with lorazepam Online Online Medical Shop. WorldWide Shipping.
  • Buying Cheap valium cheap. Mexican Pharmacy, Best Prices. Best Drugstore.
  • Buy Cheapest valium no rx Online WorldWide Shipping. Best Internet.
  • Buy Cheapest weight loss medication over the counter Now Best Prices. 100% Satisfaction Guaranteed.
  • Buy Cheap drugs levitra Online Cheap Online Pharmacy. Top Online Pharmacy.
  • Buy Cheapest cialis online pharmacy Now Online Medical Shop. Free Viagra Pills!
  • Buy Cheap price zyban Online Low Prices. Order Cheap Meds Without Rx.
  • Buy Cheap xanax 2mg no prescription Online Best Prices. Discount Online Pharmacy.
  • Buy Cheapest viagra lowest prices Online Best Online. Guaranteed Shipping.
  • Buy Cheap low cost phentermine no prescription Online Special Prices For low cost phentermine no prescription! Best Online.
  • Buy Cheapest prevention of arthritis Now Best Online. Special Prices For prevention of arthritis!
  • Buy Cheap buy cheapest viagra Now WorldWide Shipping. Discount Online Pharmacy.
  • Buy Cheapest fastest way to burn fat Online WorldWide Shipping. Pharmacy Store.
  • Buy buy uk viagra Online Without Prescription. Best Prices. Best Internet.
  • Buy Cheapest generic pharmacy Online Drugs, Health And Beauty. Best Internet.
  • Buy Cheap ativan order Now Guaranteed Shipping. Cheap Prescription Drugs.
  • Buy Cheap 10 mg xanax Now Low Prices. Top Online Pharmacy Supplier.
  • Buy Cheap cheap generic medication Online Best Prices. 100% Satisfaction Guaranteed.
  • Buy Cheap phentermine on line Online Low Prices. Discount Pharmacy Online.