Skip to main content

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

  1. Username Hunt - Search across 500+ social networks
  2. Email Lookup - Check email on various services
  3. Phone Intel - Detailed phone number information
  4. IP Geolocate - IP geolocation and information
  5. Domain Resolve - Domain resolution and data collection

EXPLOIT Category

  1. SQLMap - Automated SQL injection testing
  2. XSStrike - XSS vulnerability scanning
  3. Instagram OSINT - Gather data from Instagram profiles

METADATA Category

  1. Archive Info - Analyze archive contents
  2. Meta Cleaner - Remove metadata from images
  3. EXIF Extract - Extract EXIF and GPS from photos
  4. PDF Metadata - PDF document metadata
  5. Video Metadata - Video file metadata
  6. Audio Metadata - Audio file metadata
  7. Office Metadata - Office document metadata

NETWORK Category

  1. Port Scanner - Port scanning
  2. Traceroute - Route tracing
  3. Ping Sweep - Find active hosts
  4. SSL Cert Info - SSL certificate information
  5. HTTP Headers - HTTP header analysis

UTILITIES Category

  1. Create Paste - Create structured OSINT report
  2. Password Gen - Strong password generator

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

How to contribute:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

👤 Author

Daniil Pentium

🙏 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:

  1. Check Issues
  2. Create a new Issue with problem description
  3. 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!

GitHub stars PyPI version Python versions License: MIT

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

manuleye-1.2.1.tar.gz (23.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

manuleye-1.2.1-py3-none-any.whl (25.6 kB view details)

Uploaded Python 3

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

Hashes for manuleye-1.2.1.tar.gz
Algorithm Hash digest
SHA256 2a651b6215f4b55b6209c46682b2625687e23e5622966ace3dc9923f10684d27
MD5 d63fa3291b7d5941a1eda40eaed8f5df
BLAKE2b-256 a27edbb9e18ec7bb369ac9394a474e3f15e2c62caad8c0514a205f832f5bdff2

See more details on using hashes here.

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

Hashes for manuleye-1.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8371e50fd7b82b46612b6e33e5ce0c7b9f571519ae0be164f8660d3a2223fcb7
MD5 f47e7784969a5109dd542383c37126ef
BLAKE2b-256 7996c367c6213fbe1610bb012567d3e05eb86ce957098e32ff36044d1625ff19

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page