XXTouchNG

Next generation XXTouch for iOS 13 and 14. Rewritten in Objective-C.

What’s XXTouch

XXTouch is a system wide touch event simulation and automation library.

Features

Lua Core

• extension of os, print
• sys.log, nLog
• screen, image
• touch, key, accelerometer
• sys, device
• pasteboard, proc
• app
• thread
• extension of table, string
• http, ftp
• json, plist, file
• utils
• other extensions
• dialog, webview
• clear
• xpp, xui

App & Services

• Full Featured Recording
• Full Featured App
• OpenAPI
• Startup Script
• Daemon Mode
• Alert Helper
• WKWebView Helper
• OCR Support (Provided by Apple’s Vision.framework)
• Template Matching (Provided by OpenCV)
• Activator Support

OpenAPI Protocols

• Legacy XXTouch
• TouchSprite (触动精灵协议)
• TouchElf & Cloud API (触摸精灵及其云控协议)

Debugger Support

• VSCode
• LuaPanda
• XXTouch-VSCode-Debugger

IDE Support

• VSCode
• XXTouch-VSCode-Plugin

Prepare Your Device

• iOS 13 or 14
• Jailbreak it with unc0ver or checkra1n
• Install dependencies with your favorite package manager
• ssh-copy-id

Prepare Your Mac

• Xcode 12 (required)
• VSCode (recommended)

$ xcode-select -p
/Applications/Xcode-12.5.1.app/Contents/Developer

• Install theos with its submodules

$ ls ~/theos
CODE_OF_CONDUCT.md bin                makefiles          templates
LICENSE.md         extras             mod                toolchain
Prefix.pch         include            package.json       vendor
README.md          lib                sdks

• theos/sdks
• theos/headers

$ ls ~/theos/sdks | wc -l
      16
$ ls ~/theos/vendor/include | wc -l
     110

• IMPORTANT: Remove ~/theos/vendor/include/openssl because we shipped another version of OpenSSL in this repo
• IMPORTANT: Edit ~/theos/makefiles/common.mk, then append line export THEOS_OBJ_DIR to a good place
• Edit your ~/.zshrc and ensure THEOS_DEVICE_IP is set

$ env
THEOS=$HOME/theos
THEOS_DEVICE_IP=192.168.2.151

Build

Build Only

$ make

Build Package

$ make package

Install Package

$ make install

Build & Install

$ make do

Build Release

$ make package FINALPACKAGE=1

Usage

User Manual (Chinese Only)

• XXTouch iOS 使用入门
• XXTouch 常见问题答疑

Documentation (Chinese Only)

• Lua 5.3 Manual
• XXTouch iOS 开发手册
• XXTouchBook

Credits

XXTouchNG uses codes from many open-source projects. Part of them were listed in submodules.

License

See LICENSE.