wrapper for pymobiledevice3 for easy use with iphone device
Project description
tidevice3
wrapper for pymobiledevice3 to make it more easy to use.
Install
Mac
pip install tidevice3
# or install as Isolated environment
brew install pipx
pipx install tidevice3
Linux
# required by pytun-pmd3
sudo apt install python3-dev gcc pipx
pipx install tidevice3
pipx ensurepath
CLI Usage
iOS >= 17 screenshot,app:ps
connect through Ethernet over USB (NCM device) instead of usbmuxd
So tunneld should start first.
# start tunneld for iOS>=17
# launch process (pmd3 remote start-tunnel) when new usb device connected
# root required
$ sudo t3 tunneld
Basic usage
$ t3 list
...
# enable developer mode and mount develoepr image
$ t3 developer
# install & uninstall
$ t3 install https://....ipa
$ t3 install ./some.ipa
$ t3 uninstall com.example
# take screenshot
$ t3 screenshot out.png
# reboot
$ t3 reboot
# file operation
$ t3 fsync <ls|rm|pull|push> [Arguments...]
# app
$ t3 app <ps|list|launch|kill|instal|uninstall|foreground>
# screenrecord
$ t3 screenrecord out.mp4
# show help
$ t3 --help
API Usage
The API alone is insufficient for all operations; combining it with the pymobiledevice3 library can accomplish more things.
from tidevice3.api import list_devices, connect_service_provider, screenshot
for d in list_devices(usb=True):
print("UDID:", d.Identifier)
service_provider = connect_service_provider(d.Identifier)
pil_im = screenshot(service_provider)
pil_im.save("screenshot.png")
iOS 17 support
- Mac (supported)
- Windows (https://github.com/doronz88/pymobiledevice3/issues/569)
- Linux (https://github.com/doronz88/pymobiledevice3/issues/566)
Mac,Windows,Linux all supported iOS<17
WDA
其实WDA启动可以不用XCUITest,下面是知道方法(适用于iOS >= 15)
- iOS企业重签名方法 https://zhuanlan.zhihu.com/p/673521212
- iOS WDA脱离xcode & tidevice运行自动化 https://zhuanlan.zhihu.com/p/673319266
DEVELOP & CONTRIBUTE
see DEVELOP.md
LICENSE
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
tidevice3-0.8.4.tar.gz
(15.8 kB
view hashes)
Built Distribution
tidevice3-0.8.4-py3-none-any.whl
(20.7 kB
view hashes)
Close
Hashes for tidevice3-0.8.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8c3e27184e5cbb097b7730814a3b7e22f50ee6dae83f1086134082368d6fb519 |
|
MD5 | ea4c40c76353863f5d4bed09af15ed6a |
|
BLAKE2b-256 | be46c7334211080e9de884c0e455d9750063ba74461bfa919778a15d38aa3eaf |