friman

Avez-vous déjà eu l'impression que trouver la bonne version de Frida pour le travail est comme enfiler une aiguille ? Avec différents projets, appareils et scénarios de débogage nécessitant tous des builds spécifiques, suivre les versions de Frida peut rapidement devenir un exercice d'équilibre fastidieux. friman (prononcé "free man") est conçu pour résoudre exactement ce problème.

Pourquoi

Il est courant de passer d'une version de Frida à l'autre car les différents environnements ne se comportent pas toujours de la même manière avec la dernière version. Selon ce que vous ciblez, une version spécifique peut être la seule à fonctionner de manière fiable. Les raisons courantes incluent :

• Caprices de l'appareil/OS : Les builds Android/iOS plus anciens ou inhabituels peuvent ne fonctionner qu'avec certaines versions de Frida.
• Compatibilité du projet : Certains scripts, outils ou workflows dépendent du comportement d'une version spécifique (par exemple, beaucoup d'API ont changé entre v16 et v17).
• Stabilité vs. fonctionnalités : Les versions plus récentes corrigent certains problèmes mais peuvent en introduire d'autres, donc la « bonne » version n'est pas toujours la plus récente.

Vue d'ensemble

Frida évolue rapidement, et différents projets ou appareils nécessitent souvent différentes versions. Passer manuellement de l'une à l'autre peut être source d'erreurs, surtout lorsqu'on jongle avec plusieurs environnements, binaires de serveur et gadgets.

friman fournit :

• Installation de version et changement transparent
• Suivi local de version
• Une structure de répertoire propre et isolée ($HOME/.friman)
• Aides pour télécharger les assets de version (actuellement les assets frida-gadget et frida-server)
• Utilitaires pratiques pour des actions comme pousser les binaires du serveur Frida vers des appareils Android

Son objectif est de rendre la gestion des versions de Frida aussi simple que possible.

Installation

La méthode d'installation recommandée est directement depuis GitHub :

# With pipx (recommended)
pipx install git+https://github.com/thelicato/friman

# Or with pip
pip install git+https://github.com/thelicato/friman

Après l'installation, exécutez les commandes suivantes :

friman ensurepath # Setup PATH for the currently selected Frida environment
friman update # Update the local list of available Frida versions and compatibility matrix

Utilisation

friman fournit une interface en ligne de commande pour installer, basculer et gérer plusieurs versions de Frida. Voici la sortie d'aide principale :

Usage: friman [OPTIONS] COMMAND [ARGS]...

Options:
  -v, --version  Show the application's version and exit.
  -d, --debug    Show debug output.
  -h, --help     Show this message and exit.

Commands:
  update       Update the local list of available Frida versions.
  install      Install a <version> of Frida.
  uninstall    Uninstall a <version> of Frida.
  use          Use <version>.
  disable      Disable friman.
  current      Display the currently activated version of Frida.
  list         List all the installed versions.
  ensurepath   Ensure friman directories are correctly set.
  download     Download a specific release file (only server and gadget)...
  push-server  Pushes a the Frida server into the selected ANDROID device.

Des commandes d'aide spécifiques sont disponibles dans les sections ci-dessous.

Usage: friman update [OPTIONS]

  Update the local list of available Frida versions.

Options:
  -h, --help  Show this message and exit.

Usage: friman install [OPTIONS] version

  Install a <version> of Frida.

Arguments:
  version  The version of Frida to install  \[required]

Options:
  -f, --force  Force install.
  --list       Show all the installable versions and exit.
  -h, --help   Show this message and exit.

Usage: friman uninstall [OPTIONS] version

  Uninstall a <version> of Frida.

Arguments:
  version  The version of Frida to uninstall  \[required]

Options:
  -h, --help  Show this message and exit.

Usage: friman use [OPTIONS] version

  Use <version>.

Arguments:
  version  The version of Frida to use  \[required]

Options:
  -h, --help  Show this message and exit.

Usage: friman disable [OPTIONS]

  Disable friman.

Options:
  -h, --help  Show this message and exit.

Usage: friman current [OPTIONS]

  Display the currently activated version of Frida.

Options:
  -h, --help  Show this message and exit.

Usage: friman list [OPTIONS]

  List all the installed versions.

Options:
  -h, --help  Show this message and exit.

Usage: friman ensurepath [OPTIONS]

  Ensure friman directories are correctly set.

Options:
  -h, --help  Show this message and exit.

Usage: friman download [OPTIONS] type platform

  Download a specific release file (only server and gadget) for the current
  version.

Arguments:
  type      The selected asset type  \[required]
  platform  The platform to use  \[required]

Options:
  -o, --output TEXT  Select the folder where to download the file.
  -h, --help         Show this message and exit.

Usage: friman push-server [OPTIONS] device_id platform

  Pushes a the Frida server into the selected ANDROID device.

Arguments:
  device_id  The selected ANDROID device  \[required]
  platform   The platform of the device  \[required]

Options:
  --list      Show all the USB devices and exit.
  -h, --help  Show this message and exit.

Contribuer

Les pull requests sont les bienvenues ! Veuillez d'abord ouvrir une issue pour discuter des changements majeurs.

Licence

friman est publié sous la LICENCE MIT