PAGASUS-PRO

**Schritt 2 — Python 3 installieren**```bash
sudo apt install python3 python3-pip -y

**Schritt 4 — scrcpy installieren** *(optional — für Screen Mirror)*```bash
sudo apt install scrcpy -y

**Schritt 6 — Repository klonen**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> Ältere Version ausführen?
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 🔷 Linux — Arch / Manjaro / BlackArch

**Schritt 1 — System aktualisieren**```bash
sudo pacman -Syu

**Schritt 3 — scrcpy installieren** *(optional)*```bash
sudo pacman -S scrcpy

**Schritt 5 — Repository klonen**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> Ältere Version ausführen?
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 🪟 Windows 10 / 11

**Schritt 1 — Python 3 installieren**

1. Herunterladen von: https://www.python.org/downloads/
2. Installer ausführen
3. ✅ **"Add Python to PATH" aktivieren**, bevor auf Installieren geklickt wird

In der Eingabeaufforderung oder PowerShell überprüfen:```cmd
python --version

> ADB wird automatisch zum PATH hinzugefügt — keine manuelle Einrichtung erforderlich.

Überprüfen:```cmd
adb version

Verifizieren:```powershell
scrcpy --version

Überprüfen:```powershell
git --version

> ✅ Dies installiert Python, ADB, scrcpy und Git in einem Durchgang. Starten Sie PowerShell danach neu.

---

**Schritt 6 — Repository klonen**

Öffnen Sie die **Eingabeaufforderung** oder **PowerShell**:```powershell
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

**Schritt 8 — Pegasus v1.3 ausführen**```powershell
python pegasus_v_1.3.py

**Schritt 2 — Python 3 installieren**```bash
brew install python

**Schritt 3 — ADB installieren**```bash
brew install android-platform-tools

**Schritt 4 — scrcpy installieren** *(optional)*```bash
brew install scrcpy

**Schritt 6 — Repository klonen**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> Möchten Sie eine ältere Version ausführen?
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 📱 Termux (Direkt von Ihrem Android-Telefon ausführen)

> **Was ist Termux?** Termux ist ein Android-Terminalemulator, der eine vollständige Linux-Umgebung auf Ihrem Telefon bereitstellt – ohne Root erforderlich. Sie können Pegasus direkt von Ihrem Android-Gerät aus mit Termux ausführen.

> ⚠️ **Hinweis:** `scrcpy` (Screen Mirror – Option 5) funktioniert **nicht** in Termux, da es einen Display-Server erfordert, der auf Android nicht verfügbar ist. Alle anderen Funktionen funktionieren normal.

#### Termux installieren

1. **Termux von F-Droid installieren** *(Empfohlen)*  
   👉 https://f-droid.org/packages/com.termux/  
   > ⚠️ Die Version von Termux im Google Play Store ist veraltet – verwenden Sie immer die F-Droid-Version.

2. Öffnen Sie Termux und folgen Sie den untenstehenden Schritten:

**Schritt 1 — Pakete aktualisieren**```bash
pkg update && pkg upgrade -y

**Schritt 3 — Git installieren**```bash
pkg install git -y

Installation überprüfen:```bash
adb version

**Schritt 6 — Repository klonen**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

**Schritt 8 — Pegasus v1.3 ausführen**```bash
python pegasus_v_1.3.py

4. Ziehen Sie das USB-Kabel ab und ermitteln Sie dann die IP-Adresse des Zielgeräts:  
   → Einstellungen → WLAN → Auf das verbundene Netzwerk tippen → IP-Adresse
5. Führen Sie Pegasus aus und wählen Sie **`[2] Connect a Device`**
6. Geben Sie die IP-Adresse ein — die drahtlose Verbindung ist jetzt aktiv ✅

**Methode 2 — Dasselbe Gerät verwalten (localhost)**

Wenn Sie Ihr eigenes Telefon direkt verwalten möchten:```bash
adb connect localhost:5555

### Zum Wireless-Modus wechseln (Wi-Fi ADB)

> Einmalige USB-Einrichtung erforderlich. Danach vollständig kabellos arbeiten.

1. Gerät über USB-Kabel verbinden
2. Pegasus starten → **`[2] Connect a Device`** auswählen
3. `y` eingeben, wenn gefragt wird, den TCP/IP-Modus zu aktivieren
4. Geräte-IP ermitteln: **Einstellungen → WLAN → Verbundenes Netzwerk antippen → IP-Adresse**
5. Die IP in Pegasus eingeben, wenn dazu aufgefordert
6. USB abstecken — die Verbindung ist jetzt kabellos ✅

---

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

---

## 📂 Ausgabedateien

Alle generierten Dateien werden im **selben Verzeichnis** gespeichert, in dem du das Skript ausführst.

