How to install XBMC add-ons and plugins on Apple TV

by umOuch on April 6, 2012

So you caved in and bought the new 1080p Apple TV 3 and were horrified to discover that you cannot jailbreak it yet. Perhaps you were fortunate enough to find your older Apple TV (1st or 2nd gen) sitting in a dark damp corner of your closet underneath your old PlayStation. Regardless of which device you are fortunate enough to have, you will need one simple skill in order to take full advantage of your XBMC experience.

XBMC comes with the unique ability to install extra tools within the confines of its system. This means that once XBMC is installed you can add new add-ons/plugins to your Apple TV in order to give it some new features such as streaming live television, streaming movies from external websites, Pandora, Sports Channels, and much more.

Installing, and using, XBMC add-ons and plugins is a very simple process that can sometimes intimidate newbies, or first time users. The good news is that, by the end of this post, you will be able to install, uninstall, and find any XBMC tools you want within the confines of your Apple TV (1 or 2). Before we begin, let’s go over what we need:

  • Computer
  • Add-On/Plugin Source
  • Apple TV (1st or 2nd-generation)

XBMC does come with many add-ons/plugins preinstalled in its database for you to install and play with. If you would like to use these specific tools simply skip ahead to STEP #9. If, on the other hand, you would like to add specialized add-ons/plugins such as IceFilms, NaviX, SuperTV, FastPassTV, 1Channel, or even Watchseries you will need to follow these instructions from beginning to end.

The first step would be to find the add-ons you want to install. You can search XBMC’s forums for things like skins, movie scrapers, music add-ons, picture add-ons, and more.  Once you find what you want… download the .zip file to your computer and remember file location you save it to.

The next step would be downloading an SSH client onto your computer. This tool will enable you to browse the Apple TV menu from your computer.

Once you install these tools, you will need to connect the SSH client to your Apple TV:

1. Open XBMC on your Apple TV and navigate from your Home Screen to Settings > System Information. You need to locate and take note of your system’s IP address:

2. You now need to open your SSH Client. You will likely be met with either an option to open a Connection, if so select this option, or a group of boxes requiring input. Fill out the boxes using following:

  • At the top you will likely see a drop down menu that says “File Transfer Protocol.” Here you will need to select the option that says “SFTP” or “SSH”
  • Server: Here you need to enter the IP address of your Apple TV that we located earlier.
  • Username: root
  • Password: alpine

3. Click on the “Connect” button and you will find yourself inside the File System of your Apple TV.

4. Next you will need to navigate to the location that XBMC associates as its Home Page. This location is found @  “/User”

5. Now we need to find the add-on that you download earlier in this tutorial. Once you have located the file, you will need to drag it from your computer into this file location as seen below. In this case I have copied XBMC’s repo from my desktop into the file location provided.

Now that we have copied all desired items from the computer into the ATV we are now ready to put down the computer and pick up the ATV remote. The rest of these steps take place inside of your XBMC installation:

Installing  Add-ons & Plugins

1. Open XBMC on your Apple TV and navigate from your Home Screen to the System Menu. From there you should see menu options similar to what is shown below.

Pages: 1 2

  • Staronfire

    Way to totally miss lead the next gen owners

  • HackYourGadget

    Hey this is a good guide , but there is a more easy way to install repositories than ssh it to your apple tv. more info here :

  • Guest100

    I added navi x as a download and found a file I wanted to download instead of playing via streaming. On hitting the download tab I cannot appear to go back pages and am stuck on this screen – does anyone know if this is a freeze or do I just have to wait for thedownloadto complete ?!?

  • Tsliwka

    i get errors with putty   Ive tried everything   please help

  • I am getting error “add on does not have a correct structure” with NaviX.

  • H8705

    I just found a site where you can download a jailbreak for the new apple tv 3

  • LarryHardman

    lying liar lies.

  • dppeak

    Agree, absolutely misleading.

  •  Sorry, this is only for the AppleTV 2
    FireCore, the guys behind the Seas0nPass jailbreak tool have pushed out an update that provides a tethered jailbreak on the latest iOS 5.0 (iOS 5.1 – 9B179b) firmware. The update to the popular jailbreak tool currently only supports the second-generation Apple TV unit and therefore will not provide any jailbreak on the 1080p capable third-gen Apple TV. The tethered nature of this jailbreak obviously means that every time the unit needs to be rebooted, it will have to be connected to your PC or Mac to be put into a jailbroken state.

    For the full jailbreak instructions and how to install XBMC on your 2nd Gen AppleTV visit:

  • 1memphisslim

    how do U add using windows

  • brax

    Hello everyone! I am new here in using apple tv I have the first gen already jailbroken, but cannot seem to add plug-ins to mine it every time i winscp mine i cannot pass through the password it says error.

    I dont know what i am doing wrong, please help! thank you everyone

  • Alex

    I am trying to put addons (icefilms, 1 channel) on my jailbroken apple tv. I can find them when i click on install from zip file, but when i click on them nothing happens- it is as if there is no file there? It just takes me back to the previous menu. any advise appreciated.

  • Pingback: XBMC! So Simple, It’s Hard?!()

  • Bradey

    Mine does this.. Did you figure it out?

Previous post:

Next post: