Metadata-Version: 2.4
Name: asm-multitool
Version: 1.4.0
Summary: ASM - Actually Safe Multitool: Ethical OSINT Toolkit
Author-email: ASM Team <asm@example.com>
Maintainer-email: ASM Team <asm@example.com>
License: MIT License
        
        Copyright (c) 2024 ASM Team
        
        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.
Project-URL: Homepage, https://github.com/asm-multitool/asm
Project-URL: Documentation, https://asm-multitool.readthedocs.io/
Project-URL: Repository, https://github.com/asm-multitool/asm.git
Project-URL: Issues, https://github.com/asm-multitool/asm/issues
Project-URL: Changelog, https://github.com/asm-multitool/asm/blob/main/CHANGELOG.md
Keywords: osint,security,reconnaissance,ethical,multitool
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: System :: Networking
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Requires-Dist: colorama>=0.4.4
Dynamic: license-file

# ASM - Actually Safe Multitool

[![PyPI version](https://badge.fury.io/py/asm-multitool.svg)](https://pypi.org/project/asm-multitool/)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Ethical OSINT](https://img.shields.io/badge/Ethical-OSINT-green.svg)](https://en.wikipedia.org/wiki/Open-source_intelligence)

**ASM** (Actually Safe Multitool) is a comprehensive, ethical Open Source Intelligence (OSINT) toolkit designed for responsible information gathering and reconnaissance. Built with safety, ethics, and professionalism in mind.

## ⚠️ Important Notice

This tool is designed for **ethical and legal use only**. Always ensure you have proper authorization before performing any reconnaissance activities. The maintainers are not responsible for misuse of this tool.

## ✨ Features

### 🔍 Network Reconnaissance
- IP Geolocation & Reverse DNS Lookup
- Subdomain Enumeration
- Port Scanning & Service Detection
- DNS Enumeration & Zone Transfer
- SSL Certificate Analysis
- Network Speed Testing
- Traceroute & Ping Tools

### 👥 Social Media & Account Intelligence
- Username Enumeration (100+ platforms)
- Social Media Profile Lookup
- Account Finder with Link Generation
- Platform-specific lookups (GitHub, Twitter, Instagram, etc.)

### 🔐 Security & Breach Analysis
- Breach Database Searching
- Password Leak Checking
- Email & Phone Number Validation
- Proxy & VPN Detection
- Certificate Transparency Logs

### 🌐 Advanced OSINT
- Dark Web Search Integration
- Threat Intelligence Feeds
- Metadata Extraction
- Image Reverse Search
- Custom OSINT Query Building
- Maltego-style Link Analysis

### 🛠️ Professional Tools
- 60+ Built-in Functions
- Modular Architecture
- Safe Input Validation
- Error Handling & Logging
- Cross-platform Compatibility
- Smooth Gradient UI

## 🚀 Installation

### From PyPI (Recommended)
```bash
pip install asm-multitool
```

### From Source
```bash
git clone https://github.com/asm-multitool/asm.git
cd asm
pip install -e .
```

### Requirements
- Python 3.8+
- Dependencies: `requests`, `colorama`

## 📖 Usage

### Command Line
```bash
# Run the interactive tool
asm

# Or use as a module
python -m asm
```

### Programmatic Usage
```python
from asm import main
main()
```

## 📋 Menu Structure

ASM features a 3-page menu system with 20 options per page:

### Page 1: Network Tools
1. IP Geolocation Lookup
2. Reverse DNS Lookup
3. Subdomain Finder
4. WHOIS Lookup
5. Port Scanner
6. DNS Enumeration
7. Traceroute
8. Ping Tool
9. Network Speed Test
10. SSL Certificate Check
11. HTTP Headers Check
12. Website Uptime Check
13. GeoIP Bulk Lookup
14. DNS Zone Transfer
15. MAC Address Lookup
16. ASN Lookup
17. BGP Route Lookup
18. Network WHOIS
19. TCP SYN Scan
20. UDP Scan

### Page 2: Social & Account Tools
1. ICMP Ping Sweep
2. ARP Scan
3. Account Finder
4. Roblox Lookup
5. Discord Lookup
6. Instagram Lookup
7. Twitter Lookup
8. GitHub Lookup
9. YouTube Lookup
10. Look for Leaks
11. Proxy Checker
12. VPN Checker
13. Email Lookup
14. Phone Lookup
15. Image Reverse Search
16. OSINT Gathering
17. OSINT Panel
18. Metadata Extractor
19. Certificate Transparency
20. IP Reputation Check

### Page 3: Advanced Tools
1. Domain Age Checker
2. Email Verification
3. Dark Web Search
4. Pastebin Search
5. GitHub Dorks
6. Shodan Search
7. Maltego Transforms
8. Advanced Metadata
9. Breach Databases
10. Social Media OSINT
11. Forensic Analysis
12. Threat Intelligence
13. Custom OSINT Query
14. Export Results
15. Settings
16. Kali Recon Tools

## 🔧 Configuration

ASM includes sensible defaults but can be configured:

- **Timeout Settings**: Default 10 seconds for network requests
- **User Agent**: Custom ethical user agent string
- **Thread Limits**: Configurable for bulk operations
- **Output Formats**: JSON/CSV export capabilities

## 🛡️ Safety Features

- **Input Validation**: All inputs are sanitized and validated
- **Error Handling**: Comprehensive exception handling
- **Ethical Warnings**: Clear disclaimers for potentially sensitive operations
- **No Malicious Code**: Removed all dangerous or illegal functionality
- **Responsible Design**: Built with privacy and ethics in mind

## 📚 Dependencies

Core dependencies are automatically installed:
- `requests` - HTTP client for API interactions
- `colorama` - Cross-platform colored terminal output

Optional dependencies for extended functionality:
- `dnspython` - Advanced DNS operations
- `scapy` - Network packet manipulation
- `pillow` - Image metadata extraction

## 🤝 Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- Built with ethical OSINT principles
- Inspired by various open-source security tools
- Thanks to the security research community

## 📞 Support

- **Issues**: [GitHub Issues](https://github.com/asm-multitool/asm/issues)
- **Discussions**: [GitHub Discussions](https://github.com/asm-multitool/asm/discussions)
- **Documentation**: [Read the Docs](https://asm-multitool.readthedocs.io/)

---

**Remember**: With great power comes great responsibility. Use ASM ethically and legally.
