PAGASUS-PRO

**2단계 — Python 3 설치**```bash
sudo apt install python3 python3-pip -y

**4단계 — scrcpy 설치** *(선택 사항 — 화면 미러링용)*```bash
sudo apt install scrcpy -y

**6단계 — 리포지토리 복제**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> 이전 버전을 실행하고 싶으신가요?
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 🔷 Linux — Arch / Manjaro / BlackArch

**1단계 — 시스템 업데이트**```bash
sudo pacman -Syu

**3단계 — scrcpy 설치** *(선택 사항)*```bash
sudo pacman -S scrcpy

**5단계 — 리포지토리 복제**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> 이전 버전을 실행하고 싶으신가요?
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 🪟 Windows 10 / 11

**1단계 — Python 3 설치**

1. 다음에서 다운로드: https://www.python.org/downloads/
2. 설치 프로그램 실행
3. ✅ Install을 클릭하기 전에 **"Add Python to PATH"를 체크**

Command Prompt 또는 PowerShell에서 확인:```cmd
python --version

> ADB는 PATH에 자동으로 추가됩니다 — 수동 설정이 필요하지 않습니다.

확인:```cmd
adb version

확인:```powershell
scrcpy --version

확인:```powershell
git --version

> ✅ 이 명령은 Python, ADB, scrcpy, Git을 한 번에 설치합니다. 설치 후 PowerShell을 다시 시작하세요.

---

**6단계 — 리포지토리 복제**

**명령 프롬프트** 또는 **PowerShell**을 엽니다:```powershell
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

**8단계 — Pegasus v1.3 실행**```powershell
python pegasus_v_1.3.py

**2단계 — Python 3 설치**```bash
brew install python

**3단계 — ADB 설치**```bash
brew install android-platform-tools

**4단계 — scrcpy 설치** *(선택 사항)*```bash
brew install scrcpy

**6단계 — 리포지토리 복제**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

> 이전 버전을 실행하고 싶으신가요?
> ```bash
> python3 pegasusV-1.2.py   # Run v1.2
> python3 pegasus_v1.1.py   # Run v1.1
> ```

---

### 📱 Termux (안드로이드 폰에서 직접 실행)

> **Termux란?** Termux는 루트 권한 없이도 폰에서 완전한 Linux 환경을 제공하는 안드로이드 터미널 에뮬레이터입니다. Termux를 사용하면 안드로이드 기기에서 Pegasus를 직접 실행할 수 있습니다.

> ⚠️ **참고:** `scrcpy` (화면 미러링 — 옵션 5)는 안드로이드에서 사용할 수 없는 디스플레이 서버가 필요하기 때문에 Termux에서 **작동하지 않습니다**. 다른 모든 기능은 정상적으로 작동합니다.

#### Termux 설치

1. **F-Droid에서 Termux 설치** *(권장)*  
   👉 https://f-droid.org/packages/com.termux/  
   > ⚠️ Google Play 스토어 버전의 Termux는 구버전입니다 — 항상 F-Droid 버전을 사용하세요.

2. Termux를 열고 아래 단계를 따르세요:

**Step 1 — 패키지 업데이트**```bash
pkg update && pkg upgrade -y

**3단계 — Git 설치**```bash
pkg install git -y

설치 확인:```bash
adb version

**6단계 — 리포지토리 복제**```bash
git clone https://github.com/thakur2309/PAGASUS-PRO.git
cd PAGASUS-PRO

**8단계 — Pegasus v1.3 실행**```bash
python pegasus_v_1.3.py

4. USB 케이블을 분리한 다음 대상 기기 IP를 확인합니다:  
   → 설정 → Wi-Fi → 연결된 네트워크 탭 → IP 주소
5. Pegasus를 실행하고 **`[2] Connect a Device`**를 선택합니다
6. IP 주소를 입력합니다 — 이제 무선 연결이 활성화되었습니다 ✅

**방법 2 — 동일한 기기 관리 (localhost)**

자신의 휴대폰을 직접 관리하려는 경우:```bash
adb connect localhost:5555

### 무선 모드로 전환 (Wi-Fi ADB)

> 최초 1회 USB 설정이 필요합니다. 이후에는 완전히 무선으로 사용하세요.

1. USB 케이블로 기기를 연결합니다
2. Pegasus를 실행 → **`[2] Connect a Device`** 선택
3. TCP/IP 모드를 활성화하라는 메시지가 나오면 `y`를 입력합니다
4. 기기 IP를 확인합니다: **설정 → Wi-Fi → 연결된 네트워크 탭 → IP 주소**
5. 메시지가 표시되면 Pegasus에 IP를 입력합니다
6. USB를 분리합니다 — 이제 연결이 무선입니다 ✅

---

## 🚀 사용법```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

