friman

¿Alguna vez has sentido que encontrar la versión correcta de Frida para el trabajo es como enhebrar una aguja? Con diferentes proyectos, dispositivos y escenarios de depuración que requieren compilaciones específicas, hacer un seguimiento de las versiones de Frida puede convertirse rápidamente en un tedioso acto de equilibrio. friman (pronunciado "free man") está diseñado para resolver exactamente este problema.

Por qué

Es común cambiar entre versiones de Frida porque los diferentes entornos no siempre se comportan igual con la última versión. Dependiendo de lo que estés atacando, una versión específica puede ser la única que funcione de manera fiable. Las razones comunes incluyen:

• Peculiaridades del dispositivo/SO: Las compilaciones antiguas o inusuales de Android/iOS pueden funcionar solo con ciertas versiones de Frida.
• Compatibilidad de proyectos: Algunos scripts, herramientas o flujos de trabajo dependen del comportamiento de una versión específica (p. ej., muchas APIs cambiaron entre v16 y v17).
• Estabilidad vs. características: Las versiones más nuevas corrigen algunos problemas, pero pueden introducir otros, por lo que la versión “correcta” no siempre es la más reciente.

Resumen

Frida evoluciona rápidamente, y diferentes proyectos o dispositivos a menudo requieren versiones distintas. Cambiar manualmente puede ser propenso a errores, especialmente cuando se manejan múltiples entornos, binarios de servidor y gadgets.

friman ofrece:

• Instalación de versiones y cambio fluido entre ellas
• Seguimiento local de versiones
• Una estructura de directorios limpia y aislada ($HOME/.friman)
• Ayudantes para descargar archivos de lanzamiento (actualmente archivos de frida-gadget y frida-server)
• Utilidades convenientes para acciones como enviar binarios del servidor de Frida a dispositivos Android

Su objetivo es hacer que la gestión de versiones de Frida sea lo más fluida posible.

Instalación

El método de instalación recomendado es directamente desde GitHub:

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

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

Después de instalar, ejecuta lo siguiente:

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

Uso

friman proporciona una interfaz de línea de comandos para instalar, cambiar y gestionar múltiples versiones de Frida. A continuación se muestra la salida de ayuda principal:

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.

Los comandos de ayuda específicos están disponibles en las siguientes secciones.

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.

Contribuciones

¡Las pull requests son bienvenidas! Por favor, abre un issue primero para discutir cambios importantes.

Licencia

friman se publica bajo la Licencia MIT