PAGASUS-PRO

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

**Passo 4 — Instalar o scrcpy** *(opcional — para Espelhamento de Tela)*```bash
sudo apt install scrcpy -y

**Passo 6 — Clonar o repositório**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> Quer executar uma versão mais antiga?
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 🔷 Linux — Arch / Manjaro / BlackArch

**Passo 1 — Atualizar o sistema**```bash
sudo pacman -Syu

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

**Passo 5 — Clonar o repositório**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> Quer executar uma versão mais antiga?
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 🪟 Windows 10 / 11

**Passo 1 — Instalar o Python 3**

1. Baixe em: https://www.python.org/downloads/
2. Execute o instalador
3. ✅ **Marque "Add Python to PATH"** antes de clicar em Install

Verifique no Prompt de Comando ou no PowerShell:```cmd
python --version

> O ADB é adicionado automaticamente ao PATH — nenhuma configuração manual é necessária.

Verifique:```cmd
adb version

Verificar:```powershell
scrcpy --version

Verificar:```powershell
git --version

> ✅ Isso instala Python, ADB, scrcpy e Git de uma só vez. Reinicie o PowerShell depois disso.

---

**Passo 6 — Clone o repositório**

Abra o **Prompt de Comando** ou o **PowerShell**:```powershell
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

**Passo 8 — Executar o Pegasus v1.3**```powershell
python pegasus_v_1.3.py

**Passo 2 — Instalar o Python 3**```bash
brew install python

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

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

**Passo 6 — Clonar o repositório**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> Quer executar uma versão mais antiga?
> ```bash
> python3 pegasusV-1.2.py   # Executar v1.2
> python3 pegasus_v1.1.py   # Executar v1.1
> ```

---

### 📱 Termux (Execute Diretamente do Seu Telefone Android)

> **O que é o Termux?** O Termux é um emulador de terminal Android que fornece um ambiente Linux completo no seu telefone — sem necessidade de root. Você pode executar o Pegasus diretamente do seu dispositivo Android usando o Termux.

> ⚠️ **Nota:** O `scrcpy` (Espelhamento de Tela — Opção 5) **não funciona** no Termux porque requer um servidor de exibição que não está disponível no Android. Todos os outros recursos funcionam normalmente.

#### Instalar o Termux

1. **Instale o Termux pelo F-Droid** *(Recomendado)*  
   👉 https://f-droid.org/packages/com.termux/  
   > ⚠️ A versão do Termux na Google Play Store está desatualizada — use sempre a versão do F-Droid.

2. Abra o Termux e siga os passos abaixo:

**Passo 1 — Atualizar os pacotes**```bash
pkg update && pkg upgrade -y

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

Verifique a instalação:```bash
adb version

**Passo 6 — Clonar o repositório**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

**Passo 8 — Executar o Pegasus v1.3**```bash
python pegasus_v_1.3.py

4. Desconecte o cabo USB e, em seguida, encontre o IP do dispositivo de destino:  
   → Configurações → Wi-Fi → Toque na rede conectada → Endereço IP
5. Execute o Pegasus e selecione **`[2] Connect a Device`**
6. Insira o endereço IP — a conexão sem fio agora está ativa ✅

**Método 2 — Gerenciar o mesmo dispositivo (localhost)**

