MANUL-EYE - Comprehensive OSINT Framework for Intelligence Gathering
Project description
MANUL-EYE 🦅
Comprehensive OSINT Framework for Intelligence Gathering
English | Русский
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 Metadata - Analyze video file metadata
- Audio Metadata - Extract ID3 tags and audio file information
- 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
🛡️ Security Tools
- SQLMap Integration - SQL injection testing
- XSStrike Integration - XSS vulnerability scanning
- Instagram OSINT - Gather public information from Instagram profiles
📝 Utilities
- Create Paste - Generate detailed OSINT reports
- Password Generator - Create strong, customizable passwords
📦 Installation
From PyPI (Recommended)
pip install manuleye
From Source
git clone https://github.com/b3stp4st3r/manuleye.git
cd manuleye
pip install -e .
🚀 Usage
Simply run the command in your terminal:
manuleye
The interactive menu will guide you through all available options.
Quick Examples
# Launch the framework
manuleye
# The tool will automatically check and install missing dependencies
# Then present you with an interactive menu with 22 options
Usage Examples
Search username across all social networks
manuleye → [1] Username Hunt → enter username
Extract GPS coordinates from photo
manuleye → [11] EXIF Extract → select image
Analyze IP address
manuleye → [4] IP Geolocate → enter IP
Port scanning
manuleye → [16] Port Scanner → enter IP/domain
Create OSINT report
manuleye → [21] Create Paste → fill in information
📋 Requirements
- Python 3.8 or higher
- Internet connection (for online lookups)
- Operating System: Windows, Linux, macOS
Dependencies
All dependencies are automatically installed:
- requests - HTTP requests
- rich - Beautiful terminal output
- pyfiglet - ASCII art banners
- Pillow - Image processing
- phonenumbers - Phone number analysis
- pypdf - PDF processing
- mutagen - Audio/video metadata
- python-docx - DOCX processing
- openpyxl - XLSX processing
- instaloader - Instagram OSINT
- maigret - Username search
- holehe - Email lookup
⚠️ Legal Disclaimer
This tool is intended for legal and ethical use only. Users are responsible for complying with all applicable laws and regulations. The developers assume no liability for misuse or damage caused by this program.
Permitted use cases:
- Security research and penetration testing (with permission)
- Digital forensics and investigations
- OSINT gathering for legitimate purposes
- Educational purposes
- Testing your own digital security
DO NOT use for:
- Unauthorized access to systems or data
- Harassment or stalking
- Violating others' privacy
- Any illegal activities
🎯 Main Functions
LOOKUP Category
- Username Hunt - Search across 500+ social networks
- Email Lookup - Check email on various services
- Phone Intel - Detailed phone number information
- IP Geolocate - IP geolocation and information
- Domain Resolve - Domain resolution and data collection
EXPLOIT Category
- SQLMap - Automated SQL injection testing
- XSStrike - XSS vulnerability scanning
- Instagram OSINT - Gather data from Instagram profiles
METADATA Category
- Archive Info - Analyze archive contents
- Meta Cleaner - Remove metadata from images
- EXIF Extract - Extract EXIF and GPS from photos
- PDF Metadata - PDF document metadata
- Video Metadata - Video file metadata
- Audio Metadata - Audio file metadata
- Office Metadata - Office document metadata
NETWORK Category
- Port Scanner - Port scanning
- Traceroute - Route tracing
- Ping Sweep - Find active hosts
- SSL Cert Info - SSL certificate information
- HTTP Headers - HTTP header analysis
UTILITIES Category
- Create Paste - Create structured OSINT report
- Password Gen - Strong password generator
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
How to contribute:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
📄 License
This project is licensed under the MIT License - see the 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
🙏 Acknowledgments
- Maigret - Excellent username search tool
- Holehe - Email lookup tool
- All other open-source libraries used in this project
📊 Statistics
- 30+ OSINT functions
- 500+ supported platforms for username search
- 11 main dependencies
- Support for 3 operating systems
- 1100+ lines of code
🔥 Popular Use Cases
1. Complete identity investigation
1. Username Hunt - find all accounts
2. Email Lookup - check email
3. Phone Intel - analyze number
4. Create Paste - generate report
2. Web resource analysis
1. Domain Resolve - get IP
2. Port Scanner - find open ports
3. SSL Cert Info - check certificate
4. HTTP Headers - analyze headers
3. File metadata analysis
1. EXIF Extract - GPS from photos
2. PDF Metadata - information from PDF
3. Office Metadata - data from documents
💡 Usage Tips
- Use VPN for anonymity when gathering information
- Always get permission before testing systems
- Save results for investigation documentation
- Combine tools for complete picture
- Verify information from multiple sources
🆘 Support
If you encounter problems:
- Check Issues
- Create a new Issue with problem description
- Specify Python version and OS
🔄 Updates
Stay updated:
pip install --upgrade manuleye
Check current version:
pip show manuleye
🌟 Features
- ✅ Easy installation via pip
- ✅ Interactive menu
- ✅ Colorful terminal output
- ✅ Automatic dependency installation
- ✅ Cross-platform (Windows/Linux/macOS)
- ✅ Open source (MIT License)
- ✅ Active development and support
- ✅ Regular updates
📱 Contact
For questions and suggestions:
- Create an Issue on GitHub
- Contact the author via GitHub
Stay sharp. Stay hidden. 🦅
Version: 1.0.1
Last updated: February 15, 2026
⭐ Support the Project
If you like the project, give it a star on GitHub!
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file manuleye-1.2.1.tar.gz.
File metadata
- Download URL: manuleye-1.2.1.tar.gz
- Upload date:
- Size: 23.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2a651b6215f4b55b6209c46682b2625687e23e5622966ace3dc9923f10684d27
|
|
| MD5 |
d63fa3291b7d5941a1eda40eaed8f5df
|
|
| BLAKE2b-256 |
a27edbb9e18ec7bb369ac9394a474e3f15e2c62caad8c0514a205f832f5bdff2
|
File details
Details for the file manuleye-1.2.1-py3-none-any.whl.
File metadata
- Download URL: manuleye-1.2.1-py3-none-any.whl
- Upload date:
- Size: 25.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8371e50fd7b82b46612b6e33e5ce0c7b9f571519ae0be164f8660d3a2223fcb7
|
|
| MD5 |
f47e7784969a5109dd542383c37126ef
|
|
| BLAKE2b-256 |
7996c367c6213fbe1610bb012567d3e05eb86ce957098e32ff36044d1625ff19
|