PAGASUS-PRO

**Paso 2 — Instalar Python 3**```bash
sudo apt install python3 python3-pip -y

**Paso 4 — Instalar scrcpy** *(opcional — para Screen Mirror)*```bash
sudo apt install scrcpy -y

**Paso 6 — Clonar el repositorio**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> ¿Quieres ejecutar una versión anterior?
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 🔷 Linux — Arch / Manjaro / BlackArch

**Paso 1 — Actualizar el sistema**```bash
sudo pacman -Syu

**Paso 3 — Instalar scrcpy** *(opcional)*```bash
sudo pacman -S scrcpy

**Paso 5 — Clonar el repositorio**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> ¿Quieres ejecutar una versión anterior?
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 🪟 Windows 10 / 11

**Paso 1 — Instalar Python 3**

1. Descárgalo desde: https://www.python.org/downloads/
2. Ejecuta el instalador
3. ✅ **Marca "Add Python to PATH"** antes de hacer clic en Install

Verifica en el Símbolo del sistema o PowerShell:```cmd
python --version

> ADB se añade automáticamente al PATH — no se necesita configuración manual.

Verificar:```cmd
adb version

Verificar:```powershell
scrcpy --version

Verificar:```powershell
git --version

> ✅ Esto instala Python, ADB, scrcpy y Git de una sola vez. Reinicia PowerShell después de esto.

---

**Paso 6 — Clonar el repositorio**

Abre **Command Prompt** o **PowerShell**:```powershell
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

**Paso 8 — Ejecutar Pegasus v1.3**```powershell
python pegasus_v_1.3.py

**Paso 2 — Instalar Python 3**```bash
brew install python

**Paso 3 — Instalar ADB**```bash
brew install android-platform-tools

**Paso 4 — Instalar scrcpy** *(opcional)*```bash
brew install scrcpy

**Paso 6 — Clonar el repositorio**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> ¿Quieres ejecutar una versión anterior?
> ```bash
> python3 pegasusV-1.2.py   # Ejecutar v1.2
> python3 pegasus_v1.1.py   # Ejecutar v1.1
> ```

---

### 📱 Termux (Ejecutar directamente desde tu teléfono Android)

> **¿Qué es Termux?** Termux es un emulador de terminal de Android que proporciona un entorno Linux completo en tu teléfono — sin necesidad de root. Puedes ejecutar Pegasus directamente desde tu dispositivo Android usando Termux.

> ⚠️ **Nota:** `scrcpy` (Screen Mirror — Opción 5) **no funciona** en Termux porque requiere un servidor de pantalla que no está disponible en Android. Todas las demás funciones funcionan con normalidad.

#### Instalar Termux

1. **Instala Termux desde F-Droid** *(Recomendado)*  
   👉 https://f-droid.org/packages/com.termux/  
   > ⚠️ La versión de Termux de Google Play Store está desactualizada — usa siempre la versión de F-Droid.

2. Abre Termux y sigue los pasos a continuación:

**Paso 1 — Actualizar paquetes**```bash
pkg update && pkg upgrade -y

**Paso 3 — Instalar Git**```bash
pkg install git -y

Verificar la instalación:```bash
adb version

**Paso 6 — Clonar el repositorio**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

**Paso 8 — Ejecutar Pegasus v1.3**```bash
python pegasus_v_1.3.py

4. Desconecta el cable USB, luego encuentra la IP del dispositivo objetivo:  
   → Ajustes → Wi-Fi → Toca la red conectada → Dirección IP
5. Ejecuta Pegasus y selecciona **`[2] Connect a Device`**
6. Introduce la dirección IP — la conexión inalámbrica ya está activa ✅

**Método 2 — Gestionar el mismo dispositivo (localhost)**

Si quieres gestionar tu propio teléfono directamente:```bash
adb connect localhost:5555

### Cambiar a Modo Inalámbrico (Wi-Fi ADB)

> Se requiere una configuración USB única. Después de eso, pasa a ser completamente inalámbrico.

1. Conecta el dispositivo mediante cable USB
2. Inicia Pegasus → Selecciona **`[2] Connect a Device`**
3. Introduce `y` cuando se solicite habilitar el modo TCP/IP
4. Encuentra la IP de tu dispositivo: **Ajustes → Wi-Fi → Toca la red conectada → Dirección IP**
5. Introduce la IP en Pegasus cuando se solicite
6. Desconecta el USB — la conexión ahora es inalámbrica ✅

---

## 🚀 Uso```bash
# Linux / macOS — Latest Version
python3 pegasus_v_1.3.py

# Windows — Latest Version
python pegasus_v_1.3.py

# Run older versions
python3 pegasusV-1.2.py    # v1.2
python3 pegasus_v1.1.py    # v1.1

---

## 📂 Archivos de Salida

Todos los archivos generados se guardan en el **mismo directorio** donde ejecutas el script.

