# Textobot

**Repository Path**: geekneo/Textobot

## Basic Information

- **Project Name**: Textobot
- **Description**: 晓文框架-Text based iOS jailbreak plugin framework with Frida & Python.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 4
- **Created**: 2019-12-07
- **Last Updated**: 2022-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Textobot

#### Description

Text based iOS jailbreak plugin framework integrated with Frida & Python.

It's designed for replace Cydia deb plugin framework.

You can use just Python and JavaScript to write iOS jailbreak plugin, we called TB plugin.

Python in Textobot is running in system level.

JavaScript in Frida is running in process level.


Follow us for update or bug report:

|Platform|Account|
|-|-|
|Email|liubaijiang@yunyoo.cn|
|公众号|江哥说安全|
|头条抖音|刘柏江/江哥说安全|
|微博|刘柏江VM|
|码云|https://gitee.com/geekneo/|


#### Version History
2021.10.28-v2.0.1:
 * 更新内置Frida至v15.1.8兼容高版本Unc0ver；

2021.10.01-v2.0.0:
 * 1.更新内置Frida至v15.1.3兼容iOS 13/14（需要Unc0ver <= 6.1.2）；
 * 2.添加内置Python2的字符串默认编码格式为UTF8；

2021.09.25-v1.3.0:
 * 删除未启用的模块兼容iOS13/iOS14；

2021.07.29-v1.2.2:
 * 修复后台服务偶尔无法启动的问题；
 * 修复前台App偶尔执行命令闪退的问题；
 * 修复rocketbootstrap初始化依赖的问题；

2021.02.20-v1.2.1:
 * textfile添加plist读取支持；
 * textobot.dylib减少注入面； 

2021.01.15-v1.2.0:

 * IPC使用socket，解除对rocketbootstrap的依赖；

2021.01.12-v1.1.0:

 * 添加tbzip压缩命令行程序；
 * 添加getfile协议；

2019.12.26-v1.0.3:

 * TextobotApp集成至Textobot.deb；
 * TextobotApp适配范围iOS >= 10.x；

2019.12.25-v1.0.3:

 * 分离服务模块和注入模块；
 * 修复重复安装插件时不重载模块的问题；
 * 修复特殊情况下导致部分App闪退的问题；

2019.12.23-v1.0.2:

 * 修复卸载插件导致TB服务崩溃的问题；
 * 添加[SimpleGUI](https://gitee.com/geekneo/Textobot/tree/master/Sample/SimpleGUI)例子插件；

2019.12.21-v1.0.2:

 * 添加TB_gui控件接口；
 * 集成pyobjus； 

2019.12.19-v1.0.1:

 * 修复idle事件发送逻辑错误； 
 * 添加[Httpeek](https://gitee.com/geekneo/Textobot/tree/master/Sample/Httpeek)例子插件；
 * 添加[TextCapture](https://gitee.com/geekneo/Textobot/tree/master/Sample/TextCapture)例子插件；
 * 添加[URLCapture](https://gitee.com/geekneo/Textobot/tree/master/Sample/URLCapture)例子插件；

2019.12.18-v1.0.1:

 * 添加idle事件；

2019.12.17-v1.0.1:

 * 添加[TextobotApp](https://gitee.com/geekneo/Textobot/blob/master/iOS/TextobotApp.deb) for iOS >= 11.0；
 * 添加[AppleIDLogin](https://gitee.com/geekneo/Textobot/tree/master/Sample/AppleIDLogin)例子插件； 

2019.12.12-v1.0.1:

 * 添加apprun, appdie事件；

2019.12.08-v1.0.0:

 * Textobot发布初始版本；


#### Installation

##### iPhone

 * Install [RocketBootstrap](https://gitee.com/geekneo/Textobot/blob/master/iOS/RocketBootstrap-1.0.7.deb) to iPhone device;
 * Install [Textobot](https://gitee.com/geekneo/Textobot/blob/master/iOS/Textobot.deb) to iPhone device;

 Optional for iOS < 10.0
 * Install [SimulateTouch](https://gitee.com/geekneo/Textobot/blob/master/iOS/Utils/SimulateTouch-iOS8_9.deb) to iPhone device 
 
 ##### Desktop

 * Install [textobot-editor.vsix](https://gitee.com/geekneo/Textobot/blob/master/VSCode/textobot-editor.vsix) to Visual Studio Code.
 ```
 Must use 'Install from VSIX...' command to install but not double click.
 ```


#### How to use (User)

 * Goto VSCode ==> Settings ==> Extensions ==> Textobot;
 * Fill Textobot.IP with your iPhone's address;
 ```
 In settings, search: @ext:hybrage.textobot-editor
 ```
 ![textobot-editor-configuration](https://gitee.com/geekneo/Textobot/raw/master/Doc/screenshot/vscodecfg.png)
 * Goto Command Palette ==> search Textobot, you can install/start tb plugin there;
 ![textobot-editor-commands](https://gitee.com/geekneo/Textobot/raw/master/Doc/screenshot/cmdpalette.png)

#### How to use (Developer)

 * Goto VSCode ==> Settings ==> Extensions ==> Textobot;
 * Fill Textobot.IP with your iPhone's address;
 * Fill Textobot.Target with which app you want to control;
 ```
 In settings, search: @ext:hybrage.textobot-editor
 ```
 * Goto Command Palette ==> search Textobot, you can develop/run/pack tb plugin there;
 * The [Template Plugin Project](https://gitee.com/geekneo/Textobot/tree/master/Template) template code may be your startup point;
 * The [Sample Plugin Project](https://gitee.com/geekneo/Textobot/tree/master/Sample) will give you demonstration;
 * The [Textobot/Frida Python/JavaScript/C API](https://gitee.com/geekneo/Textobot/blob/master/Doc/api.md) will give you more help;

#### Screenshot

![textobot-editor-plugin](https://gitee.com/geekneo/Textobot/raw/master/Doc/screenshot/vscodeplugin.png)
![textobot-app-shell](https://gitee.com/geekneo/Textobot/raw/master/Doc/screenshot/appshell.jpg)
![textobot-app-plugin](https://gitee.com/geekneo/Textobot/raw/master/Doc/screenshot/appplugin.png)
![textobot-app-about](https://gitee.com/geekneo/Textobot/raw/master/Doc/screenshot/appabout.png)