Frida UI

Une interface utilisateur web moderne et légère pour Frida, conçue pour les tests de pénétration d'applications Android. Elle vous permet d'interagir avec les appareils, les processus et les scripts directement depuis votre navigateur.

Démarrage rapide

# Installer avec uv (recommandé) ou pipx/pip
uv tool install frida-ui
# Ou : pipx install frida-ui
# Ou : pip install frida-ui

# Démarrer le serveur
frida-ui

Ouvrez votre navigateur et accédez à : http://localhost:8000

Fonctionnalités

📱 Gestion des appareils

• Découverte automatique : Détecte automatiquement les appareils USB connectés et locaux.
• Appareils distants : Ajoutez et gérez facilement des serveurs Frida distants (ex : 192.168.1.x:27042).
• Informations sur l'appareil : Affiche les paramètres système détaillés (OS, Architecture, Niveau d'API) et des indicateurs visuels de type pour l'appareil sélectionné.

🚀 Contrôle des processus et applications

• Liste des applications : Affiche les applications installées et les processus en cours.
• Recherche : Filtrage en temps réel des applications par nom ou identifiant.
• Gestion des sessions :
  • Attacher : Se connecter à des processus en cours.
  • Lancer : Démarrer des applications installées.
  • Lancer & Exécuter : Lancer une application et injecter immédiatement le script de l'éditeur ainsi que tous les scripts CodeShare en attente (instrumentation précoce).
  • Tuer/Détacher : Terminer les processus ou se déconnecter proprement.

💻 Scripting et instrumentation

• Éditeur de scripts : Éditeur intégré pour écrire des scripts Frida. Inclut un éditeur Monaco optionnel pour une édition plus riche (coloration syntaxique et mise en page automatique) avec un repli élégant vers une simple zone de texte.
• Chargement de fichiers : Charger des scripts depuis des fichiers locaux ou glisser-déposer des fichiers .js dans l'éditeur.
• Télécharger le script : Exporter le contenu actuel de l'éditeur sous forme de fichier .js (frida-ui_<id app>_<timestamp>.js) directement depuis l'en-tête de l'éditeur.
• Intégration CodeShare :
  • Importer des scripts directement depuis Frida CodeShare.
  • File d'attente CodeShare : Mettre plusieurs scripts CodeShare en file d'attente pour qu'ils soient chargés et exécutés automatiquement lors du Lancer & Exécuter ou manuellement via le bouton « Exécuter les scripts CodeShare ».

📊 Console et journalisation

• Sortie en temps réel : Affiche les messages console.log, send() et les erreurs de vos scripts.
• Historique des logs : Logs persistants par session d'application.
• Exportation : Télécharger les logs de la console au format .txt pour analyse.

🎨 Interface utilisateur/expérience

• Thème sombre : Interface sombre, propre et cohérente.
• Persistance : Mémorise l'appareil, l'application et les tailles de panneaux sélectionnés entre les sessions.
• Responsive : Panneaux ajustables pour la barre latérale, l'éditeur et la console.
• Modes de concentration : Basculez vers les vues Éditeur uniquement ou Console uniquement pour masquer les autres panneaux et travailler sans distraction.
• Accessibilité : Raccourcis clavier (ex : Échap pour réinitialiser la vue ou fermer les superpositions) et support ARIA.

Pour commencer

Prérequis

• Python 3.7+
• uv (recommandé) / pipx / pip.

Installation

Option 1 : Installer depuis PyPI (recommandé)

uv tool install frida-ui

Vous pouvez également personnaliser la version de Frida :

uv tool install frida-ui --with frida==16.7.19

Option 2 : Installer depuis les sources (version de développement)

uv tool install git+https://github.com/adityatelange/frida-ui

Vous pouvez personnaliser la version de Frida :

uv tool install git+https://github.com/adityatelange/frida-ui --with frida==16.7.19

[!IMPORTANT] La version de Frida que vous installez doit correspondre à la version de frida-server sur votre appareil Android pour garantir la compatibilité.

Exécution

Démarrez le serveur avec la configuration par défaut :

frida-ui

Ou avec des options personnalisées :

