PAGASUS-PRO

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

**Passo 4 — Installare scrcpy** *(opzionale — per Screen Mirror)*```bash
sudo apt install scrcpy -y

**Passo 6 — Clonare il repository**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> Vuoi eseguire una versione precedente?
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 🔷 Linux — Arch / Manjaro / BlackArch

**Passaggio 1 — Aggiorna il sistema**```bash
sudo pacman -Syu

**Passo 3 — Installare scrcpy** *(opzionale)*```bash
sudo pacman -S scrcpy

**Passo 5 — Clonare il repository**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> Vuoi eseguire una versione precedente?
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 🪟 Windows 10 / 11

**Passaggio 1 — Installare Python 3**

1. Scarica da: https://www.python.org/downloads/
2. Esegui il programma di installazione
3. ✅ **Seleziona "Add Python to PATH"** prima di fare clic su Install

Verifica in Command Prompt o PowerShell:```cmd
python --version

> ADB viene aggiunto automaticamente al PATH — nessuna configurazione manuale necessaria.

Verifica:```cmd
adb version

Verifica:```powershell
scrcpy --version

Verifica:```powershell
git --version

> ✅ Questo installa Python, ADB, scrcpy e Git in un colpo solo. Riavvia PowerShell dopo questa operazione.

---

**Passaggio 6 — Clona il repository**

Apri **Prompt dei comandi** o **PowerShell**:```powershell
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

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

**Passo 2 — Installare Python 3**```bash
brew install python

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

**Passo 4 — Installare scrcpy** *(opzionale)*```bash
brew install scrcpy

**Passo 6 — Clonare il repository**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> Vuoi eseguire una versione precedente?
> ```bash
> python3 pegasusV-1.2.py   # Esegui v1.2
> python3 pegasus_v1.1.py   # Esegui v1.1
> ```

---

### 📱 Termux (Esegui direttamente dal tuo telefono Android)

> **Cos'è Termux?** Termux è un emulatore di terminale Android che fornisce un ambiente Linux completo sul tuo telefono — senza bisogno di root. Puoi eseguire Pegasus direttamente dal tuo dispositivo Android usando Termux.

> ⚠️ **Nota:** `scrcpy` (Screen Mirror — Opzione 5) **non funziona** in Termux perché richiede un display server che non è disponibile su Android. Tutte le altre funzionalità funzionano normalmente.

#### Installa Termux

1. **Installa Termux da F-Droid** *(Consigliato)*  
   👉 https://f-droid.org/packages/com.termux/  
   > ⚠️ La versione di Termux sul Google Play Store è obsoleta — usa sempre la versione F-Droid.

2. Apri Termux e segui i passaggi seguenti:

**Passo 1 — Aggiorna i pacchetti**```bash
pkg update && pkg upgrade -y

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

Verifica l'installazione:```bash
adb version

**Passo 6 — Clonare il repository**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

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

4. Scollega il cavo USB, poi trova l'IP del dispositivo di destinazione:  
   → Impostazioni → Wi-Fi → Tocca la rete connessa → Indirizzo IP
5. Esegui Pegasus e seleziona **`[2] Connect a Device`**
6. Inserisci l'indirizzo IP — la connessione wireless è ora attiva ✅

**Metodo 2 — Gestire lo stesso dispositivo (localhost)**

