IPATool-py
Python version of IPATool!
Now Supports:
- Purchasing App via
--purchase
- Downloading Old IPA via iTunes Server
Installation
pip3 install -r requirements.txt
Usage
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 Newest Version
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
Download OLD Version
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 History Ver (usually used together with JSON)
Get all appVerId of app from Apple
python3 main.py lookup -b com.touchingapp.potatsolite -c JP historyver -e APPLE_EMAIL -p APPLE_PWD
Lookup (usually used together with JSON)
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
Headless Usage
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
Development
- 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 executepython3 -m schema_defs
- See more information on how to generate schema in reqs/schemas directory
Credit
- Thanks @majd's ipatool, which is written in swift