Metadata-Version: 2.4
Name: frida-down
Version: 0.1.4
Summary: A lightweight Frida binaries downloader
Author-email: its-me-abi <keralaboypypi@keralaboy.anonaddy.com>
License-Expression: AGPL-3.0-only
Project-URL: Homepage, https://github.com/its-me-abi/frida_down
Project-URL: Repository, https://github.com/its-me-abi/frida_down.git
Project-URL: Bug Tracker, https://github.com/its-me-abi/frida_down/issues
Project-URL: Documentation, https://github.com/its-me-abi/frida_down#readme
Keywords: frida,downloader,binaries,android,reverse-engineering
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Software Distribution
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: certifi==2026.5.20
Requires-Dist: cffi==2.0.0
Requires-Dist: charset-normalizer==3.4.7
Requires-Dist: cryptography==48.0.0
Requires-Dist: idna==3.17
Requires-Dist: pycparser==3.0
Requires-Dist: PyGithub==2.9.1
Requires-Dist: PyJWT==2.13.0
Requires-Dist: PyNaCl==1.6.2
Requires-Dist: requests==2.34.2
Requires-Dist: typing_extensions==4.15.0
Requires-Dist: urllib3==2.7.0
Dynamic: license-file

# ⬇️ frida_down 

> A lightweight Frida binaries downloader ( unofficial )

to know more about frida [https://github.com/frida/frida](https://github.com/frida/frida/releases)
## 📋 Prerequisites

- Python 3.x
- pip (Python package manager)
- `GITHUB_TOKEN` environment variable set (optional ,without this 60 requests per hour per ip is only allowed because of ratelimit)

## 🚀 Quick Start

```bash
# Clone the repository
git clone https://github.com/its-me-abi/frida_down.git
cd frida_down

# Install dependencies
pip install -r requirements.txt

# Set your GitHub token
export GITHUB_TOKEN=your_github_token_here
```

## 📖 API Usage

### Download Frida Binaries

```python
from frida_down import frida

# Initialize downloader
downloader = frida()

# Get latest release
release = downloader.get_release()

# Get specific release by tag name
release = downloader.get_release("17.10.0")

# Download a specific asset
filepath = downloader.download(downloader.latest, "frida-server-17.10.0-android-arm64.xz")

# List all assets in latest release
for asset in downloader.get_all_assets():
    print(asset.name)

# List all assets in specific release
for asset in downloader.get_all_assets("17.10.0"):
    print(asset.name)
```

### Parse Asset Names

```python
from frida_down import assetname_parser

# Parse Android asset names
asset_info = assetname_parser.parse(
    "frida-server-17.10.0-android-arm64.xz",
    assetname_parser.platform.android
)
# Returns: {
#     "asset_type": "frida-server",
#     "version": "17.10.0",
#     "arch": "arm64",
#     "filename": "frida-server-17.10.0-android-arm64.xz"
# }
```

### Android-Specific Helper

```python
from frida_down import android

# Initialize Android downloader
android_dl = android()

# Get all latest Android assets (parsed)
for asset_info in android_dl.get_latest_assets():
    print(asset_info)
    # Returns parsed asset information including version, architecture, and type
```

### Custom Download Path

```python
from frida_down import frida

# Specify custom download path
downloader = frida ( download_folder_path = "/path/to/save/frida_server" )

# Download will save to the specified path
filepath = downloader.download("", "frida-server-17.10.0-android-arm64.xz")
print( "file downloaded " , filepath )
```

## 📦 LICENCE
AGPL

