nythepegasus/SideJITServer

Help with simplifying these instructions:

RobThePCGuy opened this issue · 3 comments

I wrote this up the best I could. I am on Windows. I have JIT working on my iPad Air 5th gen with the latest version of iOS installed. Please if this guide helps you may pick apart whatever you need. If not, trash it.

Requirements:

  • Operating System: Windows 11
  • Applications: iTunes and iCloud applications directly from Apple (not from Microsoft Store).
  • Python Version: Latest version (3.11.9 works for this setup). Use the following commands in PowerShell to verify:
    • which python to locate the Python installation.
    • python --version to check the installed Python version.

Setting Up the Environment

  1. Launch PowerShell as an Administrator.

  2. Navigate to your Desktop:

    cd ~\Desktop
    
  3. Clone the repository:

    git clone https://github.com/nythepegasus/SideJITServer.git
    
  4. Change directory to the cloned repository and set up a Python virtual environment:

    cd ~\Desktop\SideJITServer
    python -m venv venv
    .\venv\Scripts\Activate.ps1
    

You should now see: (venv) PS indicating that the virtual environment is activated.

  1. Install required packages:

    pip install -r requirements.txt
    pip install SideJITServer
    
  2. Check the installed version of SideJITServer:

    SideJITServer --version
    

Expected output: pymobiledevice3: 4.2.3 and SideJITServer: 1.3.1

  1. Connect your iPad:
  • Plug in your iPad and wait for the 'Trust' prompt on the device.
  • It may help to sync the iPad with your computer first. Consider rebooting if things don’t behave as expected.

Troubleshooting

  • Ensure PowerShell is launched as Administrator.
  • Navigate to the cloned repository directory.
  • Activate the Python virtual environment.
  • Run the Activate.ps1 script.
  • Install necessary packages and the server.
  • Keep the iPad screen on at all times; do not let the screen lock.

Pairing Devices

  1. Pair the device:

    SideJITServer --pair
    

The iPad will prompt with a 'Trust' window after running the command.

  1. Verification:
  • On the iPad open the default browser and navigate to the third IP address provided by SideJITServer (e.g., http://192.168.1.164:8080). You should see a JSON response like:

    {"usbmux-########-################-USB":"########-################"}
    
  1. Follow through:
  • Go to the GitHub page, click on the shortcut link, and enter the 25-character UDID found between usbmux- and -USB.
  • You'll need to give it the SideJITServer IP when prompted. (e.g., http://192.168.1.164:8080).
  • Save it and find 'All Shortcuts' on the left. Select the shortcut named 'SideJIT'.
  • Choose AltStore or another application to which you want to grant access.

Thank you so much! You did a great job at explaining on how to get to the SideJITStore directory and set up a Python virtual environment!

After following all the steps correctly and successfully pairing my iPad, whenever I go to verify the device by navigating to the third IP address provided by SideJITServer (e.g., http://192.168.1.67:8080)

The JSON response is - {ERROR": "Could not find device!"}

Please help me with this.

I have a issue connecting to the server with my iPhone. My iPhone won't connect to the IP Address. It just says it couldn't connect to the server.

@Gazerbeam2 Same here. Following this thread.