Metadata-Version: 2.4
Name: shadoweye
Version: 3.1.3
Summary: Multi-Tool OSINT Framework for Termux and Windows
Home-page: https://github.com/lixynhay/ShadowEye
Author: lixynhay
Author-email: lixynhay@gmail.com
Keywords: osint security termux email username phone domain exif
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=13.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: requests>=2.31.0
Requires-Dist: holehe>=1.0.0
Requires-Dist: maigret>=0.4.0
Requires-Dist: phonenumbers>=8.13.0
Requires-Dist: python-whois>=0.9.0
Requires-Dist: dnspython>=2.6.0
Requires-Dist: exifread>=3.0.0
Requires-Dist: PySocks>=1.7.0
Requires-Dist: colorama>=0.4.6
Requires-Dist: certifi>=2024.0.0
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: lxml>=5.0.0
Requires-Dist: requests-futures>=1.0.0
Requires-Dist: stem>=1.8.0
Requires-Dist: pandas>=2.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

<div align="center">

# 👁️ ShadowEye

### 🎯 Multi-Tool OSINT Framework for Linux & Windows

**Мощный консольный инструмент для разведки: Email, Username, Phone, Domain, EXIF.**  
Кроссплатформенность, кэширование, прокси-ротация и красивые отчеты.

[![PyPI version](https://badge.fury.io/py/shadoweye.svg)](https://pypi.org/project/shadoweye/)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-orange.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20Termux-green.svg)](https://github.com/lixynhay/ShadowEye)

</div>

---

##  Возможности

| Модуль | Описание | Технологии |
| :--- | :--- | :--- |
| 📧 **Email OSINT** | Проверка регистрации в 120+ сервисах | Holehe |
| 👤 **Username OSINT** | Поиск аккаунтов по никнейму | Maigret + Sherlock (Built-in) |
| 📞 **Phone OSINT** | Анализ номера (страна, оператор, тип) | Google libphonenumber |
| 🌐 **Domain OSINT** | WHOIS, DNS записи, IP Geolocation | python-whois, dnspython |
| 🖼️ **EXIF Analyzer** | Метаданные фото + GPS на карте | ExifRead |
| 🎯 **All-in-One** | Комплексный анализ всех типов данных | — |
| 📦 **Batch Mode** | Пакетная обработка целей из файла | — |
| 🔧 **Proxy Manager** | Ротация прокси для обхода блокировок | HTTP/SOCKS5 support |

### ✨ Ключевые преимущества
- **🔄 Умное кэширование**: Результаты сохраняются на 24ч, чтобы не тратить время на повторные проверки.
- **🌍 Прокси-ротация**: Автоматическая смена IP для обхода Rate Limit.
- **📊 Интерактивные отчеты**: Экспорт в JSON и красивый HTML с поиском и картами.
- ** Кроссплатформенность**: Стабильная работа на Windows 10/11, Linux и Android (Termux).
- **⚡ Валидация данных**: Встроенная проверка формата email, телефонов и доменов перед запросом.

---

## 🚀 Установка

### Вариант 1: Через PyPI (Рекомендуется)
Самый быстрый способ установки. Открой терминал и выполни:

```bash
pip install shadoweye
```

### Вариант 2: Из исходников (GitHub)
Если хочешь получить самую свежую версию или внести изменения:

```bash
git clone https://github.com/lixynhay/ShadowEye.git
cd ShadowEye
pip install -r requirements.txt
pip install -e .
```

---

## 📖 Использование

После установки просто запусти команду в терминале:

```bash
shadoweye
```

Или используй модульный запуск:
```bash
python -m osint_toolkit
```


### Примеры работы

**📧 Email Check:**
> Введи `example@gmail.com` → Получи список сервисов, где этот email зарегистрирован.

** Username Search:**
> Введи `nickname` → Выбери Sherlock (быстро) или Maigret (глубоко) → Найди профили в соцсетях.

**🌐 Domain Analysis:**
> Введи `target.com` → Узнай регистратора, DNS-серверы и физическое расположение сервера.

---

##  Структура проекта

Проект имеет четкую модульную архитектуру:

```text
ShadowEye/
├── osint_toolkit/          # Основной пакет
│   ├── cli.py              # Главный интерфейс и меню
│   ├── aggregator.py       # Сбор и экспорт результатов
│   ├── ui.py               # UI компоненты (Rich library)
│   ├── core/               # Ядро инструментов
│   │   ├── email_checker.py
│   │   ├── username_checker.py
│   │   ├── phone_checker.py
│   │   ├── domain_checker.py
│   │   └── exif_analyzer.py
│   ├── utils/              # Вспомогательные утилиты
│   │   ├── cache.py        # Система кэширования
│   │   ├── validators.py   # Валидация входных данных
│   │   ├── proxy_rotator.py# Управление прокси
│   │   ── html_report.py  # Генератор HTML-отчетов
│   └── sherlock_builtin/   # Встроенная версия Sherlock
├── setup.py                # Конфигурация пакета
├── requirements.txt        # Зависимости
└── README.md
```

---

## 🛠️ Требования

- **Python**: 3.10 или выше
- **ОС**: Windows, Linux, macOS, Android (Termux)

---

##  Экспорт результатов

ShadowEye позволяет сохранять данные для дальнейшего анализа:

- **JSON**: Машиночитаемый формат для интеграции с другими скриптами.
- **HTML**: Красивый веб-отчет с таблицами, статусами и встроенными картами Google Maps для GPS-координат.

---

## ⚠️ Дисклеймер

Этот инструмент создан **исключительно для образовательных целей** и легального OSINT-анализа. 
Автор не несет ответственности за неправомерное использование программного обеспечения. 
Не используйте ShadowEye для преследования, сталкинга или нарушения законов вашей юрисдикции.

---


---

<div align="center">

**Сделано с ❤️ для OSINT сообщества**  
*ShadowEye — видит то, что скрыто в тени* 👁️

[GitHub Repository](https://github.com/lixynhay/ShadowEye) | [PyPI Package](https://pypi.org/project/shadoweye/)

</div>
