Repository files navigation

README 中文版

Twoyi is a lightweight Android container. It runs a nearly complete Android system as a normal app (no root required) on Android. Additionally, it supports Android 8.1 ~ 12.

1. Use Taichi·Yang without unlocking the bootloader. Xposed, EdXposed and LSPosed will be supported.
2. Use root on non-rooted devices.
3. Use a few Magisk modules.
4. Implement additional system components such as virtual camera by virtualizing the HAL layer.
5. Do security research such as shelling.

1. Twoyi is a rootless Android system-level container, which runs a nearly complete Android system as a normal app and is mostly isolated from the main system.
2. The internal Android version is Android 8.1 and Android 10 will be supported.
3. Booting up twoyi is very fast (within three seconds) except for the initialization process.
4. Twoyi is an open source project.
5. The internal system of twoyi will be fully customizable. Because its system is open source, you can fork the project to compile your own system. You can also customize the system components, such as the HAL layer to implement virtual cameras, virtual sensors and other special features.

Twoyi contains two parts:

1. The twoyi app, which is actually a UI rendering engine.
2. The internal ROM of twoyi.

This repository contains the twoyi app, and the twoyi ROM is currently being turned into open-source. Therefore, at this moment, the ROM cannot be compiled from source yet.

Twoyi is partially written in Rust, so it's nessesary toinstall Rust and Cargo first.

Please refer tocargo-xdk.

You can check if it is installed by running./gradlew cargoBuild. If it succeeded, you will see libtwoyi.so inapp/src/main/jniLibs/arm64-v8a.

PS. Please use ndk v22 or lower, otherwise it may fail.

Currently you cannot build the ROM yourself, instead you can use the prebuilt ROM.To do that, extract rootfs.7z from the official release apk and copy it toapp/src/main/assets.

Build it with Android Studio normally.

WIP

Telegram Group

twsxtd@gmail.com