Se você quiser gerenciar seu próprio telefone diretamente:```bash
adb connect localhost:5555

### Mudar para Modo Sem Fio (Wi-Fi ADB)

> Configuração USB única necessária. Depois disso, use totalmente sem fio.

1. Conecte o dispositivo via cabo USB
2. Inicie o Pegasus → Selecione **`[2] Connect a Device`**
3. Digite `y` quando solicitado para ativar o modo TCP/IP
4. Encontre o IP do seu dispositivo: **Settings → Wi-Fi → Toque na rede conectada → IP Address**
5. Digite o IP no Pegasus quando solicitado
6. Desconecte o USB — a conexão agora é sem fio ✅

---

## 🚀 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

---

## 📂 Arquivos de Saída

Todos os arquivos gerados são salvos no **mesmo diretório** onde você executa o script.

| Nome do Arquivo | Gerado 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 |

---

## 📋 Resumo de Dependências

| Dependência | Obrigatória | Finalidade | Instalação (Linux/macOS) | Instalação (Termux) |
|-----------|----------|---------|-----------------------|-----------------|
| Python 3.7+ | ✅ Sim | Executar a ferramenta | `sudo apt install python3` | `pkg install python` |
| colorama | ✅ Sim | Saída colorida no terminal | `pip3 install colorama` | `pip install colorama` |
| ADB | ✅ Sim | Comunicação com o dispositivo | `sudo apt install adb` | `pkg install android-tools` |
| scrcpy | ⚪ Opcional | Recurso de Espelhamento de Tela | `sudo apt install scrcpy` | ❌ Termux mein kaam nahi |
| nmap | ⚪ Opcional | Varredura de rede em Security Tools | `sudo apt install nmap` | `pkg install nmap` |
| Git | ⚪ Recomendado | Clonar o repositório | `sudo apt install git` | `pkg install git` |

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

---

## 📁 Referência de Arquivos

| Arquivo | Versão | Comando de Execução |
|------|---------|-------------|
| `pegasus_v_1.3.py` | v1.3 *(Mais Recente)* | `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 Alterações

### v1.3 — Versão Mais Recente
- ✅ **Submenu Advanced Security Tools** adicionado (Opção 22) — 10 recursos:
  - 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
- ✅ **Histórico de Conexão de Dispositivos** com timestamps e duração da sessão (Opção 23)
- ✅ **Suporte a múltiplos dispositivos** — listar e selecionar quando vários dispositivos são detectados
- ✅ **Desconexão sem fio seletiva** — escolher dispositivo específico ou desconectar todos
- ✅ **ADB Troubleshoot** — matar/reiniciar o servidor ADB para corrigir conexões travadas (Opção 21)
- ✅ **Dump de contatos aprimorado** — análise limpa do formato `Name: Number`
- ✅ **Lista de APKs mais limpa** — mostra apenas nomes de pacotes, sem poluição de caminhos brutos
- ✅ **Armazenamento legível** — `df -h` para leitura fácil
- ✅ **Registro automático de conexão** — log de sessão gravado na inicialização e na saída

### v1.2 — `pegasusV-1.2.py`
- ✅ Expandido para menu principal completo de 20 opções
- ✅ Desligar e Reiniciar dispositivo remotamente
- ✅ Instalação (sideload) e Desinstalação de APK
- ✅ Push e Pull de Arquivos (transferência bidirecional)
- ✅ Enviar SMS via intent do Android
- ✅ Dump de contatos do dispositivo
- ✅ Dump de log do dispositivo via Logcat
- ✅ Alternar estado do Wi-Fi no dispositivo
- ✅ Verificação de informações de armazenamento
- ✅ Acionamento remoto da câmera e pull de foto
- ✅ Módulo `re` adicionado para análise de contatos

### v1.1 — `pegasus_v1.1.py`
- ✅ Verificar informações do dispositivo (modelo, versão do Android, bateria)
- ✅ Conexão e desconexão ADB via USB e Wi-Fi
- ✅ Gravação de tela com duração personalizada
- ✅ Espelhamento de tela ao vivo via scrcpy
- ✅ Listar pacotes instalados e salvar em arquivo
- ✅ Tirar e puxar screenshot

### v1.0
- ✅ Versão inicial — wrapper ADB básico
- ✅ Interface de menu interativo no terminal
- ✅ Verificador de dependências na inicialização
- ✅ Saída de terminal com cores

---

## 📜 Licença

Este projeto está licenciado sob a **MIT License**.```
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.