Add palera1n tvOS guides, add purePKG guide, and minor edits to other guides. #371
+833
−7
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,84 @@ | ||||||
| ## Required Reading | ||||||
| ::: tip | ||||||
|
|
||||||
| This page is optional, but helpful if you are unfamiliar with jailbreaking. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| ::: warning | ||||||
|
|
||||||
| This guide is formatted for purePKG on tvOS. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| purePKG is a modern package manager that has a simple UI made to fit with iOS 13 and above. It's the App Store for all the tweaks and themes available for your device. | ||||||
|
|
||||||
| <p><router-link to="/faq/#what-are-tweaks">Tweaks</router-link> are small modifications to change the look and/or feel of your device. You can find tweaks on repositories, colloquially referred to as "repos".</p> | ||||||
|
|
||||||
| <p><router-link to="/faq/#what-s-a-repo">Repositories</router-link> are essentially databases that contain lots of tweaks for you to install. When you add repos to purePKG, you will be able to install the tweaks on it, and look for them using the search function.</p> | ||||||
|
|
||||||
| This guide will show you how you can install and uninstall tweaks, and add different repos. | ||||||
|
|
||||||
| ## Adding Repos | ||||||
|
|
||||||
| ::: tip | ||||||
|
|
||||||
| If you are unable to add a repository, try to restart purePKG from your app switcher. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| 1. Open the purePKG application | ||||||
| 1. Navigate to "Browse" on the bar at the top | ||||||
| 1. Tap the "+" icon in the top right-hand corner | ||||||
| 1. Enter in a repo URL (e.g. [`https://sparkdev.me/`](https://sparkdev.me/)) | ||||||
| 1. Tap "OK" | ||||||
|
|
||||||
| You can now enter the repo from this page to see all the tweaks available on it. | ||||||
|
|
||||||
| ## Removing Repos | ||||||
|
|
||||||
| 1. Open the purePKG application | ||||||
| 1. Navigate to "Browse" on the bar at the top | ||||||
| 1. Go onto the source you would like to remove | ||||||
| 1. Hold down on the trackpad of your remote and click | ||||||
| 1. Select "Remove" | ||||||
|
|
||||||
| The repo should now be removed from purePKG. | ||||||
|
|
||||||
| ## Installing Tweaks | ||||||
|
|
||||||
| 1. Open the purePKG application | ||||||
| 1. Navigate to "Installed" on the bar at the top | ||||||
|
There was a problem hiding this comment. Typo in step 51. The text says to navigate to "Installed" when installing tweaks, but it should likely be "Browse" or "Search" since you're looking for new tweaks to install. The "Installed" tab would be for tweaks already installed on the device.
Suggested change
|
||||||
| 1. Tap on a tweak you'd like to install | ||||||
| 1. Tap the "install" button next to the tweak name | ||||||
| 1. Navigate to "Queued" on the bar at the top | ||||||
| 1. Tap on the bar at the bottom and press "Perform Actions" | ||||||
| - It may take some time for the tweak to install | ||||||
| 1. After it's finished, tap "<router-link to="/faq/#what-is-respringing">Respring</router-link>" | ||||||
| - The device should appear to respring after this | ||||||
| - Sometimes, the button might not say to respring, but you can tap the button anyway | ||||||
|
|
||||||
| The tweak should now be installed to your device and will be active whenever your device is jailbroken. | ||||||
|
|
||||||
| ## Uninstalling Tweaks | ||||||
|
|
||||||
| 1. Open the purePKG application | ||||||
| 1. Navigate to "Installed" on the bar at the top | ||||||
| 1. Tap on a tweak you'd like to uninstall | ||||||
| 1. Tap the "Uninstall" button next to the tweak name | ||||||
| 1. Navigate to "Queued" on the bar at the top | ||||||
| 1. Tap on the bar at the bottom and press "Perform Actions" | ||||||
| - It may take some time for the tweak to uninstall | ||||||
| 1. After it's finished, tap "<router-link to="/faq/#what-is-respringing">Respring</router-link>" | ||||||
| - The device should appear to respring after this | ||||||
| - Sometimes, the button might not say to respring, but you can tap the button anyway | ||||||
|
|
||||||
| After respringing, the tweak should now be uninstalled. | ||||||
|
|
||||||
| <!-- Afaik logging into repos on purePKG is not supported as of 11/11/25 so the section has been removed --> | ||||||
|
|
||||||
| ::: tip | ||||||
|
|
||||||
| If you run into errors installing or removing packages, read the <router-link to="/troubleshooting">Troubleshooting</router-link> page | ||||||
|
|
||||||
| ::: | ||||||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
Collaborator
There was a problem hiding this comment. To avoid restating this numerous times - imo it would probably be better to align closer to https://ios.cfw.guide/installing-checkra1n-tv/ (or alternatively align the checkra1n/odysseyn1x guides to align with this one, but I'm disinclined on this due to how palera1n is). This may warrant further discussion/context in the replies to this comment or in the r/jailbreak Discord.
Contributor
Author
There was a problem hiding this comment. I think it's fine like this, especially because there are two different tvOS versions that need guides made for them. If I were to make it look like the checkra1n guide, then that creates more guides. I will update them to not say the name of the devices but rather the model number though to align it a bit more.
Collaborator
There was a problem hiding this comment.
I'm more referring to the titles/file names/urls and such. I guess what I'm envisioning is "Installing palera1n (Apple TV) (tvOS 15.0-18.1)" or something like that
Contributor
Author
There was a problem hiding this comment. Maybe i'm just being stupid, but that's what it is right now It's currently split up into two guides for the tvos versions |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,250 @@ | ||||||
| --- | ||||||
| lang: en_US | ||||||
| title: Installing palera1n (tvOS, 15.0-18.1) | ||||||
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
| description: Guide to installing palera1n on tvOS 15.0-18.1 | ||||||
| permalink: /installing-palera1n-tvos-15.0 | ||||||
| pkgman: purePKG | ||||||
| redirect_from: | ||||||
| - /installing-palera1n-tvos18.1 | ||||||
| - /installing-palera1n-tvos15.0 | ||||||
| - /installing-palera1n-tvos-15.0 | ||||||
| - /installing-palen1x-tvos-15.0 | ||||||
| - /using-palen1x-tvos-15.0 | ||||||
| - /install-palera1n-tvos-15.0 | ||||||
| - /palera1n-tvos-15.0 | ||||||
| - /installing-paleraintv-15.0 | ||||||
| - /palera1n-tvos15.0 | ||||||
| - /installing-palera1n-apple-tv-18.1 | ||||||
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
| extra_contributors: | ||||||
| - Bradley | ||||||
| - Zenzeq | ||||||
| --- | ||||||
|
|
||||||
| palera1n is a semi-tethered jailbreak compatible with the Apple TV HD (4th generation) and Apple TV 4K (1st generation) on tvOS versions 15.0 - 26.0.1. | ||||||
|
|
||||||
|
|
||||||
| ::: warning | ||||||
|
|
||||||
| If you are using an old, tethered version of palera1n, you'll need to <router-link to="/removing-palera1n-legacy">remove palera1n</router-link> before continuing. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| ::: danger | ||||||
|
|
||||||
| You cannot use rootless for this guide and must jailbreak using rootful. If you installed rootless, please follow <router-link to="/removing-palera1n-tvos">Removing palera1n (tvOS)</router-link>. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| ## Requirements | ||||||
|
|
||||||
| - An Apple TV Siri remote (any generation) | ||||||
| - If you have an Apple TV HD, you will need only a USB-C cable. | ||||||
| - If you have an Apple TV 4K, you will need these three cables: | ||||||
| - A GoldenEye or Foxlink X892 cable | ||||||
| - An Alex DCSD cable (needed to enter DFU mode; using a Lightning cable with the GoldenEye cable on its own won't work) | ||||||
| - A standard Lightning cable | ||||||
| - It is recommended to purchase these from AliExpress for the best prices. Note that they typically take about a month to arrive. | ||||||
|
|
||||||
| ## Installing the jailbreak | ||||||
|
|
||||||
| Please select your operating system: | ||||||
|
|
||||||
| :::::: tabs | ||||||
|
|
||||||
| :::: tab name="macOS" :default="true" | ||||||
|
|
||||||
| ### Installing palera1n | ||||||
|
|
||||||
| 1. Open a Terminal window. | ||||||
| 1. Run `sudo /bin/sh -c "$(curl -fsSL https://static.palera.in/scripts/install.sh)"` | ||||||
|
|
||||||
| ### Running palera1n | ||||||
|
|
||||||
| ::: details Apple TV 4K instructions | ||||||
| 1. Plug your GoldenEye/Foxlink cable into the Ethernet port on your Apple TV. | ||||||
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
| 1. Plug your DCSD cable into the Lightning connector on the GoldenEye/Foxlink cable upside down-the side labeled "this side up" or similar should face down; otherwise, it might not enter <router-link to="/faq/#what-is-dfu-mode">DFU mode</router-link>. | ||||||
|
There was a problem hiding this comment. Missing space after the hyphen. The text reads "upside down-the" but should be "upside down—the" (with an em dash) or "upside down - the" (with spaces around the hyphen).
Suggested change
|
||||||
| 1. Finally, plug the USB end of your DCSD cable into your computer or any power source. | ||||||
| 1. Restart your Apple TV with both cables plugged in to put it into DFU mode. | ||||||
| 1. Once in DFU mode, unplug your DCSD cable (**not** your GoldenEye/Foxlink cable, keep that plugged in) and plug in your Lightning cable, with the other end connected to your computer. | ||||||
| 1. Run `palera1n -f`. | ||||||
|
|
||||||
| You'll need to do this every time you rejailbreak your device. | ||||||
| ::: | ||||||
|
|
||||||
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
| ::: details Apple TV HD instructions | ||||||
| 1. Plug your USB-C cable into the USB-C diagnostic port on the back of the device and the other end into your computer. | ||||||
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
| 1. Run `palera1n -f`. | ||||||
| 1. When ready, press `Enter` and follow the on-screen instructions to enter <router-link to="/faq/#what-is-dfu-mode">DFU mode</router-link>. | ||||||
|
|
||||||
| You'll need to do this every time you rejailbreak your device. | ||||||
| ::: | ||||||
|
|
||||||
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
| ::: tip | ||||||
|
|
||||||
| A9(X) and earlier devices have an issue where they will get stuck midway through this process in pongoOS. To work around this, you'll need to do the following: | ||||||
|
Collaborator
There was a problem hiding this comment. Does this apply to Apple TV's? If it does, the start of this sentence should be changed to "The Apple TV HD has an issue".
Contributor
Author
There was a problem hiding this comment. I would assume it still has the issue but that's probably a question for either zenzeq who's done ran before or nick chan |
||||||
|
|
||||||
| 1. In the terminal window, press `Control` + `C` on your keyboard. | ||||||
| 1. Rerun the command that you just ran. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| Once the device boots up, open the palera1n loader app and tap `Install`. After some time, you'll be prompted to set a passcode for using command-line tools, and then `purePKG` should be on your home screen. | ||||||
|
|
||||||
| ::: tip | ||||||
|
|
||||||
| To rejailbreak your device, simply run the last command again and then repeat any other applicable steps. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| :::: | ||||||
|
|
||||||
| :::: tab name="Linux" | ||||||
|
|
||||||
|
|
||||||
| ::: danger | ||||||
|
|
||||||
| If you are trying to use Virtual Machine software from Windows (e.g., VirtualBox, VMWare, Windows Subsystem for Linux, etc.), you will not succeed with this guide. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| ::: warning | ||||||
|
|
||||||
| If you are using a computer with an AMD Ryzen CPU, you will likely run into issues. If you do, you should use a Mac or a computer with an Intel CPU to follow this guide. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| ### Installing palera1n | ||||||
|
|
||||||
| 1. Open a terminal window. | ||||||
| 1. Run `sudo systemctl stop usbmuxd`. | ||||||
| 1. Run `sudo usbmuxd -f -p`. | ||||||
| 1. Open another terminal window. | ||||||
| 1. Run `sudo /bin/sh -c "$(curl -fsSL https://static.palera.in/scripts/install.sh)"`. | ||||||
|
|
||||||
|
|
||||||
| ### Running palera1n | ||||||
|
|
||||||
| ::: details Apple TV 4K instructions | ||||||
| 1. Plug your GoldenEye/Foxlink cable into the Ethernet port on your Apple TV. | ||||||
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
| 1. Plug your DCSD cable into the Lightning connector on the GoldenEye/Foxlink cable upside down-the side labeled "this side up" or similar should face down; otherwise, it might not enter <router-link to="/faq/#what-is-dfu-mode">DFU mode</router-link>. | ||||||
|
There was a problem hiding this comment. Missing space after the hyphen. The text reads "upside down-the" but should be "upside down—the" (with an em dash) or "upside down - the" (with spaces around the hyphen).
Suggested change
|
||||||
| 1. Finally, plug the USB end of your DCSD cable into your computer or any power source. | ||||||
| 1. Restart your Apple TV with both cables plugged in to put it into DFU mode. | ||||||
| 1. Once in DFU mode, unplug your DCSD cable (**not** your GoldenEye/Foxlink cable, keep that plugged in) and plug in your Lightning cable, with the other end connected to your computer. | ||||||
| 1. Run `palera1n -f`. | ||||||
|
|
||||||
| You'll need to do this every time you rejailbreak your device. | ||||||
| ::: | ||||||
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
|
|
||||||
| ::: details Apple TV HD instructions | ||||||
| 1. Plug your USB-C cable into the USB-C diagnostic port on the back of the device and the other end into your computer. | ||||||
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
| 1. Run `palera1n -f`. | ||||||
| 1. When ready, press `Enter` and follow the on-screen instructions to enter <router-link to="/faq/#what-is-dfu-mode">DFU mode</router-link>. | ||||||
|
|
||||||
| You'll need to do this every time you rejailbreak your device. | ||||||
| ::: | ||||||
|
|
||||||
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
| ::: tip | ||||||
|
|
||||||
| A9(X) and earlier devices have an issue where they will get stuck midway through this process in pongoOS. To work around this, you'll need to do the following: | ||||||
|
Collaborator
There was a problem hiding this comment. Does this apply to Apple TV's? If it does, the start of this sentence should be changed to "The Apple TV HD has an issue". |
||||||
|
|
||||||
| 1. In the terminal window, press `Control` + `C` on your keyboard. | ||||||
| 1. Rerun the command that you just ran. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| Once the device boots up, open the palera1n loader app and tap `Install`. After some time, you'll be prompted to set a passcode for using command-line tools, and then `purePKG` should be on your home screen. | ||||||
|
|
||||||
| ::: tip | ||||||
|
|
||||||
| To rejailbreak your device, simply run the last command again and then repeat any other applicable steps. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| :::: | ||||||
|
|
||||||
| :::: tab name="palen1x (Windows)" | ||||||
|
|
||||||
| ::: danger | ||||||
|
|
||||||
| If you are trying to use Virtual Machine software from Windows (e.g., VirtualBox, VMWare, Windows Subsystem for Linux, etc.), you will not succeed with this guide. You will need to obtain a bootable medium and follow the steps below using that bootable medium. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| ::: warning | ||||||
|
|
||||||
| If you are using a computer with an AMD Ryzen CPU, you will likely run into issues. If you do, you should use a Mac or a computer with an Intel CPU to follow this guide. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| palen1x is a live bootable Linux environment that allows you to quickly run palera1n on a compatible device. palera1n is capable of jailbreaking the Apple TV HD (4th generation) and Apple TV 4K (1st generation) on tvOS versions 15.0 - 26.0.1. | ||||||
|
|
||||||
| ### Additional Requirements | ||||||
|
|
||||||
| - *These are in addition to the ones at the top of this guide* | ||||||
| - A 128MB or greater USB Drive | ||||||
| - If you don't have a USB drive but have another form of supported removable bootable hardware (e.g., an SD card or DVD), you can use that instead. | ||||||
| - The latest version of [palen1x](https://github.com/palera1n/palen1x/releases) | ||||||
| - [Ventoy](https://github.com/ventoy/Ventoy/releases) | ||||||
|
|
||||||
|
|
||||||
| ### Installing Ventoy | ||||||
|
|
||||||
| 1. Download and extract the contents of the `Ventoy.zip` file. | ||||||
| 1. Insert your USB drive if you have not already done so, and open the `Ventoy2Disk.exe` file. | ||||||
| 1. Select the USB drive you would like to boot palen1x from. | ||||||
| - This USB drive will be completely erased. | ||||||
| - Ensure you back up all important data beforehand. | ||||||
| 1. Click `Install` and confirm that you are okay with erasing the USB drive. | ||||||
| - Do not remove your USB drive until the process has completed. | ||||||
| 1. Once it has installed, copy the palen1x `.iso` file that you downloaded onto the USB drive. | ||||||
|
|
||||||
| ### Booting palen1x | ||||||
|
|
||||||
| 1. Reboot your computer, go into your BIOS settings to disable Secure Boot, then enter the boot picker and select your USB drive to boot from. | ||||||
| - This process is different for every computer. | ||||||
| - Search for your PC or motherboard brand to find out how to get to your BIOS settings if you are unsure. | ||||||
| 1. Press `Enter` once you see the Ventoy screen to boot into palen1x. | ||||||
|
|
||||||
| ### Running palera1n | ||||||
|
|
||||||
| ::: details Apple TV 4K instructions | ||||||
| 1. Once you have loaded palen1x, select `Shell`. | ||||||
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
| 1. Plug your GoldenEye/Foxlink cable into the Ethernet port on your Apple TV. | ||||||
| 1. Plug your DCSD cable into the Lightning connector on the GoldenEye/Foxlink cable upside down-the side labeled "this side up" or similar should face down; otherwise, it might not enter <router-link to="/faq/#what-is-dfu-mode">DFU mode</router-link>. | ||||||
|
There was a problem hiding this comment. Missing space after the hyphen. The text reads "upside down-the" but should be "upside down—the" (with an em dash) or "upside down - the" (with spaces around the hyphen).
Suggested change
|
||||||
| 1. Finally, plug the USB end of your DCSD cable into your computer or any power source. | ||||||
| 1. Restart your Apple TV with both cables plugged in to put it into DFU mode. | ||||||
| 1. Once in DFU mode, unplug your DCSD cable (**not** your GoldenEye/Foxlink cable, keep that plugged in) and plug in your Lightning cable, with the other end connected to your computer. | ||||||
| 1. Run `palera1n -f`. | ||||||
|
|
||||||
| You'll need to do this every time you rejailbreak your device. | ||||||
| ::: | ||||||
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
|
|
||||||
| ::: details Apple TV HD instructions | ||||||
| 1. Once you have loaded palen1x, select `Shell`. | ||||||
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
| 1. Plug your USB-C cable into the USB-C diagnostic port on the back of the device and the other end into your computer. | ||||||
| 1. Run `palera1n -f`. | ||||||
| 1. When ready, press `Enter` and follow the on-screen instructions to enter <router-link to="/faq/#what-is-dfu-mode">DFU mode</router-link>. | ||||||
|
|
||||||
| You'll need to do this every time you rejailbreak your device. | ||||||
| ::: | ||||||
|
|
||||||
bradleytechman marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
| ::: tip | ||||||
|
|
||||||
| A9(X) and earlier devices have an issue where they will get stuck midway through this process in pongoOS. To work around this, you'll need to do the following: | ||||||
|
Collaborator
There was a problem hiding this comment. Does this apply to Apple TV's? If it does, the start of this sentence should be changed to "The Apple TV HD has an issue". |
||||||
|
|
||||||
| 1. In the terminal window, press `Control` + `C` on your keyboard. | ||||||
| 1. Rerun the command that you just ran. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| Once the device boots up, open the palera1n loader app and tap `Install`. After some time, you'll be prompted to set a passcode for using command-line tools, and then `purePKG` should be on your home screen. | ||||||
|
|
||||||
| ::: tip | ||||||
|
|
||||||
| To rejailbreak your device, simply run the last command again and then repeat any other applicable steps. | ||||||
|
|
||||||
| ::: | ||||||
|
|
||||||
| :::: | ||||||
|
|
||||||
| :::::: | ||||||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.