MagiskRenef

Un module Magisk / KernelSU / APatch qui empaquette et exécute automatiquement renef — un kit d'instrumentation dynamique pour Android.

Inspiré par magisk-frida.

Prérequis

• Appareil Android rooté (Magisk / KernelSU / KernelSU Next / APatch)
• ARM64 uniquement — renef ne prend en charge que l'ARM64 Android
• Android 10+ recommandé

Installation

1. Téléchargez le dernier MagiskRenef-{version}.zip depuis les Releases
2. Installez via votre gestionnaire root (Magisk / KSU / APatch)
3. Redémarrez

Après le redémarrage, renef_server démarre automatiquement en utilisant UDS (socket de domaine Unix) sur le socket abstrait @com.android.internal.os.RuntimeInit.

Utilisation

Connectez-vous depuis votre machine hôte en utilisant le 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

État du module

Après le redémarrage, vérifiez la liste des modules de votre gestionnaire root :

• ✅ renef_server is running (UDS) — sain
• ❌ renef_server failed to start — voir la section Dépannage

Dépannage

renef_server n'a pas réussi à démarrer

Vérifiez le journal du serveur :

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

L'injection échoue — Failed to find libc base

Causes possibles :

• SELinux enforcing — cause la plus fréquente sur les ROMs personnalisées / appareils Samsung :

  root@kitploit:~

  adb shell su -c setenforce 0
  

  Puis réessayez. Si cela fonctionne, le problème est que SELinux bloque l'injection de processus de renef.

• Appareil non rooté — renef_server doit s'exécuter en tant que root (uid 0)

• Mauvaise architecture — seul ARM64 est pris en charge

L'ouverture échoue — applications bancaires/renforcées

Certaines applications définissent android:exported="false" sur toutes les activités. Le flag -s (spawn) utilise monkey qui ne peut pas les lancer. Utilisez plutôt -a (attach) :

# 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

Comment ça fonctionne

Un workflow GitHub Actions s'exécute quotidiennement. Lorsqu'une nouvelle version de renef est détectée, il :

1. Télécharge renef-v{VERSION}-android-arm64.tar.gz depuis les versions de renef
2. Extrait renef_server et libagent.so
3. Les empaquette dans un ZIP compatible Magisk
4. Publie une nouvelle version GitHub

Construction locale

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

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

Crédits

• renef par Ahmeth4n
• magisk-frida par ViRb3 (inspiration de la structure)