Add palera1n tvOS guides, add purePKG guide, and minor edits to other guides. #371

bradleytechman · 2025-11-12T04:58:00Z

This PR adds:

purePKG Guide
Installing palera1n (tvOS)
~~- Using palen1x (tvOS)~~ added into the normal guide as a tab
Removing palera1n (tvOS)
Fix minor errors in some text
Add support for detail blocks (Fix from Added instructions for booting Ventoy with Secure Boot enabled. #367, added here with permission)

Feel free to change anything.

… guides

…ons out into different guides

bradleytechman

All fixed and ready to be merged

that came with their jailbreak.

bradleytechman · 2025-12-02T02:10:42Z

Also, someone has to update the guides in the getting started page, because I couldn't figure that out.

TheMasterOfMike · 2025-12-02T02:13:02Z

Also, someone has to update the guides in the getting started page, because I couldn't figure that out.

The guides that are listed when you go to get started and the device selection and stuff are handled through AppleDB.

I'll review this shortly by the way.

bradleytechman · 2025-12-02T20:42:48Z

Sounds good

docs/en_US/include/using-purePKG.md

docs/en_US/guides/trollstore/index.md

docs/en_US/include/using-sileo.md

TheMasterOfMike · 2025-12-04T10:45:19Z

docs/en_US/jailbreak/installing-palera1n-tvos-15.0.md

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.

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.

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.

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

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

docs/en_US/jailbreak/installing-palera1n-tvos-15.0.md

TheMasterOfMike · 2025-12-04T10:59:21Z

docs/en_US/jailbreak/installing-palera1n-tvos-15.0.md

+
+::: 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:


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".

TheMasterOfMike · 2025-12-04T11:00:44Z

docs/en_US/jailbreak/installing-palera1n-tvos-18.2.md

Everything said on the previous file also applies here (I won't re-include/highlight everything for brevity since it would be another 9+ comments of mostly the same thing).

(From the previous file): 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.

TheMasterOfMike · 2025-12-04T11:02:13Z

docs/en_US/jailbreak/installing-palera1n-tvos.md

(From a previous file): 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.

TheMasterOfMike · 2025-12-04T11:03:03Z

docs/en_US/jailbreak/removing-palera1n-tvos.md

Everything said on the prior files also applies here (I won't re-include/highlight everything for brevity since it would be another 9+ comments of mostly the same thing).

(From the prior files): 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.

bradleytechman · 2025-12-04T21:42:58Z

why did copilot review this lol... i never requested it

Copilot

Pull request overview

This PR adds comprehensive palera1n tvOS jailbreak guides, introduces a purePKG package manager guide, and includes minor corrections to existing documentation. The main addition is support for jailbreaking Apple TV devices (HD and 4K) using palera1n across different tvOS versions.

Key changes:

New tvOS jailbreak guides for palera1n covering installation, removal, and different tvOS version ranges
New purePKG package manager guide for tvOS users
CSS support for detail blocks in documentation
Minor text corrections in existing guides (typo fixes, clarity improvements)

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 14 comments.

Show a summary per file

File	Description
`emiyl-theme/styles/custom-container.scss`	Adds CSS styling for detail blocks to improve documentation presentation
`docs/en_US/misc/site-navigation.md`	Adds navigation link to the new palera1n tvOS installation guide
`docs/en_US/jailbreak/using-palen1x.md`	Minor text correction replacing "CD or DVD" with "SD card or DVD"
`docs/en_US/jailbreak/installing-palera1n.md`	Adds warning directing tvOS users to the tvOS-specific guide
`docs/en_US/jailbreak/removing-palera1n-tvos.md`	New guide for uninstalling palera1n from Apple TV devices
`docs/en_US/jailbreak/installing-palera1n-tvos.md`	New routing guide directing users to appropriate version-specific instructions
`docs/en_US/jailbreak/installing-palera1n-tvos-18.2.md`	New comprehensive guide for jailbreaking tvOS 18.2+ devices with palera1n
`docs/en_US/jailbreak/installing-palera1n-tvos-15.0.md`	New comprehensive guide for jailbreaking tvOS 15.0-18.1 devices with palera1n
`docs/en_US/include/using-sileo.md`	Fixes wording: "reboot" → "respring" and "install" → "uninstall" for accuracy
`docs/en_US/include/using-purePKG.md`	New complete guide for using the purePKG package manager on tvOS
`docs/en_US/guides/trollstore/index.md`	Updates TrollStore compatibility version from 15.8.4 to 15.8.5

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2025-12-04T21:43:39Z

docs/en_US/misc/site-navigation.md

 -   <router-link to="/using-checkm8-a5">Using checkm8-a5</router-link>
 -   <router-link to="/installing-patchstick">Installing Patchstick</router-link>
-
+- 	<router-link to="/installing-palera1n-tvos">Installing palera1n(tvOS)</router-link>


Missing space in the title. The link text should have a space between "palera1n" and "(tvOS)" for better readability.

Suggested change

- <router-link to="/installing-palera1n-tvos">Installing palera1n(tvOS)</router-link>

- <router-link to="/installing-palera1n-tvos">Installing palera1n (tvOS)</router-link>

Copilot · 2025-12-04T21:43:40Z

docs/en_US/jailbreak/installing-palera1n-tvos-18.2.md

+
+::: details Apple TV 4K instructions
+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>.


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. 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>.

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>.

Copilot · 2025-12-04T21:43:40Z

docs/en_US/jailbreak/installing-palera1n-tvos-18.2.md

+::: details Apple TV 4K instructions
+1. Once you have loaded palen1x, select `Shell`.
+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>.


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. 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>.

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>.

Copilot · 2025-12-04T21:43:40Z

docs/en_US/jailbreak/installing-palera1n-tvos-15.0.md

+::: details Apple TV 4K instructions
+1. Once you have loaded palen1x, select `Shell`.
+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>.


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. 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>.

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>.

Copilot · 2025-12-04T21:43:40Z

docs/en_US/jailbreak/installing-palera1n-tvos-15.0.md

+
+::: details Apple TV 4K instructions
+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>.


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. 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>.

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>.

docs/en_US/jailbreak/installing-palera1n-tvos-15.0.md

Copilot · 2025-12-04T21:43:42Z

docs/en_US/jailbreak/installing-palera1n-tvos.md

+
+::: tip 
+
+If you are running tvOS 15.0 - 18.1, continue to <router-link to="/installing-palera1n-tvos-18.1">Installing palera1n (tvOS, 15.0 - 18.1)</router-link>


The router link points to /installing-palera1n-tvos-18.1 but the actual permalink in that file is /installing-palera1n-tvos-15.0. This will result in a broken link. The link should be updated to match the actual permalink.

Suggested change

If you are running tvOS 15.0 - 18.1, continue to <router-link to="/installing-palera1n-tvos-18.1">Installing palera1n (tvOS, 15.0 - 18.1)</router-link>

If you are running tvOS 15.0 - 18.1, continue to <router-link to="/installing-palera1n-tvos-15.0">Installing palera1n (tvOS, 15.0 - 18.1)</router-link>

Copilot · 2025-12-04T21:43:42Z

docs/en_US/include/using-purePKG.md

+## Installing Tweaks
+
+1. Open the purePKG application
+1. Navigate to "Installed" on the bar at the top


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. Navigate to "Installed" on the bar at the top

1. Navigate to "Browse" on the bar at the top

Copilot · 2025-12-04T21:43:42Z

docs/en_US/jailbreak/removing-palera1n-tvos.md

+
+::: details Apple TV 4K instructions
+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>.


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).

Copilot · 2025-12-04T21:43:43Z

docs/en_US/jailbreak/installing-palera1n-tvos-18.2.md

+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 -cf`.
+1. After you have created the fakeFS by running the command above, redo steps 2-5 to go back into DFU mode, then come back to the next step.


Inconsistent step reference. The instruction says to "redo steps 1-5" but in the palen1x tab, step 1 is "Once you have loaded palen1x, select Shell" which shouldn't be redone. It should say "redo steps 2-6" to correctly reference only the cable connection and DFU mode steps.

Suggested change

1. After you have created the fakeFS by running the command above, redo steps 2-5 to go back into DFU mode, then come back to the next step.

1. After you have created the fakeFS by running the command above, redo steps 2-6 to go back into DFU mode, then come back to the next step.

bradleytechman · 2025-12-04T21:49:46Z

I guess that was a bit helpful because it caught some mistakes, but, I never even requested it 😭

Co-authored-by: Michael <[email protected]>

bradleytechman and others added 5 commits November 11, 2025 23:38

Add palera1n tvOS guides, add purePKG guide, and minor edits to other…

59ad8bb

… guides

bump version

7c3bc1b

Clarify that the guide is for purePKG tvOS

5e27d8f

fix incorrect recomendations for jailbreak types, seperate tvOS versi…

00aa2ee

…ons out into different guides

Merge remote-tracking branch 'origin/notfork' into notfork

990cc1b

bradleytechman commented Dec 1, 2025

View reviewed changes

Clarify further that users should use the default pkg manager

5a12e97

that came with their jailbreak.

TheMasterOfMike requested changes Dec 4, 2025

View reviewed changes

add notice that the normal palera1n guide shouldn't be used for tvos

8f00420

Copilot AI review requested due to automatic review settings December 4, 2025 21:37

Copilot started reviewing on behalf of bradleytechman December 4, 2025 21:38 View session

Copilot finished reviewing on behalf of bradleytechman December 4, 2025 21:41

Copilot AI reviewed Dec 4, 2025

View reviewed changes

add missing blank line

e09a8c5

Co-authored-by: Michael <[email protected]>


		::: 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:

	- <router-link to="/installing-palera1n-tvos">Installing palera1n(tvOS)</router-link>
	- <router-link to="/installing-palera1n-tvos">Installing palera1n (tvOS)</router-link>

	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>.
	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>.


		::: tip

		If you are running tvOS 15.0 - 18.1, continue to <router-link to="/installing-palera1n-tvos-18.1">Installing palera1n (tvOS, 15.0 - 18.1)</router-link>

	1. Navigate to "Installed" on the bar at the top
	1. Navigate to "Browse" on the bar at the top

	1. After you have created the fakeFS by running the command above, redo steps 2-5 to go back into DFU mode, then come back to the next step.
	1. After you have created the fakeFS by running the command above, redo steps 2-6 to go back into DFU mode, then come back to the next step.

Add palera1n tvOS guides, add purePKG guide, and minor edits to other guides. #371

Are you sure you want to change the base?

Add palera1n tvOS guides, add purePKG guide, and minor edits to other guides. #371

Uh oh!

Conversation

bradleytechman commented Nov 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

bradleytechman left a comment

Choose a reason for hiding this comment

Uh oh!

bradleytechman commented Dec 2, 2025

Uh oh!

TheMasterOfMike commented Dec 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

bradleytechman commented Dec 2, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

bradleytechman commented Dec 4, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Dec 4, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 4, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 4, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 4, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 4, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI Dec 4, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 4, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 4, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 4, 2025

Choose a reason for hiding this comment

Uh oh!

bradleytechman commented Dec 4, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

bradleytechman commented Nov 12, 2025 •

edited

Loading

TheMasterOfMike commented Dec 2, 2025 •

edited

Loading