---

## 📂 출력 파일

생성된 모든 파일은 스크립트를 실행한 **동일한 디렉터리**에 저장됩니다.

| 파일명 | 생성 기능 |
|----------|-------------|
| `screen.png` | 스크린샷 찍기 |
| `record.mp4` | 화면 녹화 |
| `apk_list.txt` | APK 목록 표시 |
| `contacts.txt` | 연락처 덤프 |
| `device_log.txt` | 기기 로그 가져오기 |
| `storage_info.txt` | 저장 공간 확인 |
| `sms_logs.txt` | SMS 덤프 (보안 도구) |
| `call_logs.txt` | 통화 기록 덤프 (보안 도구) |
| `connection_log.txt` | 자동 생성된 연결 세션 로그 |

---

## 📋 의존성 요약

| 의존성 | 필수 여부 | 용도 | 설치 (Linux/macOS) | 설치 (Termux) |
|-----------|----------|---------|-----------------------|-----------------|
| Python 3.7+ | ✅ 예 | 도구 실행 | `sudo apt install python3` | `pkg install python` |
| colorama | ✅ 예 | 컬러 터미널 출력 | `pip3 install colorama` | `pip install colorama` |
| ADB | ✅ 예 | 기기 통신 | `sudo apt install adb` | `pkg install android-tools` |
| scrcpy | ⚪ 선택 | 화면 미러링 기능 | `sudo apt install scrcpy` | ❌ Termux mein kaam nahi |
| nmap | ⚪ 선택 | 보안 도구의 네트워크 스캔 | `sudo apt install nmap` | `pkg install nmap` |
| Git | ⚪ 권장 | 저장소 복제 | `sudo apt install git` | `pkg install git` |

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

---

## 📁 파일 참조

| 파일 | 버전 | 실행 명령 |
|------|---------|-------------|
| `pegasus_v_1.3.py` | v1.3 *(최신)* | `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` |

---

## 📝 변경 내역

### v1.3 — 최신 릴리스
- ✅ **고급 보안 도구 하위 메뉴** 추가 (옵션 22) — 10가지 기능:
  - 루트 탐지 (다중 방식), APK 권한 감사, 전체 보안 감사
  - 디버깅 가능 앱 스캐너, 대화형 셸, 네트워크 보안 검사
  - SMS/통화 기록 덤프, 보안 로그 필터, 취약점 스캐너, 네트워크 모니터
- ✅ **기기 연결 기록** — 타임스탬프 및 세션 지속 시간 포함 (옵션 23)
- ✅ **다중 기기 지원** — 여러 기기가 감지되면 목록 표시 및 선택
- ✅ **선택적 무선 연결 해제** — 특정 기기 선택 또는 전체 연결 해제
- ✅ **ADB 문제 해결** — ADB 서버 종료/재시작으로 멈춘 연결 복구 (옵션 21)
- ✅ **개선된 연락처 덤프** — 깔끔한 `Name: Number` 형식 파싱
- ✅ **정리된 APK 목록** — 패키지 이름만 표시, 불필요한 경로 제거
- ✅ **사람이 읽기 쉬운 저장 공간** — `df -h`로 쉽게 확인
- ✅ **자동 연결 로깅** — 시작 및 종료 시 세션 로그 기록

### v1.2 — `pegasusV-1.2.py`
- ✅ 전체 20개 옵션 메인 메뉴로 확장
- ✅ 기기 원격 전원 끄기 및 재부팅
- ✅ APK 설치 (사이드로드) 및 제거
- ✅ 파일 푸시 및 풀 (양방향 전송)
- ✅ Android 인텐트를 통한 SMS 전송
- ✅ 기기 연락처 덤프
- ✅ Logcat 기기 로그 덤프
- ✅ 기기의 Wi-Fi 상태 전환
- ✅ 저장 공간 정보 확인
- ✅ 원격 카메라 작동 및 사진 가져오기
- ✅ 연락처 파싱을 위한 `re` 모듈 추가

### v1.1 — `pegasus_v1.1.py`
- ✅ 기기 정보 확인 (모델, Android 버전, 배터리)
- ✅ USB 및 Wi-Fi ADB 연결 및 해제
- ✅ 사용자 지정 시간 화면 녹화
- ✅ scrcpy를 통한 실시간 화면 미러링
- ✅ 설치된 패키지 목록 표시 및 파일로 저장
- ✅ 스크린샷 찍기 및 가져오기

### v1.0
- ✅ 최초 릴리스 — 기본 ADB 래퍼
- ✅ 대화형 터미널 메뉴 UI
- ✅ 시작 시 의존성 검사
- ✅ 색상으로 구분된 터미널 출력

---

## 📜 라이선스

이 프로젝트는 **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.