Skip to content

516hackers/cybertoolkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

97 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Cybertoolkit - 516 Hackers Toolkit

516 Hackers Ethical Security Platform

A comprehensive cybersecurity toolkit designed for ethical security testing, penetration testing, and digital forensics. Built with ❀️ by 516 Hackers community.

⚠️ LEGAL DISCLAIMER

This toolkit is for authorized security testing only.

  • You MUST have explicit permission to test any system
  • Unauthorized use is illegal and unethical
  • Users are solely responsible for their actions
  • Educational purposes only

Read Full Legal Notice

πŸš€ Quick Start

Prerequisites

  • Kali Linux (Recommended) or Termux (Android)
  • Basic terminal knowledge
  • Legal authorization for testing

Installation Auto Method 1: Automated Installation (Recommended)

Open a terminal and run:

  1. Clone the repo
git clone https://github.com/516hackers/cybertoolkit.git
cd cybertoolkit
  1. Make installer scripts executable
chmod +x scripts/*.sh
  1. Run the automated installer
./scripts/install-all.sh

This will install common tools and make the toolkit ready to use.


Manual Setup Method 2: Manual Setup

  1. Clone the repo:
git clone https://github.com/516hackers/cybertoolkit.git
cd cybertoolkit
  1. Make helper scripts executable:
chmod +x scripts/*.sh
chmod +x tools/**/*.sh
chmod +x tools/**/*.py
  1. Run the environment checker:
./scripts/check-env.sh

Commands Basic commands you will use

dvbdgScreenshot (23)
  • Show list of available tools:
./scripts/list-tools.sh
  • Quick access menu:
./scripts/tools-quick.sh
  • Run a tool wrapper (example: whois):
./tools/reconnaissance/whois-wrapper.sh example.com

Platform-Specific Setup

πŸ‰ Kali Linux

# Update system
sudo apt update && sudo apt upgrade -y

# Install core tools
sudo apt install -y whois nmap masscan nikto gobuster dirb john python3 python3-pip

# Install Python tools
pip3 install theharvester pdfplumber Pillow requests

πŸ“± Termux (Android)

# Update packages
pkg update && pkg upgrade -y

# Install core tools
pkg install -y whois nmap python

# Install Python tools
pip install theharvester pdfplumber Pillow requests

πŸ”§ Go Tools (Optional)

# Install Go if not present
sudo apt install golang-go  # Kali
pkg install golang          # Termux

# Install Go-based tools
go install -v github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest
go install -v github.com/projectdiscovery/nuclei/v2/cmd/nuclei@latest
go install github.com/ffuf/ffuf@latest

πŸ› οΈ Tool Categories

1. πŸ” Reconnaissance

Tool Description Usage
WHOIS Domain registration lookup ./tools/reconnaissance/whois-wrapper.sh example.com
Subfinder Subdomain discovery ./tools/reconnaissance/subfinder-wrapper.sh example.com
theHarvester OSINT email & subdomain gathering ./tools/reconnaissance/theHarvester/run_theharvester.py -d example.com -b all

2. 🌐 Network Scanning

Tool Description Usage
Nmap Network discovery & security auditing ./tools/network/nmap-wrapper.sh 192.168.1.1 quick
Masscan Mass port scanning ./tools/network/masscan-wrapper.sh 192.168.1.0/24 1-1000

3. πŸ•ΈοΈ Web Application Testing

Tool Description Usage
Gobuster Directory/file brute forcing ./tools/web/gobuster-wrapper.sh dir http://example.com
FFUF Fast web fuzzer ./tools/web/ffuf-wrapper.sh http://example.com/FUZZ wordlists/common.txt
Nikto Web server scanner ./tools/vulnerability/nikto-wrapper.sh http://example.com

4. 🎯 Vulnerability Assessment

Tool Description Usage
Nuclei Template-based vulnerability scanning ./tools/vulnerability/nuclei-wrapper.sh http://example.com
Nikto Comprehensive web server scan ./tools/vulnerability/nikto-wrapper.sh http://example.com

5. πŸ” Password Security

Tool Description Usage
John the Ripper Password cracking ./tools/password/john-wrapper.sh hashes.txt

6. πŸ“Š Analysis Tools

Tool Description Usage
Metadata Extractor File metadata analysis ./tools/analysis/metadata-extractor.py document.pdf
OSINT Lookup Multi-source intelligence gathering ./tools/utils/osint_lookup.py example.com

πŸ“– Complete Usage Guide

Step 1: Environment Setup

# Verify your environment
./scripts/check-env.sh

