fridaDownloader 1.3.0
fridaDownloader is a command-line tool that streamlines downloading the Frida Gadget or Server for Android, enabling developers and security researchers to quickly access the components needed for dynamic instrumentation.
Requires Python: >=3.6

# 🛠️ fridaDownloader

fridaDownloader is a command-line tool that streamlines downloading the Frida Gadget or Server for Android, enabling developers and security researchers to quickly access the components needed for dynamic instrumentation.

![GitHub Release](https://img.shields.io/github/v/release/mateofumis/FridaDownloader)
![PyPI - Version](https://img.shields.io/pypi/v/fridaDownloader)
![PyPI - Downloads](https://img.shields.io/pypi/dm/fridaDownloader)

## Features

- **Download Options**: Easily download either the Frida Gadget or Server for Android.
- **Specific Version**: Specify a particular version of Frida to download using the `--version VERSION` option or it will download the latest version by default.
- **Target Selection**: Choose the target for download with the `--target` option, allowing you to select either `gadget` or `server`.
- **Architecture Support**: Select the appropriate Android architecture with the `--architecture` option. Supported architectures include:
  - `arm`
  - `arm64`
  - `x86`
  - `x86_64`
- **Custom Output Directory**: Use the `--output` option to specify a directory for saving the downloaded file, with a default location of `~/Downloads`.

## Installation

### Manual:

1. Clone the repository:

```bash
git clone https://github.com/mateofumis/fridaDownloader.git
cd fridaDownloader
```

2. Set up a virtual environment (optional but recommended):

```bash
python3 -m venv env
source env/bin/activate  # On Windows use `.\env\Scripts\activate`
```

3. Install dependencies:

```bash
pip3 install -r requirements.txt
```

### Using pip (or pipx) install

- Install fridaDownloader with pip3

```bash
pip3 install fridaDownloader 
```
- Install fridaDownloader with pipx

```bash
pipx install fridaDownloader 
```

## Usage

```bash
$: fridaDownloader -h

*********************************************
*  Welcome to the Frida Downloader          *
*                           by hackermater  *
*********************************************

usage: fridaDownloader.py [-h] [-v VERSION] -t {gadget,server} [-a ARCHITECTURE] [-o OUTPUT]

Download Frida Gadget or Server for Android

options:
  -h, --help            show this help message and exit
  -v, --version VERSION     Download a specific version of Frida
  -t, --target {gadget,server}
                        Specify the target to download: gadget or server
  -a, --architecture ARCHITECTURE
                        Android architecture (default: arm). Options: arm, arm64, x86, x86_64
  -o, --output OUTPUT       Directory to save the downloaded file (default: ~/Downloads)
```

## Examples

- Download the last version of Frida Server for x86 architecture:

```bash
python3 fridaDownloader.py -t server -a x86
```

- Download a specific version of Frida Gadget for arm64 architecture with specific output:

```bash
python3 fridaDownloader.py -t gadget -a arm64 -v 15.2.0 -o ~/Frida/Gadget/frida-gadget-arm64
```

## License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

## Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue.

## Support me with a virtual Coffee! ❤️

<a href="https://ko-fi.com/hackermater">
    <img src="https://storage.ko-fi.com/cdn/brandasset/kofi_button_stroke.png" alt="Ko-Fi" width="400" />
</a>