search

nythepegasus / SideJITServer

A JIT enabler for iOS 17 with a Windows/macOS computer on the same WiFi!
GNU General Public License v3.0
438 stars 35 forks source link

Wrote a more detailed guide for Windows installation to help people. Includes installation of python, the source of many problems (I believe) #159

Open Unlearned6688 opened 1 week ago

Unlearned6688 commented 1 week ago

"Dummy-proof" Installation

Made this for myself (I make notes so I don't go crazy every time I reinstall things...) and Adapted for generic use. If desired, I can add some pics (perhaps even with visual aids) and put it up in a repo of my own or something. My goal is just to make this as a easy as possible for people (and myself!). So if anyone has feedback, let me know.

Part I

Python Pre-Install Notes

i. Installing Python v3.11.x via pyenv-win (I installed 3.11.7 and it works fine)

ii. Probably best off nuking everything to do with python, python3, pip and pip3. Then start over and install correctly

iii. pyenv makes installing ANY future versions of python incredibly easy while maintaining correct PATH so you don't have weird errors

Following the steps in the github repo for pyenv-win. [stuff in [] is my additional info. the rest is quoted.]

Quick start

  1. Install pyenv-win in PowerShell. [Copy/paste into PowerShell]

    Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1"

    [Close PowerShell after the script above. Then...]

  2. Reopen PowerShell

  3. Run pyenv --version to check if the installation was successful.

  4. Run pyenv install -l to check a list of Python versions supported by pyenv-win

  5. Run pyenv install <version> to install the supported version

    5a. [I installed v3.11.7: pyenv install 3.11.7 ]

  6. Run pyenv global to set a Python version as the global version

    6a. [ pyenv global 3.11.7 in my case]

  7. Check which Python version you are using and its path pyenv version

    7a. [my output for python v3.11.7 -> 3.11.7 (set by C:\Users\USERNAME\.pyenv\pyenv-win\version) ]

  8. Check that Python is working python -c "import sys; print(sys.executable)"

    8a. [my output for python v3.11.7 -> C:\Users\USERNAME\.pyenv\pyenv-win\versions\3.11.7\python.exe ]

You're done! WOW! Read the pyenv-win repo for more endless information on using pyenv...

Part II

Install Time!

I HIGHLY RECOMMEND USING CMD!

For whatever reason, Windows Terminal would not work for me. CMD worked the first try and on repeat tries! (And yes, I was running it in admin mode, duh)

Open CMD as admin by

i. Push Win-Key+R to bring up run. Type CMD in the search box DONT PRESS ENTER YET

ii. Hold Ctrl+Shift and then push Enter

iii. You will see in the upper left corner it says "Administrator" and it will start you in the C:\Windows\System32 directory

Instructions just ripped from SideJITServer repo. All credit to nythepegasus. I just omitted part of them and added a little to streamline for specific Windows install...

  1. Download the latest SideJITServer from the releases

  2. (I just do this in the Windows system because it's easier for me) Create a SideJITServer directory (folder) somewhere. Perhaps C:\Users\USERNAME\SideJITServer (where USERNAME is your user...name.) In Windows CMD you make a directory just like Linux. eg: mkdir C:\Users\USERNAME\SideJITServer would make the example directory I mentioned. Obviously use your own username. Extract the SideJITServer.zip archive to your directory at the root level of it. So if you go into the example directory you will see files such as "requirements.txt" and "compose.yaml" and such. Cut/paste the files/folders if you need to. Or leave the dir structure messed up...up to you.

  3. cd C:\Users\USERNAME\SideJITServer to get to the example directory inside your administrator CMD

  4. Start setting up the virtual env

    python3 -m venv venv

  5. Activate it

    .\venv\Scripts\Activate.bat

  6. You should now see something like this in CMD

    (venv) C:\Users\USERNAME\SideJITServer>

    that (venv) is important! Make sure it's there before the next step!

  7. Now install the required packages

    pip3 install -r requirements.txt

  8. That takes a minute or so to download a bunch of stuff. Then run

    pip3 install SideJITServer

    (If you got an error saying pip3 not found just change pip3 to pip)

  9. Let's see if everything works (Make sure you're still inside venv!)

    run SideJITServer --version

    my output:

    pymobiledevice3: 4.14.16

    SideJITServer: 1.3.6

Wow! PC side setup is complete! Get your iDevice ready

Part III

Make sure your device is connected!

Make sure you're still inside the venv, if applicable! (If you followed this "guide" then it is applicable!)

PROTIP In the future, when you need to enable JIT

i. open your admin CMD prompt (Win+R -> type CMD -> hold Ctrl+Shift and push Enter)

ii. type into the prompt C:\Users\USERNAME\SideJITServer\venv\Scripts\Activate.bat

iii. You could even make a cute little shortcut or .bat file on your desktop or something... just make sure it runs CMD as admin!

  1. If running JITServer for the first time or you need to re-pair, then run SideJITServer --pair

    And wait a bit

  2. Eventually you should see an output like

    Server started on http://<your-pc-IP>:8080

    Obviously the IP will be dependent on your local network. It could be http://192.168.x.y:8080 or http://10.x.y.z:8080 (more than likely one of those two)

  3. With that done, I will just point you to the repo guide to finish. Copied below from here

"Now thats done, Install this shortcut

After that its gonna ask you to put in your device's UDID, Go to your PC and see your local ipaddress mine is 192.168.0.6:8080 and on your phone go to that (your local address) and copy the one that beside usbmux (example : 00001111-000A1100A11101A)

Now it's gonna ask you for SideJIT Server address! Just type in the address you use earlier to access device's UDID

for example : http://192.168.0.6:8080 (You must include the http and not include / at the end!)

Now run the shortcut!

It gonna ask you to allow to access your local ip address just click allow!

Now select the application that you want to give JIT access to and you're done! (might ask for notification. It is recommended that you allow so you see if the JIT fail or succeed)

Happy JITing! :3"

Sweazing commented 1 week ago

i beg u please help me when i try to download pip3 install -r requirements.txt i always get "ERROR: ERROR: Failed to build installable wheels for some pyproject.toml based projects (pylzss, lzfse)"

Unlearned6688 commented 6 days ago

i beg u please help me when i try to download pip3 install -r requirements.txt i always get "ERROR: ERROR: Failed to build installable wheels for some pyproject.toml based projects (pylzss, lzfse)"

Uh, try running

pip install wheel

right after you activate the venv (so it should say C:\your\path at the prompt)

Then try the requirements command again

See if that fixes it