# Expected output:
# βœ… Platform: Kali Linux
# βœ… Tools: whois, nmap, nikto, python3
# ❌ Missing: subfinder, nuclei (install with Go)

Step 2: Target Reconnaissance

# Start with domain reconnaissance
./tools/reconnaissance/whois-wrapper.sh example.com
./tools/reconnaissance/subfinder-wrapper.sh example.com
./tools/reconnaissance/theHarvester/run_theharvester.py -d example.com -b google,bing

Step 3: Network Mapping

# Quick network scan
./tools/network/nmap-wrapper.sh 192.168.1.1 quick

# Comprehensive scan
./tools/network/nmap-wrapper.sh 192.168.1.1 full

# UDP scan
./tools/network/nmap-wrapper.sh 192.168.1.1 udp

Step 4: Web Application Testing

# Directory brute forcing
./tools/web/gobuster-wrapper.sh dir http://example.com

# Vulnerability scanning
./tools/vulnerability/nikto-wrapper.sh http://example.com
./tools/vulnerability/nuclei-wrapper.sh http://example.com

Step 5: Analysis & Reporting

# Extract metadata from files
./tools/analysis/metadata-extractor.py suspect_file.jpg -o report.json

# OSINT gathering
./tools/utils/osint_lookup.py target@example.com -t email -o osint_report.json

πŸ—‚οΈ Project Structure

cybertoolkit/
β”œβ”€β”€ tools/                    # All security tools
β”‚   β”œβ”€β”€ reconnaissance/      # Information gathering
β”‚   β”œβ”€β”€ network/            # Network scanning
β”‚   β”œβ”€β”€ web/               # Web application testing
β”‚   β”œβ”€β”€ vulnerability/     # Vulnerability assessment
β”‚   β”œβ”€β”€ password/         # Password security
β”‚   β”œβ”€β”€ analysis/        # Digital forensics
β”‚   └── utils/          # Utility tools
β”œβ”€β”€ scripts/            # Installation & setup
β”œβ”€β”€ logs/              # Activity logs (gitignored)
β”œβ”€β”€ templates/         # Report templates
β”œβ”€β”€ tests/            # Test scripts
└── docs/            # Documentation

πŸ”’ Security Features

  • Automatic Logging: All activities logged with timestamps
  • Legal Compliance: Built-in consent requirements
  • Platform Detection: Automatic Kali/Termux support
  • Error Handling: Comprehensive tool availability checks
  • Ethical Focus: Educational and authorized use only

πŸ“ Logging & Reporting

All tool activities are automatically logged:

# Logs are stored in logs/ directory
ls logs/
# whois_20231201_143022.log
# nmap_20231201_143125.log
# nikto_20231201_143230.log

🐳 Docker Support

Build Docker Image

cd docker
docker build -t cybertoolkit .

Run Container

docker run -it --rm -v $(pwd):/workspace cybertoolkit

VS Code Dev Container

# Open in VS Code with Dev Containers extension
code .
# Reopen in container when prompted

🀝 Contributing

We welcome ethical contributions! Please read our contributing guidelines:

  1. Fork the repository
  2. Create a feature branch
  3. Add your tool with proper documentation
  4. Test on both Kali and Termux
  5. Submit a pull request

See Contributing Guidelines

πŸ› Troubleshooting

Common Issues

Tool not found:

# Check installation
./scripts/check-env.sh

# Install missing tools
./scripts/install-all.sh

Permission denied:

chmod +x scripts/*.sh
chmod +x tools/**/*.sh

Python import errors:

pip3 install -r tools/reconnaissance/theHarvester/requirements.txt

Platform-Specific Notes

Termux Limitations:

  • Some tools may require root access
  • GPU acceleration not available for hashcat
  • Limited port scanning capabilities

Kali Linux:

  • Run as root for some network operations
  • Use sudo where required
  • Pre-installed tools available

πŸ“œ License

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

πŸ™ Acknowledgments

  • 516 Hackers Community - For collaboration and testing
  • Kali Linux Team - For the amazing penetration testing platform
  • Termux Developers - For bringing Linux to Android
  • Open Source Tools - All the amazing security tools we wrap

πŸ“ž Support

⭐ Star History

If you find this project useful, please give it a star! ⭐


Remember: With great power comes great responsibility. Always hack ethically!


Built with ❀️ by 516 Hackers - Promoting ethical security research worldwide

About

A collection of ethical cybersecurity tools and safe wrappers for reconnaissance, scanning, analysis, and OSINT. Supports Kali Linux and Termux

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

8 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors