Metadata-Version: 2.4
Name: frida-server
Version: 1.0.0
Summary: Zero-config frida-server deployment for Android — detect the device, match your PC's Frida version, download, push, and run.
Author-email: "S. SHAJON" <shahmakhdumshajon@gmail.com>
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/SHAJON-404/frida-server
Project-URL: Repository, https://github.com/SHAJON-404/frida-server
Project-URL: Issues, https://github.com/SHAJON-404/frida-server/issues
Project-URL: Changelog, https://github.com/SHAJON-404/frida-server/blob/main/CHANGELOG.md
Keywords: frida,frida-server,android,adb,reverse-engineering,instrumentation,mobile-security,pentest
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.20
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"
Requires-Dist: pytest>=7.0; extra == "dev"
Dynamic: license-file

<div align="center">

# frida-server

### Zero-config `frida-server` deployment for Android

One command detects your device, downloads the `frida-server` build matching your
PC's Frida version, verifies it, pushes it, and starts it.

<p>
  <a href="https://pypi.org/project/frida-server/"><img alt="PyPI" src="https://img.shields.io/pypi/v/frida-server.svg"></a>&nbsp;
  <a href="https://pypi.org/project/frida-server/"><img alt="Python versions" src="https://img.shields.io/pypi/pyversions/frida-server.svg"></a>&nbsp;
  <a href="LICENSE"><img alt="License: GPL-3.0" src="https://img.shields.io/badge/License-GPLv3-blue.svg"></a>
</p>

</div>

---

## Features

- **Auto-detects** the device and its CPU architecture.
- **Version-matched** — deploys the `frida-server` that matches your PC's Frida (installs Frida if missing).
- **Bundled `adb`** — downloads platform-tools automatically when `adb` isn't on your `PATH`.
- **SHA-256 verified** — re-deploys automatically if the on-device binary is corrupt or mismatched.
- **Multi-device** — handles several devices with independent per-architecture checksums.
- Works as a **CLI** or a **Python library**.

---

## Install

```bash
pip install frida-server
```

Requires **Python 3.8+** and a **rooted** Android device/emulator (`su` or a userdebug image) with USB debugging on.

---

## Usage

```bash
frida-server                     # detect a device and deploy
frida-server -s emulator-5554    # target a specific serial
frida-server --no-update         # skip the Frida update check
frida-server --force             # re-download even if versions match
frida-server --port 27043        # forward a custom port
```

From Python:

```python
from frida_server import setup

setup(serial="emulator-5554", update=False)
```

---

## ⚖️ License & Disclaimer

This project is licensed under the **GNU General Public License v3.0** (GPL-3.0). See the [`LICENSE`](LICENSE) file for more details. © S. SHAJON

> **Disclaimer:** This tool is intended for authorized security testing and research on devices you own or have explicit permission to test. You are solely responsible for how you use it.
