How to jailbreak the new Apple TV using Pangu

By , Mar 23, 2016

Jailbreak Apple TV

Now that the Pangu Team has released their jailbreak for the new Apple TV, we have had some hands-on time with the tool and were successful in jailbreaking our own test device. In this post, we will share detailed step by step instructions on how to jailbreak the new Apple TV using Pangu. Before we get started, we must share a few words of caution.

Should you (could you) jailbreak your Apple TV?

We’ve touched on this on previous posts, but it’s important enough to remind users of the limitations of that jailbreak. Below are a few things you must take into account even before attempting to jailbreak:

  • This jailbreak is for the new fourth-generation Apple TV only
  • Your Apple TV must be running tvOS 9.0 or 9.0.1
  • This is an SSH-based jailbreak, which means there currently is no user interface
  • Benefits of jailbreaking are limited at this time, since there are no tweaks for the device just yet


Because this jailbreak is slightly different from what we are used to, there are a few pre-requisites that need to be met.

Hardware and software:

  • You need a fourth-generation Apple TV
  • This Apple TV must be on tvOS 9.0 or 9.0.1
  • You need a USB Type C cable
  • You must have Xcode on your Mac
  • You need an Apple development membership

As mentioned, this will also only work with tvOS 9.0 or 9.0.1. If you have already updated to 9.1 or 9.2, unfortunately there is no way to downgrade. Luckily, most Apple TVs being sold in Apple Stores are still on one of these two versions. If you check the serial number with this simple tool it will tell you when it was manufactured. As long as it was manufactured before December, you are good to go.

Now that we have some basic pre-requisites out of the way, let’s move along with instructions.

Jailbreaking Apple TV with Pangu

1) Download the latest version of Pangu from our Downloads page. Since this jailbreak uses Xcode, it is Mac only at the moment.

Screen Shot 2016-03-23 at 10.25.31 AM

2) To start, we will need to register our device. Plug in both the power cord, and the USB-C cable. To register, we need the UDID, which can get from launching Xcode, then navigating to Windows > Device and choose the connected Apple TV. It will appear as a long strand of characters. Copy that, or save it somewhere for the next step.

Screen Shot 2016-03-23 at 10.30.26 AM

3) Login to your developer account and visit the devices page. Register the Apple TV you would like to jailbreak by giving it a name, and entering the UDID we retrieved in the last step.

4) Once we have registered the device, we have to create an app ID to accompany the jailbreak. Visit the App IDs page and give it a name, and a bundle ID.

5) Those two pieces of information allow us to generate a mobile provision file. Visit the provisioning profiles page and choose tvOS development. Click next, choose your developer certificate, select the Apple TV(s) you would like to jailbreak, and download the file.

Screen Shot 2016-03-23 at 10.35.36 AM

6) Once downloaded, rename the file to embedded.mobileprovision and add it to the Apple TV jailbreak folder we downloaded from Pangu in step 1.

Screen Shot 2016-03-23 at 11.21.00 AM

7) To install, we need to get your team ID and common name. This can be found by opening Keychain Access, choosing certificates, and locating your developer certificate. We need the Common Name, and the Organizational Unit. The Organizational Unit will be your team ID.

8) Once you have that information we are ready to launch the install script. Swap the perimeters for the ones we located. So the blank version is: <udid> <bundleid> <team id> <common name id>

Then we swap in our information. The UDID of your device, the bundle ID of your app, the team ID and common name from Keychain. It should look similar to this: e5e2c931d4a94ecf71e12a88b0b4579b com.sample.tvjb 93AA45BBCC “iPhone Developer: test (ALI766JXB5)”

Screen Shot 2016-03-23 at 11.20.26 AM

9) This will install the Pangu app on your Apple TV, and you can launch that app to install the jailbreak. It will show a screen saying that it is jailbreaking, before restarting.

Screen Shot 2016-03-23 at 11.44.02 AMScreen Shot 2016-03-23 at 11.46.33 AM

So that’s it. You have successfully jailbroken your 4th generation Apple TV. Obviously this is aimed at developers and security researchers and offers no real GUI interface, it is promising for subsequent iterations. Keep an eye on iDB for more jailbreak news coming in the future.

  • Share:
  • Follow:
  • Abbe

    Waw finalllly 🙂
    Does it works with free Apple development?

    • Andrew O’Hara

      Working on the video to add to the post with instructions on how to using a free account, or a paid account. The process is slightly different.

      • Abbe

        ok super,
        Thank you!

      • m7rjb

        what happened with the free apple developer account video ?

  • Hussain Alsanona

    What can I do for ATV jailbreak ? Give me some examples!

    • So far, nothing. We’re gonna have to be patient and wait for devs to come up with cool stuff

    • There’s really no reason to jailbreak it considering you can side load applications these days.

      • O⃘t⃘i⃘s⃘H⃘u⃘f⃘f⃘

        A jailbreak isn’t only about apps.

      • There’s no need for themes on an appletv, so really it’s all about applications.

      • 9to5Slavery

        He’s not entirely talking about themes lol

      • tgwoo

        can i install kodi stable version on this if i jailbreak? currently i can only sideload the nightly-built which still buggy. on my old apple tv 2 i can use apt-get install org.xbmc.kodi and get stable version from SSH.

  • Bill

    Will we be able to add the jailbreak with ipwnstore? And further more will it stay after the signing expires?

    • Jamie Petro

      I see it has been added to the iPwnstore’s list of ipa’s Sucks that I had already updated to the latest beta build before hearing about the release of the jailbreak….

  • Markieze Mitchell

    I guess it’s finally time for me to purchase an apple tv.

    • Bill

      Make sure you get one on iOS 9.0 or 9.0.1

      • No. In this case it’s actually better to update rather than jailbreak.

      • Blip dude

        Booyah!!! Seriously, SSH?? Thanks but tvOS 9.2 has more to offer. I’ll just wait until there is more development.

  • Kenneth Delgado

    No tvOS 9.2 support and no installer, I’ll pass. ☹️

  • Gary le

    So i actually side loaded kodi 17.0 to my atv4 but is it possible to get something lower than 17.0? Maybe a jailbreak will let kodi 16.0 be installed in the future?

  • Martynet

    Reason to jailbreak Apple TV2 was Plex and KODI… But today, when we have Plex in the app store, light KODI Mr.MC and side loaded full KODI, I don’t see many other reasons to jailbreak ATV4… Any ideas?

    • Blip dude

      Themes, PiP, an actual Dark Mode, to name a few at least. I agree that a jailbreak is sort of pointless. . . For the time being. Which is I’m happy with my Open Box ATV 4 that came with 9.1 install and will be happy to update it to 9.2 as it will offer more than what a jailbreak currently does.

  • mariocampie17

    Does anyone know about this I just saw this now and I’m a little sketchy about it http://taig9. com someone help me out here.

  • Warren L Shafor

    Is there a way to update Kodi now with this new release?

  • George Diaz

    i got pangu app on the apple tv 4.. i opened it and it said jailbreak successful.. but then i went back to the home screen and i dont see KODI app.. how can i fix it .

  • Warren L Shafor

    FML i’m on 9.2 🙁

  • Dave Gingras

    cant register my atv4 , i have a free developer account but the only options i see is SDK and Bug Reporting.Certificates,identifiers & Profiles is not listed

  • Shawn Campbell

    i keep getting -bash: syntax error near unexpected token. can anyone help me