frida-ui --host 127.0.0.1 --port 8000 --reload

• --host : Spécifie l'hôte (par défaut : 127.0.0.1)
• --port : Spécifie le port (par défaut : 8000)
• --reload : Active le rechargement automatique pour le développement

Ouvrez http://localhost:8000 dans votre navigateur.

Configuration de l'appareil Android

Avant d'utiliser frida-ui, vous devez avoir frida-server en cours d'exécution sur votre appareil Android. La version de frida-server doit correspondre à la version de Frida que vous avez installée à l'étape précédente.

Option 1 : Connexion USB

Si vous avez ADB installé et souhaitez vous connecter via USB :

1. Télécharger frida-server : Rendez-vous sur les versions de Frida et téléchargez le binaire frida-server pour Android correspondant à l'architecture/ABI de votre appareil (ex : frida-server-x.x.x-android-arm64.xz).

2. Extraire et pousser vers l'appareil :

   root@kitploit:~

   unxz frida-server-x.x.x-android-arm64.xz
   mv frida-server-x.x.x-android-arm64 frida-server
   adb push frida-server /data/local/tmp/
   

3. Lancer frida-server :

   root@kitploit:~

   adb shell "chmod 755 /data/local/tmp/frida-server"
   adb shell "/data/local/tmp/frida-server -D"
   

4. Vérifier la connexion : Assurez-vous que votre appareil est connecté via USB et visible avec adb devices. frida-ui le détectera automatiquement lors de son exécution.

Option 2 : Connexion distante (réseau)

Vous pouvez également exécuter frida-server avec un écouteur réseau et vous connecter à distance :

1. Télécharger et exécuter frida-server sur votre appareil Android (par n'importe quelle méthode - ADB, script personnalisé, etc.) :

   root@kitploit:~

   ./frida-server -l 0.0.0.0:27042 -D
   

2. Ajouter un appareil distant dans frida-ui : Dans l'interface de frida-ui, ajoutez un appareil distant avec l'adresse IP et le port où frida-server écoute (ex : 192.168.1.x:27042).

   Aucune installation d'ADB n'est requise pour cette méthode.

Guide d'utilisation

1. Sélectionner un appareil : Choisissez un appareil dans la liste déroulante de l'en-tête supérieur.
2. Sélectionner une application : Cliquez sur une application dans la barre latérale.
3. Écrire/Charger un script :
   • Tapez du JS dans l'éditeur.
   • Ou glissez-déposez un fichier.
   • Ou ajoutez l'URL d'un script depuis CodeShare.
4. Action :
   • Cliquez sur Attacher pour injecter dans un processus en cours.
   • Cliquez sur Lancer pour démarrer l'application.
   • Cliquez sur Lancer & Exécuter pour démarrer l'application avec votre script injecté immédiatement.
5. Surveiller : Observez la console pour la sortie.

💡 Exemple de script

Essayez ce simple script pour accrocher une méthode (remplacez par votre cible) :

// Exemple d'accrochage de méthode
Java.perform(() => {
  const MainActivity = Java.use("com.example.app.MainActivity");
  MainActivity.checkPassword.implementation = function (password) {
    console.log("[*] checkPassword appelé avec : " + password);
    return true; // Contourner la vérification
  };
});

Remarques

[!NOTE] Cet outil est un projet indépendant et ne fait pas partie de la boîte à outils officielle de Frida et n'est pas sponsorisé par le projet Frida. Il s'agit d'une interface utilisateur tierce conçue pour interagir avec les fonctionnalités de base de Frida.

[!WARNING] Cet outil permet d'exécuter du JavaScript arbitraire dans les processus cibles. N'exposez frida-ui qu'à des réseaux et utilisateurs de confiance. L'exécution de scripts non fiables peut compromettre votre système et vos données. Le serveur web s'exécute localement par défaut, mais expose des capacités d'instrumentation puissantes.

Crédits

• Projet Frida - https://frida.re/.
• Éditeur Monaco - https://microsoft.github.io/monaco-editor/.
• Merci à Github Copilot pour les suggestions de code et les améliorations.

Évolution du nombre d'étoiles