Skip to content

Commit

Permalink
Updated Instructions
Browse files Browse the repository at this point in the history
Added note on how to make sidestore work again if it expires, fixed typo, and did another thing that's literally nothing that I'm too lazy to describe
  • Loading branch information
deformedRat authored May 14, 2024
1 parent e1a60de commit afad230
Showing 1 changed file with 9 additions and 6 deletions.
15 changes: 9 additions & 6 deletions src/index.js
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ else if (detectedOS.indexOf('win') != -1) detectedOS = 'windows';
else detectedOS = 'mac';

let setupStepContents = [
//download sideserver
//downloading altserver
() =>
`<b>To get started, you'll need:</b><ul class="list-disc list-inside"><li>${osW(
'A Mac running macOS 10.15 or later',
Expand All @@ -59,13 +59,13 @@ let setupStepContents = [
`Then, open the downloaded AltServer zip file and extract it. Then drag <code>AltServer.app</code> to your Applications folder. Now, open the app (you may have to right click and select "Open" if you get a warning).`,
`Extract the downloaded AltInstaller zip file and run <code>setup.exe</code> to install AltServer. You'll need to have the non-Microsoft Store version of iTunes and iCloud installed. Uninstall the Microsoft Store versions if you have either installed.<div class="flex flex-wrap gap-2"><a class="btn-fill" href="https://www.apple.com/itunes/download/win64/">Download iTunes</a><a class="btn-fill" href="https://updates.cdn-apple.com/2020/windows/001-39935-20200911-1A70AA56-F448-11EA-8CC0-99D41950005E/iCloudSetup.exe">Download iCloud</a></div>`
)}`,
//sideload app
//sideloading sidestore
(os) =>
`<b>Follow these steps to install SideStore:</b><ul class="list-disc list-inside"><li>Plug your device into your computer via a cable.</li><li>Trust your computer on your device (if prompted).</li><li>Launch Altserver and, ${osW(
'holding options, click on the Altserver icon in the menu bar and select <code>Sideload .ipa</code>.',
'Holding shift, click on the AltServer tray icon and select <code>Sideload .ipa</code>.'
'holding shift, click on the AltServer tray icon and select <code>Sideload .ipa</code>.'
)}</li><li> Select the SideStore .ipa, follow instructions as prompted, and wait until AltServer confirms that SideStore has been installed.</li><li>Open <code>Settings > General > VPN & Device Management</code> on your device and approve of the <code>Developer App</code> linked to your Apple ID's email.</li><li>If your device is running iOS/iPadOS 16 or higher, you must now enable Developer Mode. To do that:<ul class="list-decimal list-inside ml-4 sm:ml-6"><li>Open the Settings app</li><li>Tap “Privacy & Security”</li><li>Scroll to the bottom and toggle Developer Mode on</li></ul></li>`,
//Pairing Idevice
//pairing file
(os) =>
`<b>Follow these steps to Pair your device:</b><li>Extract <code>Jitterbugpair.zip.</code> <a class="glink" target="_blank" href="https://support.apple.com/en-ca/guide/iphone/iph14a867ae/ios">Set a passcode for your device</a> if you don't already have one and ensure that your device is still connected to your computer via cable.</li> <ul class="list-disc list-inside"><li> Open your device to its homescreen. ${osW(
'Then, execute <code>JitterBugPair</code> by double-clicking it or right-clicking it and selecting open.</li><li>JitterBugPair will then generate a <b>pairing file</b>. This pairing file will have the file exentension <code>mobiledevicepairing.</code></li>',
Expand All @@ -76,9 +76,12 @@ let setupStepContents = [
//wireguard vpn
() =>
`On your device, download the WireGuard VPN app.<a class="btn-fill" target="_blank" href="https://apps.apple.com/us/app/wireguard/id1441195209">Download WireGuard</a>Then, download SideStore's config file and "share" it to the WireGuard app.<a class="btn-fill" target="_blank" href="https://github.com/sidestore/sidestore/releases/download/0.1.1/sidestore.conf">Download WireGuard Config</a>Enable the SideStore VPN. You'll have to enable this VPN whenever you wish to use SideStore. This VPN does not connect to an external server, but rather allows your device to communicate with itself.<br><br>If left enabled, SideStore will attempt to refresh your sideloaded apps in the background when necessary.`,
//finished
//finishing up
() =>
`Now to finish the process: <ul class="list-disc list-inside"><li>Open SideStore and sign in with the same Apple ID you used to install SideStore.</li><li>Go to the Apps tab and refresh the SideStore app by tapping on the green day counter or selecting <code>Refresh All</code>.</li></ul><br> Now you're all set! You can use the sources menu to add installable apps to the browse tab or directly sideload any <code>.ipa</code> files on your device with the + icon in the Apps tab.<br>If you run into any issues, feel free to ask for help in our <a class="glink" target="_blank" href="https://discord.gg/RgpFBX3Q3k">Discord server.</a>`,
`Now to finish the process: <ul class="list-disc list-inside"><li>Open SideStore and sign in with the same Apple ID you used to install SideStore.</li><li>Go to the Apps tab and refresh the SideStore app by tapping on the green day counter or selecting <code>Refresh All.</code> You <b>must</b> do this whenever you install SideStore. Doing otherwise might cause errors, including SideStore expiring earlier than it should.</li></ul>
<br> Now you're all set! You can use the sources menu to add installable apps to the browse tab or directly sideload any <code>.ipa</code> files on your device with the + icon in the Apps tab.
<br>Note that if you ever let an app expire you won't be able to access it until you refresh it again. To refresh SideStore, simply follow the steps you followed to install it. (Do <b>not</b> uninstall the SideStore app while doing this.) Altserver will refresh Sidestore and it will continue to function. For any other app, just refresh it normally, and it will work again.
<br>If you run into any issues and would like some help, feel free to ask in our <a class="glink" target="_blank" href="https://discord.gg/RgpFBX3Q3k">Discord server.</a>`,
];

const osSelect = $('#setup-os-select');
Expand Down

0 comments on commit afad230

Please sign in to comment.