Python version of IPATool!

Now Supports:

• Purchasing App via --purchase
• Downloading Old IPA via iTunes Server

pip3 install -r requirements.txt

There're three commands: lookup, historyver, download. Each command's usage can be found by -h option.

You can also chain multiple command, last command's output will be passed to next command (so you don't need to supply some arguments like appVerId)

Download an app using bundleID (-o can be omited)

python3 main.py lookup -b com.touchingapp.potatsolite -c JP download -e APPLE_EMAIL -p APPLE_PWD -o DIR

Or appID (XXXXX in the apps.apple.com/app/xxxx/idXXXXXX)

python3 main.py download -i XXXXX

You can also purchase apps when downloading using --purchase:

python3 main.py lookup -b com.touchingapp.potatsolite -c JP download --purchase -e APPLE_EMAIL -p APPLE_PWD -o DIR

Old versions must be downloaded together with iTunes Server. You can get iTunes Server in several ways:

• Using action-ipadown directly, which integrated this tool
  • NOTE: this method does not support 2FA
• Manually way: (supports 2FA)
  • download this repo: https://github.com/NyaMisty/actions-iTunes-header
  • install iTunes 12.6.5.3, from https://secure-appldnld.apple.com/itunes12/091-87819-20180912-69177170-B085-11E8-B6AB-C1D03409AD2A6/iTunes64Setup.exe
  • patch the iTunes using actions-iTunes-header/workflow_helper/iTunesInstall/patch_itunes.py
  • install frida: pip3 install frida
  • open iTunes, sign out & re-login your account
  • run: actions-iTunes-header/workflow_helper/iTunesDownload/get_header.py

After setting up the server, you can run this tool to download a specific version

python3 main.py lookup -b com.touchingapp.potatsolite -c JP download -s http://127.0.0.1:9000 --appVerId 833889087

Get all appVerId of app from Apple

python3 main.py lookup -b com.touchingapp.potatsolite -c JP historyver -e APPLE_EMAIL -p APPLE_PWD

Query app basic information:

• By bundleID: python3 main.py lookup -b com.touchingapp.potatsolite -c JP
• By appID: python3 main.py lookup -i 1239860606 -c JP

Query appVerId:

python3 main.py lookup -b com.touchingapp.potatsolite -c JP --get-verid

For each command you can use --json switch to get result of command in JSON

python3 main.py --json lookup -b com.touchingapp.potatsolite -c JP --get-verid
python3 main.py --json lookup -b com.touchingapp.potatsolite -c JP historyver -e APPLE_EMAIL -p APPLE_PWD

• All requests' reqBody and respBody are modeled using modified JSONSchema2PoPo2 (see my NyaMisty/JSONSchema2PoPo2), you can regenerate the binding by cd into reqs/schemas and execute python3 -m schema_defs
• See more information on how to generate schema in reqs/schemas directory

• Thanks @majd's ipatool, which is written in swift