Repository navigation
Apple TV 2 and 3
Legacy iOS Kit supports restoring, jailbreaking, and booting SSH ramdisks on the Apple TV 2 and Apple TV 3, along with other device-specific utilities.
Using a genuine Apple Remote is recommended for the jailbreak procedure. While it is possible to jailbreak the device without one, this requires an additional step involving a DFU IPSW restore.
For AppleTV3,1 devices, additional hardware is required to use checkm8-a5.
There are several things you can do with these supported Apple TV devices using Legacy iOS Kit. The following sections cover the available jailbreak methods and other utilities.
Credit goes to NSSpiral for blackb0x and the resources it provides, which are utilized by Legacy iOS Kit.
- Entering DFU mode
- Jailbreaking with ramdisk
- Verifying the jailbreak
- Connecting to SSH over Wi-Fi
- Jailbreaking with a custom IPSW
- Jailbreaking without a genuine Apple Remote
- Post-jailbreak setup
- Activating Apple TV 2
- Entering kDFU mode
- Booting an SSH ramdisk
For instructions on how to put your Apple TV into DFU mode, refer to this guide by ElcomSoft: https://blog.elcomsoft.com/2022/10/how-to-put-apple-tv-3-2012-2013-apple-tv-hd-2015-and-apple-tv-4k-2017-into-dfu/
Follow the instructions for the Apple TV 3.
This method uses a ramdisk to jailbreak the device. A genuine Apple Remote is required to enter DFU mode during the procedure.
The device must be running 12H1006 or 10B809. You can check by going to Settings -> General -> About.
- Launch Legacy iOS Kit:
./restore.sh
- Select Jailbreak Device from the main menu.
- Follow the instructions to enter DFU mode and pwned DFU mode.
- Wait for Legacy iOS Kit to complete the jailbreak. The device will reboot once the process is finished.
- Disconnect the USB cable to allow the Apple TV to boot normally.
You can verify whether the device has been successfully jailbroken by attempting to connect to its SSH shell over USB.
- Connect the Apple TV to your computer using a micro-USB cable.
- Launch Legacy iOS Kit:
./restore.sh
- Navigate to Data Management -> Connect to SSH.
- If the device is jailbroken and SSH is accessible, Legacy iOS Kit should proceed to an SSH shell.
Note for 10B809: The SSH connection may fail even if the device is already jailbroken. If this happens, reboot the Apple TV by navigating to Misc Utilities -> Restart Device, then try connecting to SSH again.
You can also connect to your jailbroken Apple TV over Wi-Fi without keeping it connected to your computer via USB.
Make sure the Apple TV is connected to a Wi-Fi network first. You can find its IP address under Settings -> General -> About.
- Launch Legacy iOS Kit without connecting a device:
./restore.sh --no-device
- Navigate to Data Management -> Connect to SSH.
- Enter the SSH password and the Apple TV's IP address when prompted.
- If the device is jailbroken and SSH is accessible over the network, Legacy iOS Kit should proceed to an SSH shell.
This method involves creating and restoring a custom IPSW to jailbreak the device.
- Launch Legacy iOS Kit:
./restore.sh
- Select Restore/Downgrade.
- Choose the appropriate firmware for your device:
- AppleTV2,1: 6.1.4
- AppleTV3,1: Latest iOS (8.4.4) or 6.1.4
- AppleTV3,2: Latest iOS (8.4.4)
- Download and select the corresponding IPSW.
- Select Start Restore.
- Follow the instructions to enter DFU mode and pwned DFU mode.
- Wait for the restore process to complete.
Without a genuine Apple Remote, entering the required DFU mode can be difficult. Legacy iOS Kit provides an alternative by allowing you to restore a DFU IPSW, which forces the device into DFU mode.
Once the device is in DFU mode, you can proceed with the Jailbreaking with a custom IPSW method.
- Launch Legacy iOS Kit:
./restore.sh
- Select Restore/Downgrade.
- Select DFU IPSW.
- Confirm that you want to restore the DFU IPSW and enter recovery mode.
- Wait for the restore attempt to finish.
Note: The restore process is expected to fail. This is normal. Once the process finishes, the device should be in DFU mode.
To verify this, power cycle the Apple TV, reconnect it to your computer via USB, and launch Legacy iOS Kit.
Once the device is in DFU mode, proceed with the Jailbreaking with a custom IPSW instructions above.
After completing either jailbreak method, the device will be jailbroken with SSH access available. However, additional setup is required to install packages and Kodi.
- Connect to the device via SSH over USB or Wi-Fi using the instructions above.
- Once connected to the SSH shell, run:
/var/atv/setup.sh
- Wait for the setup script to finish. Kodi should then be available on the Apple TV home screen.
On-device activation is not working on the Apple TV 2. Instead, you can use Legacy iOS Kit's Attempt Activation option from the main menu.
- Connect the Apple TV 2 to your computer via USB.
- Launch Legacy iOS Kit:
./restore.sh
- Select Attempt Activation from the main menu.
Once the device is jailbroken, you can enter kDFU mode. This is especially useful for users without a genuine Apple Remote, as it allows you to restore a jailbroken IPSW without having to restore a DFU IPSW again.
- Launch Legacy iOS Kit:
./restore.sh
- Navigate to Useful Utilities -> Enter kDFU Mode.
- Enter the SSH password when prompted.
- Disconnect and reconnect the USB cable when instructed.
- The device should now be in kDFU mode.
While in kDFU mode, you can restore a jailbroken IPSW or boot an SSH ramdisk.
To use these features, launch Legacy iOS Kit with the following argument:
./restore.sh --pwned-dfuYou can also use an SSH ramdisk to access the device for other maintenance and troubleshooting purposes.
- Put the device into DFU, pwned DFU, or kDFU mode.
- Launch Legacy iOS Kit:
./restore.sh
- Navigate to Useful Utilities -> SSH Ramdisk.
- Follow the on-screen instructions to boot the ramdisk and connect to the device.