manuleye 1.2.2
MANUL-EYE - Comprehensive OSINT Framework for Intelligence Gathering
License: MIT
Requires Python: >=3.8
Keywords: osint, intelligence, security, metadata, reconnaissance

# MANUL-EYE 🦅

**Comprehensive OSINT Framework for Intelligence Gathering**

**[English](#english)** | **[Русский](#russian)**

---

<a name="english"></a>
## 🇬🇧 English Version

MANUL-EYE is a powerful Open Source Intelligence (OSINT) framework designed for security researchers, penetration testers, and investigators. It provides a wide range of tools for gathering intelligence from various sources, extracting metadata, and performing network reconnaissance.

### ✨ Features

#### 🔍 Lookup & Intelligence
- **Username Hunt** - Search for usernames across 500+ social media platforms (via Maigret)
- **Email Lookup** - Check email presence on various services (via Holehe)
- **Phone Intelligence** - Extract carrier, location, timezone info from phone numbers
- **IP Geolocation** - Get detailed information about IP addresses
- **Domain Resolution** - Resolve domains to IPs and gather information

#### 🎯 Metadata Extraction
- **EXIF Extractor** - Extract GPS coordinates and metadata from images
- **PDF Metadata** - Extract author, creation date, and other PDF metadata
- **Video/Audio Metadata** - Analyze media file metadata
- **Office Documents** - Extract metadata from DOCX and XLSX files
- **Archive Info** - List contents of ZIP and TAR archives
- **Metadata Cleaner** - Remove EXIF data from images

#### 🌐 Network Tools
- **Port Scanner** - Scan for open ports on target systems
- **Traceroute** - Trace network path to destination
- **Ping Sweep** - Discover alive hosts on a network
- **SSL Certificate Info** - Analyze SSL/TLS certificates
- **HTTP Headers Analyzer** - Check security headers and server information

#### 🔗 Social Media OSINT
- **Telegram Search** - Find Telegram users and channels
- **TikTok Search** - Lookup TikTok profiles
- **VK Search** - Search VKontakte profiles
- **Instagram Search** - Gather public Instagram information

#### 🛡️ Security Tools
- **SQLMap Integration** - SQL injection testing
- **XSStrike Integration** - XSS vulnerability scanning

#### 📝 Utilities
- **Create Paste** - Generate detailed OSINT reports
- **Password Generator** - Create strong, customizable passwords
- **Hash Analyzer** - Calculate file hashes (MD5, SHA1, SHA256)

### 📦 Installation

#### From PyPI (Recommended)

```bash
pip install manuleye
```

#### From Source

```bash
git clone https://github.com/b3stp4st3r/manuleye.git
cd manuleye
pip install -e .
```

### 🚀 Usage

Simply run the command in your terminal:

```bash
manuleye
```

The interactive menu will guide you through all available options.

### 📋 Requirements

- Python 3.8 or higher
- Internet connection (for online lookups)
- Operating System: Windows, Linux, macOS

### ⚠️ Legal Disclaimer

This tool is intended for **legal and ethical use only**. Users are responsible for complying with all applicable laws and regulations.

**Permitted use cases:**
- Security research and penetration testing (with permission)
- Digital forensics and investigations
- OSINT gathering for legitimate purposes
- Educational purposes

**DO NOT use for:**
- Unauthorized access to systems or data
- Harassment or stalking
- Violating others' privacy
- Any illegal activities

### 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

### 🔗 Links

- **GitHub:** https://github.com/b3stp4st3r/manuleye
- **Issues:** https://github.com/b3stp4st3r/manuleye/issues
- **PyPI:** https://pypi.org/project/manuleye/

### 👤 Author

**Daniil Pentium**
- GitHub: [@b3stp4st3r](https://github.com/b3stp4st3r)

---

<a name="russian"></a>
## 🇷🇺 Русская версия

MANUL-EYE — это мощный фреймворк для Open Source Intelligence (OSINT), разработанный для исследователей безопасности, пентестеров и специалистов по расследованиям. Предоставляет широкий спектр инструментов для сбора информации из различных источников, извлечения метаданных и сетевой разведки.

### ✨ Возможности

#### 🔍 Поиск и разведка
- **Username Hunt** - Поиск username на 500+ платформах социальных сетей (через Maigret)
- **Email Lookup** - Проверка наличия email на различных сервисах (через Holehe)
- **Phone Intelligence** - Извлечение информации об операторе, местоположении, часовом поясе
- **IP Geolocation** - Получение детальной информации об IP адресах
- **Domain Resolution** - Разрешение доменов в IP и сбор информации

#### 🎯 Извлечение метаданных
- **EXIF Extractor** - Извлечение GPS координат и метаданных из изображений
- **PDF Metadata** - Извлечение автора, даты создания и других метаданных PDF
- **Video/Audio Metadata** - Анализ метаданных медиафайлов
- **Office Documents** - Извлечение метаданных из DOCX и XLSX файлов
- **Archive Info** - Просмотр содержимого ZIP и TAR архивов
- **Metadata Cleaner** - Удаление EXIF данных из изображений

#### 🌐 Сетевые инструменты
- **Port Scanner** - Сканирование открытых портов на целевых системах
- **Traceroute** - Трассировка сетевого пути до назначения
- **Ping Sweep** - Обнаружение активных хостов в сети
- **SSL Certificate Info** - Анализ SSL/TLS сертификатов
- **HTTP Headers Analyzer** - Проверка заголовков безопасности и информации о сервере

#### 🔗 OSINT социальных сетей
- **Telegram Search** - Поиск пользователей и каналов Telegram
- **TikTok Search** - Поиск профилей TikTok
- **VK Search** - Поиск профилей ВКонтакте
- **Instagram Search** - Сбор публичной информации из Instagram

#### 🛡️ Инструменты безопасности
- **SQLMap Integration** - Тестирование SQL инъекций
- **XSStrike Integration** - Сканирование XSS уязвимостей

#### 📝 Утилиты
- **Create Paste** - Генерация детальных OSINT отчётов
- **Password Generator** - Создание надёжных настраиваемых паролей
- **Hash Analyzer** - Вычисление хешей файлов (MD5, SHA1, SHA256)

### 📦 Установка

#### Из PyPI (Рекомендуется)

```bash
pip install manuleye
```

#### Из исходников

```bash
git clone https://github.com/b3stp4st3r/manuleye.git
cd manuleye
pip install -e .
```

### 🚀 Использование

Просто запустите команду в терминале:

```bash
manuleye
```

Интерактивное меню проведёт вас через все доступные опции.

### 📋 Требования

- Python 3.8 или выше
- Интернет-соединение (для онлайн поиска)
- Операционная система: Windows, Linux, macOS

### ⚠️ Правовая оговорка

Этот инструмент предназначен **только для легального и этичного использования**. Пользователи несут ответственность за соблюдение всех применимых законов и правил.

**Разрешённые варианты использования:**
- Исследования безопасности и пентестинг (с разрешением)
- Цифровая криминалистика и расследования
- Сбор OSINT для легитимных целей
- Образовательные цели

**НЕ используйте для:**
- Несанкционированного доступа к системам или данным
- Преследования или сталкинга
- Нарушения приватности других людей
- Любой незаконной деятельности

### 📄 Лицензия

Этот проект лицензирован под лицензией MIT - см. файл [LICENSE](LICENSE) для деталей.

### 🔗 Ссылки

- **GitHub:** https://github.com/b3stp4st3r/manuleye
- **Issues:** https://github.com/b3stp4st3r/manuleye/issues
- **PyPI:** https://pypi.org/project/manuleye/

### 👤 Автор

**Daniil Pentium**
- GitHub: [@b3stp4st3r](https://github.com/b3stp4st3r)

---

**Stay sharp. Stay hidden.** 🦅

[![GitHub stars](https://img.shields.io/github/stars/b3stp4st3r/manuleye?style=social)](https://github.com/b3stp4st3r/manuleye)
[![PyPI version](https://badge.fury.io/py/manuleye.svg)](https://pypi.org/project/manuleye/)
[![Python versions](https://img.shields.io/pypi/pyversions/manuleye.svg)](https://pypi.org/project/manuleye/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)