MagiskRenef

Un modulo Magisk / KernelSU / APatch che impacchetta e avvia automaticamente renef — un toolkit di instrumentazione dinamica per Android.

Ispirato da magisk-frida.

Requisiti

• Dispositivo Android con root (Magisk / KernelSU / KernelSU Next / APatch)
• Solo ARM64 — renef supporta solo Android ARM64
• Android 10+ consigliato

Installazione

1. Scarica l'ultimo MagiskRenef-{version}.zip da Releases
2. Installa tramite il tuo gestore root (Magisk / KSU / APatch)
3. Riavvia

Dopo il riavvio, renef_server si avvia automaticamente utilizzando UDS (Unix Domain Socket) sul socket astratto @com.android.internal.os.RuntimeInit.

Utilizzo

Connettiti dal tuo computer host utilizzando il client 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

Stato del Modulo

Dopo il riavvio, controlla l'elenco dei moduli del tuo gestore root:

• ✅ renef_server is running (UDS) — funzionante
• ❌ renef_server failed to start — consulta Risoluzione dei problemi

Risoluzione dei problemi

renef_server failed to start

Controlla il log del server:

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

L'iniezione fallisce — Failed to find libc base

Possibili cause:

• SELinux enforcing — causa più comune su ROM personalizzate / dispositivi Samsung:

  root@kitploit:~

  adb shell su -c setenforce 0
  

  Quindi riprova. Se funziona, il problema è che SELinux blocca l'iniezione di processo di renef.

• Dispositivo non rootato — renef_server deve essere eseguito come root (uid 0)

• Architettura errata — è supportato solo ARM64

L'avvio fallisce — app bancarie/rafforzate

Alcune app impostano android:exported="false" su tutte le attività. Il flag -s (avvio) utilizza monkey che non può avviarle. Usa invece -a (collegamento):

# 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

Come Funziona

Un flusso di lavoro GitHub Actions viene eseguito quotidianamente. Quando viene rilevata una nuova release di renef, esso:

1. Scarica renef-v{VERSION}-android-arm64.tar.gz dalle release di renef
2. Estrae renef_server e libagent.so
3. Li impacchetta in uno ZIP compatibile con Magisk
4. Pubblica una nuova release su GitHub

Build Locale

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

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

Crediti

• renef di Ahmeth4n
• magisk-frida di ViRb3 (ispirazione per la struttura)