Se vuoi gestire direttamente il tuo telefono:```bash
adb connect localhost:5555

### Passa alla Modalità Wireless (Wi-Fi ADB)

> È richiesta una configurazione USB una tantum. Successivamente, passa completamente alla modalità wireless.

1. Collega il dispositivo tramite cavo USB
2. Avvia Pegasus → Seleziona **`[2] Connect a Device`**
3. Inserisci `y` quando viene richiesto di abilitare la modalità TCP/IP
4. Trova l'IP del tuo dispositivo: **Impostazioni → Wi-Fi → Tocca la rete connessa → Indirizzo IP**
5. Inserisci l'IP in Pegasus quando richiesto
6. Scollega il cavo USB — la connessione è ora wireless ✅

---

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

---

## 📂 File di Output

Tutti i file generati vengono salvati nella **stessa directory** in cui esegui lo script.

| Nome file | Generato da |
|----------|-------------|
| `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` | Log di sessione di connessione generato automaticamente |

---

## 📋 Riepilogo delle Dipendenze

| Dipendenza | Richiesta | Scopo | Installazione (Linux/macOS) | Installazione (Termux) |
|-----------|----------|---------|-----------------------|-----------------|
| Python 3.7+ | ✅ Sì | Esegue lo strumento | `sudo apt install python3` | `pkg install python` |
| colorama | ✅ Sì | Output colorato nel terminale | `pip3 install colorama` | `pip install colorama` |
| ADB | ✅ Sì | Comunicazione con il dispositivo | `sudo apt install adb` | `pkg install android-tools` |
| scrcpy | ⚪ Opzionale | Funzionalità Screen Mirror | `sudo apt install scrcpy` | ❌ Termux mein kaam nahi |
| nmap | ⚪ Opzionale | Scansione di rete in Security Tools | `sudo apt install nmap` | `pkg install nmap` |
| Git | ⚪ Consigliato | Clona il repository | `sudo apt install git` | `pkg install git` |

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

---

## 📁 Riferimento File

| File | Versione | Comando di esecuzione |
|------|---------|-------------|
| `pegasus_v_1.3.py` | v1.3 *(Più 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` |

---

## 📝 Changelog

### v1.3 — Ultima Release
- ✅ **Sottomenu Advanced Security Tools** aggiunto (Opzione 22) — 10 funzionalità:
  - Root Detection (multi-metodo), 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
- ✅ **Cronologia Connessioni Dispositivo** con timestamp e durata della sessione (Opzione 23)
- ✅ **Supporto multi-dispositivo** — elenca e seleziona quando vengono rilevati più dispositivi
- ✅ **Disconnessione wireless selettiva** — scegli un dispositivo specifico o disconnetti tutti
- ✅ **ADB Troubleshoot** — termina/riavvia il server ADB per risolvere connessioni bloccate (Opzione 21)
- ✅ **Dump contatti migliorato** — parsing pulito del formato `Name: Number`
- ✅ **Lista APK più pulita** — mostra solo i nomi dei pacchetti, senza clutter di percorsi grezzi
- ✅ **Storage leggibile** — `df -h` per una facile lettura
- ✅ **Logging automatico delle connessioni** — log di sessione scritto all'avvio e all'uscita

### v1.2 — `pegasusV-1.2.py`
- ✅ Espanso a un menu principale completo di 20 opzioni
- ✅ Spegnimento e riavvio remoto del dispositivo
- ✅ Installazione (sideload) e disinstallazione APK
- ✅ Push e Pull di file (trasferimento bidirezionale)
- ✅ Invio SMS tramite intent Android
- ✅ Dump dei contatti del dispositivo
- ✅ Dump dei log del dispositivo tramite Logcat
- ✅ Attivazione/disattivazione dello stato Wi-Fi sul dispositivo
- ✅ Controllo informazioni di archiviazione
- ✅ Attivazione remota della fotocamera e pull della foto
- ✅ Modulo `re` aggiunto per il parsing dei contatti

### v1.1 — `pegasus_v1.1.py`
- ✅ Controllo informazioni dispositivo (modello, versione Android, batteria)
- ✅ Connessione e disconnessione ADB via USB e Wi-Fi
- ✅ Registrazione schermo con durata personalizzata
- ✅ Screen mirroring live tramite scrcpy
- ✅ Elenca i pacchetti installati e salva su file
- ✅ Cattura e pull dello screenshot

### v1.0
- ✅ Release iniziale — wrapper ADB di base
- ✅ UI menu terminale interattiva
- ✅ Controllo dipendenze all'avvio
- ✅ Output terminale con colori

---

## 📜 Licenza

Questo progetto è distribuito sotto la **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.