| Dateiname | Generiert von |
|----------|-------------|
| `screen.png` | Screenshot aufnehmen |
| `record.mp4` | Bildschirmaufnahme |
| `apk_list.txt` | APK-Liste anzeigen |
| `contacts.txt` | Kontakte exportieren |
| `device_log.txt` | Geräteprotokolle abrufen |
| `storage_info.txt` | Speicher prüfen |
| `sms_logs.txt` | SMS exportieren (Sicherheitstools) |
| `call_logs.txt` | Anrufprotokolle exportieren (Sicherheitstools) |
| `connection_log.txt` | Automatisch generiertes Verbindungssitzungsprotokoll |

---

## 📋 Abhängigkeitsübersicht

| Abhängigkeit | Erforderlich | Zweck | Installation (Linux/macOS) | Installation (Termux) |
|-----------|----------|---------|-----------------------|-----------------|
| Python 3.7+ | ✅ Ja | Tool ausführen | `sudo apt install python3` | `pkg install python` |
| colorama | ✅ Ja | Farbige Terminalausgabe | `pip3 install colorama` | `pip install colorama` |
| ADB | ✅ Ja | Gerätekommunikation | `sudo apt install adb` | `pkg install android-tools` |
| scrcpy | ⚪ Optional | Bildschirmspiegelungsfunktion | `sudo apt install scrcpy` | ❌ Termux mein kaam nahi |
| nmap | ⚪ Optional | Netzwerkscan in Sicherheitstools | `sudo apt install nmap` | `pkg install nmap` |
| Git | ⚪ Empfohlen | Repository klonen | `sudo apt install git` | `pkg install git` |

> 💡 **Abkürzung:** `pip install -r requirements.txt` installiert alle Python-Abhängigkeiten auf einmal.

---

## 📁 Dateireferenz

| Datei | Version | Ausführungsbefehl |
|------|---------|-------------|
| `pegasus_v_1.3.py` | v1.3 *(Neueste)* | `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` |

---

## 📝 Änderungsprotokoll

### v1.3 — Neueste Version
- ✅ **Erweitertes Sicherheitstools-Untermenü** hinzugefügt (Option 22) — 10 Funktionen:
  - Root-Erkennung (Multi-Methode), APK-Berechtigungsprüfung, Vollständige Sicherheitsprüfung
  - Scanner für debuggable Apps, Interaktive Shell, Netzwerksicherheitsprüfung
  - SMS-/Anrufprotokoll-Export, Sicherheitsprotokollfilter, Schwachstellenscanner, Netzwerkmonitor
- ✅ **Geräteverbindungsverlauf** mit Zeitstempeln und Sitzungsdauer (Option 23)
- ✅ **Multi-Geräte-Unterstützung** — auflisten und auswählen, wenn mehrere Geräte erkannt werden
- ✅ **Selektive drahtlose Trennung** — bestimmtes Gerät auswählen oder alle trennen
- ✅ **ADB-Fehlerbehebung** — ADB-Server beenden/neu starten, um hängende Verbindungen zu beheben (Option 21)
- ✅ **Verbesserter Kontakteexport** — sauberes `Name: Number`-Format-Parsing
- ✅ **Sauberere APK-Liste** — zeigt nur Paketnamen, kein unübersichtlicher Rohpfad
- ✅ **Menschenlesbarer Speicher** — `df -h` für einfaches Lesen
- ✅ **Automatische Verbindungsprotokollierung** — Sitzungsprotokoll wird beim Start und Beenden geschrieben

### v1.2 — `pegasusV-1.2.py`
- ✅ Erweitert auf vollständiges Hauptmenü mit 20 Optionen
- ✅ Gerät remote ausschalten und neu starten
- ✅ APK installieren (Sideload) und deinstallieren
- ✅ Dateien übertragen (Push und Pull, bidirektionaler Transfer)
- ✅ SMS über Android-Intent senden
- ✅ Gerätekontakte exportieren
- ✅ Logcat-Geräteprotokoll-Export
- ✅ Wi-Fi-Status auf dem Gerät umschalten
- ✅ Speicherinfo-Prüfung
- ✅ Remote-Kameraauslösung und Foto-Abruf
- ✅ `re`-Modul für Kontakt-Parsing hinzugefügt

### v1.1 — `pegasus_v1.1.py`
- ✅ Geräteinfo prüfen (Modell, Android-Version, Akku)
- ✅ USB- und Wi-Fi-ADB-Verbindung herstellen und trennen
- ✅ Bildschirmaufnahme mit benutzerdefinierter Dauer
- ✅ Live-Bildschirmspiegelung über scrcpy
- ✅ Installierte Pakete auflisten und in Datei speichern
- ✅ Screenshot aufnehmen und abrufen

### v1.0
- ✅ Erstveröffentlichung — grundlegender ADB-Wrapper
- ✅ Interaktive Terminal-Menü-Oberfläche
- ✅ Abhängigkeitsprüfung beim Start
- ✅ Farbcodierte Terminalausgabe

---

## 📜 Lizenz

Dieses Projekt ist unter der **MIT-Lizenz** lizenziert.```
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.