| Nombre del Archivo | Generado Por |
|----------|-------------|
| `screen.png` | Take Screenshot |
| `record.mp4` | Screen Recording |
| `apk_list.txt` | Show APK List |
| `contacts.txt` | Dump Contacts |
| `device_log.txt` | Get Device Logs |
| `storage_info.txt` | Check Storage |
| `sms_logs.txt` | Dump SMS (Security Tools) |
| `call_logs.txt` | Dump Call Logs (Security Tools) |
| `connection_log.txt` | Auto-generated connection session log |

---

## 📋 Resumen de Dependencias

| Dependencia | Requerida | Propósito | Instalación (Linux/macOS) | Instalación (Termux) |
|-----------|----------|---------|-----------------------|-----------------|
| Python 3.7+ | ✅ Sí | Ejecutar la herramienta | `sudo apt install python3` | `pkg install python` |
| colorama | ✅ Sí | Salida de terminal con color | `pip3 install colorama` | `pip install colorama` |
| ADB | ✅ Sí | Comunicación con el dispositivo | `sudo apt install adb` | `pkg install android-tools` |
| scrcpy | ⚪ Opcional | Función de Espejo de Pantalla | `sudo apt install scrcpy` | ❌ Termux mein kaam nahi |
| nmap | ⚪ Opcional | Escaneo de red en Security Tools | `sudo apt install nmap` | `pkg install nmap` |
| Git | ⚪ Recomendado | Clonar el repositorio | `sudo apt install git` | `pkg install git` |

> 💡 **Atajo:** `pip install -r requirements.txt` se sab Python dependencies ek baar mein install ho jaati hain.

---

## 📁 Referencia de Archivos

| Archivo | Versión | Comando de Ejecución |
|------|---------|-------------|
| `pegasus_v_1.3.py` | v1.3 *(Última)* | `python3 pegasus_v_1.3.py` |
| `pegasusV-1.2.py` | v1.2 | `python3 pegasusV-1.2.py` |
| `pegasus_v1.1.py` | v1.1 | `python3 pegasus_v1.1.py` |
| `requirements.txt` | — | `pip install -r requirements.txt` |

---

## 📝 Registro de Cambios

### v1.3 — Última Versión
- ✅ **Submenú Advanced Security Tools** añadido (Opción 22) — 10 funciones:
  - Root Detection (multi-method), APK Permissions Audit, Full Security Audit
  - Debuggable Apps Scanner, Interactive Shell, Network Security Check
  - SMS/Call Log Dump, Security Log Filter, Vulnerability Scanner, Network Monitor
- ✅ **Historial de Conexión de Dispositivos** con marcas de tiempo y duración de sesión (Opción 23)
- ✅ **Soporte multi-dispositivo** — listar y seleccionar cuando se detectan múltiples dispositivos
- ✅ **Desconexión inalámbrica selectiva** — elegir un dispositivo específico o desconectar todos
- ✅ **ADB Troubleshoot** — matar/reiniciar el servidor ADB para arreglar conexiones bloqueadas (Opción 21)
- ✅ **Volcado de contactos mejorado** — análisis limpio del formato `Name: Number`
- ✅ **Lista de APK más limpia** — muestra solo nombres de paquetes, sin desorden de rutas sin procesar
- ✅ **Almacenamiento legible por humanos** — `df -h` para fácil lectura
- ✅ **Registro automático de conexión** — registro de sesión escrito al inicio y al salir

### v1.2 — `pegasusV-1.2.py`
- ✅ Ampliado a menú principal completo de 20 opciones
- ✅ Apagar y Reiniciar el dispositivo de forma remota
- ✅ Instalación (sideload) y Desinstalación de APK
- ✅ Push y Pull de Archivos (transferencia bidireccional)
- ✅ Enviar SMS mediante intent de Android
- ✅ Volcar contactos del dispositivo
- ✅ Volcado de registros del dispositivo con Logcat
- ✅ Alternar el estado de Wi-Fi en el dispositivo
- ✅ Verificación de información de almacenamiento
- ✅ Activación remota de cámara y extracción de fotos
- ✅ Módulo `re` añadido para el análisis de contactos

### v1.1 — `pegasus_v1.1.py`
- ✅ Verificar información del dispositivo (modelo, versión de Android, batería)
- ✅ Conexión y desconexión ADB por USB y Wi-Fi
- ✅ Grabación de pantalla con duración personalizada
- ✅ Espejo de pantalla en vivo mediante scrcpy
- ✅ Listar paquetes instalados y guardar en archivo
- ✅ Tomar y extraer captura de pantalla

### v1.0
- ✅ Versión inicial — wrapper básico de ADB
- ✅ Interfaz de menú de terminal interactiva
- ✅ Verificador de dependencias al inicio
- ✅ Salida de terminal con código de colores

---

## 📜 Licencia

Este proyecto está licenciado bajo la **Licencia MIT**.```
MIT License

Copyright (c) 2024 thakur2309

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.