Skip to content

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

License

Notifications You must be signed in to change notification settings

GoatCsu/iOSRealRun-cli

 
 

Repository files navigation

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位系统

使用方法

大概步骤:

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

    打开路径拾取网站。通过点击地图构造路径。点击时无需考虑间距,会自动用直线连接。路径点击完成后,单击上方的路径坐标——复制,将坐标数据复制到剪贴板

  5. 打开脚本目录里的 route.txt 文件,将刚复制的内容原封不动的粘贴进去,保存并退出
  6. 对于 Windows,你需要安装 iTunes,以确保驱动正常运行
  7. 在脚本目录中的 config.yaml 文件中设置 v 变量以设置速度(m/s),给个参考,3.3大概是5分到5分半的配速(我也没仔细看)
  8. Mac用户和Windows用户可能需要打开iTunes,且在跑完前不应关闭
  9. 如果你是Mac用户且发现无法使用,请继续看这一条
    由于MacOS新版系统的原因,无法直接打开下载的脚本,所以要进行一些操作赋予执行权限并通过“无法验证开发者”。
    用访达进入main.command所在的文件夹,将“显示”切换到“为分栏”,如图:

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

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

FAQ

  • 有一定的概率在第7、8步左右的时候,也就显示出你的系统版本之后会卡住,
    图片
    这不是我的问题,我也没法修,解决方法是 Ctrl + C,这个时候脚本不会停,而是继续了,如果定位成功被修改了,那就不用管,如果定位模拟失败,那就继续 Ctrl + C ,再重新打开脚本
  • 刚打开 main.exemain.commandmain.bin 的时候可能不会马上有东西显示(尤其是MacOS),请耐心等待

免责声明

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

致谢

许可证

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

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 98.9%
  • Shell 1.1%