MagiskRenef

Un módulo de Magisk / KernelSU / APatch que empaqueta y ejecuta automáticamente renef — un kit de instrumentación dinámica para Android.

Inspirado por magisk-frida.

Requisitos

• Dispositivo Android rooteado (Magisk / KernelSU / KernelSU Next / APatch)
• Solo ARM64 — renef solo soporta Android ARM64
• Android 10+ recomendado

Instalación

1. Descargue el último MagiskRenef-{version}.zip desde Releases
2. Instálelo mediante su gestor de root (Magisk / KSU / APatch)
3. Reinicie

Después del reinicio, renef_server se inicia automáticamente usando UDS (Unix Domain Socket) en el socket abstracto @com.android.internal.os.RuntimeInit.

Uso

Conéctese desde su máquina anfitrión usando el cliente renef:

# Spawn a new process
renef -s com.example.app -l your-script.lua

# Attach to running process (open the app first)
adb shell su 0 sh -c "pidof com.example.app"   # get PID
renef -a <PID> -l your-script.lua

Estado del Módulo

Después del reinicio, verifique la lista de módulos de su gestor de root:

• ✅ renef_server is running (UDS) — saludable
• ❌ renef_server failed to start — consulte Solución de Problemas

Solución de Problemas

renef_server failed to start

Revise el registro del servidor:

adb shell su 0 cat /data/local/tmp/renef_server.log

Fallo de Inyección — Failed to find libc base

Posibles causas:

• SELinux en modo enforcing — la causa más común en ROMs personalizadas / dispositivos Samsung:

  root@kitploit:~

  adb shell su -c setenforce 0
  

  Luego intente de nuevo. Si funciona, el problema es que SELinux bloquea la inyección de procesos de renef.

• Dispositivo no rooteado — renef_server debe ejecutarse como root (uid 0)

• Arquitectura incorrecta — solo se soporta ARM64

Fallo al Generar Procesos — aplicaciones bancarias/endurecidas

Algunas aplicaciones establecen android:exported="false" en todas las actividades. La bandera -s (generar) usa monkey que no puede lanzarlas. Use -a (adjuntar) en su lugar:

# 1. Open the app manually on your device
# 2. Get its PID
adb shell su 0 sh -c "pidof com.example.app"
# 3. Attach
renef -a <PID> -l your-script.lua

Cómo Funciona

Un flujo de trabajo de GitHub Actions se ejecuta a diario. Cuando se detecta una nueva versión de renef, realiza lo siguiente:

1. Descarga renef-v{VERSION}-android-arm64.tar.gz desde los lanzamientos de renef
2. Extrae renef_server y libagent.so
3. Los empaqueta en un ZIP compatible con Magisk
4. Publica un nuevo lanzamiento en GitHub

Compilación Local

# Install uv (https://docs.astral.sh/uv/)
uv run python3 main.py

# Force a rebuild
FORCE_RELEASE=1 uv run python3 main.py

Créditos

• renef por Ahmeth4n
• magisk-frida por ViRb3 (inspiración de estructura)