iosrealrun / iosrealrun-cli Goto Github PK

View Code? Open in Web Editor NEW

89.0 0.0 10.0 80.93 MB

(iOS <17) 基于虚拟定位的 iOS 免越狱模拟跑步打卡，跨平台支持，在线拾取路径，可设置跑步速度，随机速度与路线

Home Page: https://github.com/iOSRealRun/iOSRealRun-cli

License: Mozilla Public License 2.0

Shell 1.11% Python 98.89%

iosrealrun-cli's Introduction

iOSRealRun-cli

由于改动很大，iOS 17+的支持另外开了个仓库：https://github.com/iOSRealRun/iOSRealRun-cli-17

背景

原 iOSFakeRun 只能在windows上用，且每圈的路径是一样的。同时对于很多iOS/iPadOS16及以上的设备，不能方便地打开开发者模式，但是由于我不会C#无法给其提PR，所以有了这个项目

注意

本项目用到的 libimobiledevice 可以进行获取屏幕截图等涉及隐私的操作，因此如果您要使用与本项目类似的闭源产品，请自行考虑风险。

功能

已实现
- 让你方便地打开开发者模式，而不需要借助爱思助手等第三方软件
- 和 iOSFakeRun 相同的路径格式 (但是请只画一圈)
- 自定义配速
- 一种阴间的随机方式让每一圈不完全相同
- 支持 Windows 和 MacOS
- 每跑完一次设定的路径随机一次速度
- 支持 Linux/BSD
暂未实现
- 阳间的随机方式
无法实现（libimobiledevice没有，我也不会）
- 步数模拟

原理

不讲了，懂的自然懂

要求

DeveloperDiskImage (已预置了15.4及以上，其余版本请按照下文使用方法中的指引操作)
usbmuxd (对于Linux用户)

支持的系统

已支持
- Windows 64位 (tested on Windows 11, Python 3.9)
- MacOS (Apple Silicon) (tested on M2 Mac, Python 3.9)
- MacOS (Intel)
- linux/bsd 64位
不支持
- 任何x86的32位系统

使用方法

大概步骤:

安装依赖：若为Linux用户，请用你的包管理器安装usbmuxd
Debian/Ubuntu: sudo apt install usbmuxd
Red Hat/CentOS/Fedora: sudo dnf install usbmuxd
从 Actions 下载对应系统的最新构建，接下来称main.exe或main.bin所在文件夹位**脚本目录
虚拟定位需要开发者镜像。我预置了 15.4 及以上的开发者镜像
如果你不是上述版本，你可以去网上找 DeveloperDiskImage
- 打开 DeveloperDiskImage 仓库
- 查看自己的 iOS 版本，下载对应的 DeveloperDiskImage.dmg 和 DeveloperDiskImage.dmg.signature 文件
- 进入脚本目录 DeveloperDiskImage 文件夹中建立以版本号为名称的文件夹，将刚才下载的两个文件放入此文件夹。
  例如，你是 15.1 版本的系统，你需要下载并解压 DeveloperDiskImage.dmg 和 DeveloperDiskImage.dmg.signature 文件，把他们放到 DeveloperDiskImage/15.1 里面
接下来和 iOSFakeRun 一样要获取你要的跑步路径，格式和其使用的格式完全相同，但是请只画一圈，项目预置了画的不太行的紫金港操场和海宁操场路径（在配置文件 config.yaml 里改路线的文件名），建议所有人都自己画路径

打开路径拾取网站。通过点击地图构造路径。点击时无需考虑间距，会自动用直线连接。路径点击完成后，单击上方的路径坐标——复制，将坐标数据复制到剪贴板
打开脚本目录里的 route.txt 文件，将刚复制的内容原封不动的粘贴进去，保存并退出
对于 Windows，你需要安装 iTunes，以确保驱动正常运行
在脚本目录中的 config.yaml 文件中设置 v 变量以设置速度(m/s)，给个参考，3.3大概是5分到5分半的配速（我也没仔细看）
Mac用户和Windows用户可能需要打开iTunes，且在跑完前不应关闭
如果你是Mac用户且发现无法使用，请继续看这一条
由于MacOS新版系统的原因，无法直接打开下载的脚本，所以要进行一些操作赋予执行权限并通过“无法验证开发者”。
用访达进入main.command所在的文件夹，将“显示”切换到“为分栏”，如图：

然后按照下图的指示进入终端：

最后执行下面的代码（复制进去按回车，期间大概率让你输密码）：
```
chmod +x main.command
sudo xattr -d -r com.apple.quarantine .
```
用数据线将电脑连接到 iPhone 或 iPad
如果你是Linux用户，记得给main.bin增加执行权限：chmod +x main.bin
Mac 用户打开 main.command，Windows 用户打开 main.exe，Linux 用户在终端中执行 ./main.bin
按照提示完成设备连接和开发者模式的开启
都好了大概就开跑了，默认无限循环
跑完之后请 务必使用 Ctrl + C 来停止，而非直接把窗口叉掉，否则不能自动恢复手机或pad的正常定位

FAQ

有一定的概率在第7、8步左右的时候，也就显示出你的系统版本之后会卡住，

这不是我的问题，我也没法修，解决方法是 Ctrl + C，这个时候脚本不会停，而是继续了，如果定位成功被修改了，那就不用管，如果定位模拟失败，那就继续 Ctrl + C ，再重新打开脚本
刚打开 main.exe 或 main.command 或 main.bin 的时候可能不会马上有东西显示（尤其是MacOS），请耐心等待

免责声明

本项目仅供 Python 和 C 学习交流作者对软件的用途不做任何说明或暗示。对使用本软件造成的一切后果概不负责

致谢

许可证

提交 4d932f 将许可证由 MIT 改为 MPL-2.0, 此后以 MPL-2.0 分发（除了libimobiledevice文件夹以外的部分）
libimobiledevice 文件夹里面的内容由 libimobiledevice 的Actions构建，许可证为 LGPL-2.1 或 GPL-2.0 ，本项目为对该项目进行链接，仅以命令行的方式对其二进制进行执行。

iosrealrun-cli's People