lautarovculic/ioscpy

# ioscpy 一款 macOS CLI 工具，可以通过 USB 镜像并控制越狱的 iPhone。 只需连接一台设备即可，它会自动建立连接。

## 安装 安装分为两部分。Mac 应用程序用于运行镜像，iPhone 软件包用于实现对手机的控制。两者都需要安装。 在 Mac 上，使用 Homebrew 安装： ``` brew tap lautarovculic/ioscpy # the Mac app brew trust lautarovculic/ioscpy brew install ioscpy ioscpy --version ``` 在越狱的 iPhone 上，将此仓库添加到 Sileo 或 Zebra 中，然后从中安装 ioscpy 并注销（respring）： ``` https://lautarovculic.github.io/ioscpy-repo/ ``` 该仓库同时包含 rootless 和 rootful 构建，软件包管理器会自动选择与您的越狱环境相匹配的版本。 ``` ioscpy --device # pick a device when several are attached ioscpy --list # list attached devices ioscpy --no-keyboard # hide the on-screen keyboard, type from the Mac ioscpy --mjpeg # force MJPEG video instead of the default H.264 ioscpy --debug # full diagnostics ioscpy --version ``` ## 初次体验 ## 控制方式 - 鼠标：点击相当于触控，点击并拖动相当于滑动。 - 输入：按键会发送至获得焦点的输入框，支持任何 Mac 键盘布局。重音符号和 Emoji 表情通过剪贴板传递。 - Esc：返回。 - Cmd+J, Cmd+L, Cmd+T, Cmd+R：返回主屏幕（Home）、锁屏、App 切换器、旋转屏幕。 - Cmd+A, Cmd+C, Cmd+V, Cmd+X, Cmd+Z：全选、复制、粘贴、剪切、撤销。剪贴板支持双向同步，因此在手机上使用 Cmd+C 的内容也可以到达 Mac。 - Enter、Backspace、Tab、方向键：对应的编辑按键。 旋转手机时，镜像也会随之旋转并调整大小。 ## 测试设备 ioscpy 是在以下设备上开发和测试的。我手头没有 rootful 设备或其他 iOS 版本，因此此表格尚不完整。 | 布局 | 设备 | iOS | 注入框架 | 状态 | |----------|------------|---------|-----------|-------------------------------------------------| | rootless | | | | 方案可构建；通过 `/var/jb` 在 roothide 设备上运行 | | roothide | iPhone10,3 | 16.7.10 | ElleKit | 正常工作（通过 `/var/jb` 运行 rootless `.deb`） | | rootful | | | | 构建和布局已验证；运行时未经测试 | 如果您在其他型号的 iPhone、iOS 版本或越狱工具上运行 ioscpy，请协助完善此表。特别是 rootful 和其他 iOS 版本亟需测试。 - 如果运行正常，请添加一行包含您的设备、iOS 版本、布局和注入框架的信息，并提交 pull request。 - 如果运行失败，请提交一个 issue，并提供足够详细的修复信息： - iPhone 型号和 iOS 版本 - 越狱工具和布局（Dopamine、palera1n rootless 或 rootful、roothide） - 注入框架（ElleKit、Substitute、Substrate） - `ioscpy --debug` 的输出日志 - 具体故障表现（屏幕、触控、键盘、剪贴板、安装等） ## 布局 ``` host/ Rust macOS CLI device/ iOS package (Theos): daemon, ctl, tweak, jbcompat, packaging protocol/ wire format docs, kept in lockstep with the code scripts/ device deploy, respring, log, and diagnostics helpers docs/ architecture, jailbreak compatibility, troubleshooting, release ``` ## 构建 ``` make host-release # macOS host binary make device-rootless # rootless .deb (Dopamine, palera1n-rootless, /var/jb) make device-rootful # rootful .deb (palera1n-rootful, /) make release # host plus both device variants ``` 需要 Rust、Theos (`$THEOS`)、libimobiledevice (`idevice_id`, `iproxy`)、`ldid` 以及 `dpkg-deb`。 ## 适用范围 ioscpy 旨在通过 USB 数据线在同一桌面上，从 Mac 控制您自己的越狱 iPhone。它在 macOS 上运行，并与越狱的 iOS 设备进行通信。它不适用于 Linux 或 Windows，也不适用于未越狱的 iPhone。 ## 作者 [Lautaro Villarreal Culic'](https://lautarovculic.com) - 基于 MIT 许可协议。

标签：iOS, 可视化界面, 屏幕镜像, 越狱插件, 远程控制, 通知系统