mirror of
https://github.com/Z4nzu/hackingtool
synced 2026-05-24 09:28:43 +00:00
043fa0e7b7
- Add _collect_all_tools() — walks all collections recursively and returns (tool_instance, category_name) pairs for 185 tools - Add search_tools() — prompts for query, matches against TITLE and DESCRIPTION (case-insensitive), shows results table with category, user selects a result number to jump directly into tool.show_options() - Wire / and s commands into interact_menu() - Add / search to help overlay and hint bar - Fix ToolManager row number: was hardcoded 18, now computed dynamically from len(categories) + 1 (currently 21)
478 lines
19 KiB
Python
Executable file
478 lines
19 KiB
Python
Executable file
#!/usr/bin/env python3
|
||
import sys
|
||
|
||
# ── Python version guard (must be before any other local import) ───────────────
|
||
if sys.version_info < (3, 10):
|
||
print(
|
||
f"[ERROR] Python 3.10 or newer is required.\n"
|
||
f"You are running Python {sys.version_info.major}.{sys.version_info.minor}.\n"
|
||
f"Upgrade with: sudo apt install python3.10"
|
||
)
|
||
sys.exit(1)
|
||
|
||
import os
|
||
import platform
|
||
import socket
|
||
import datetime
|
||
import random
|
||
import webbrowser
|
||
from itertools import zip_longest
|
||
|
||
from rich.console import Console
|
||
from rich.panel import Panel
|
||
from rich.table import Table
|
||
from rich.prompt import Prompt, Confirm
|
||
from rich.align import Align
|
||
from rich.text import Text
|
||
from rich import box
|
||
from rich.rule import Rule
|
||
from rich.columns import Columns
|
||
|
||
from core import HackingToolsCollection, clear_screen, console
|
||
from constants import VERSION_DISPLAY, REPO_WEB_URL
|
||
from config import get_tools_dir
|
||
from tools.anonsurf import AnonSurfTools
|
||
from tools.ddos import DDOSTools
|
||
from tools.exploit_frameworks import ExploitFrameworkTools
|
||
from tools.forensics import ForensicTools
|
||
from tools.information_gathering import InformationGatheringTools
|
||
from tools.other_tools import OtherTools
|
||
from tools.payload_creator import PayloadCreatorTools
|
||
from tools.phishing_attack import PhishingAttackTools
|
||
from tools.post_exploitation import PostExploitationTools
|
||
from tools.remote_administration import RemoteAdministrationTools
|
||
from tools.reverse_engineering import ReverseEngineeringTools
|
||
from tools.sql_injection import SqlInjectionTools
|
||
from tools.steganography import SteganographyTools
|
||
from tools.tool_manager import ToolManager
|
||
from tools.web_attack import WebAttackTools
|
||
from tools.wireless_attack import WirelessAttackTools
|
||
from tools.wordlist_generator import WordlistGeneratorTools
|
||
from tools.xss_attack import XSSAttackTools
|
||
from tools.active_directory import ActiveDirectoryTools
|
||
from tools.cloud_security import CloudSecurityTools
|
||
from tools.mobile_security import MobileSecurityTools
|
||
|
||
# ── Tool registry ──────────────────────────────────────────────────────────────
|
||
|
||
# (full_title, icon, menu_label)
|
||
# menu_label is the concise name shown in the 2-column main menu grid.
|
||
# full_title is shown when entering the category.
|
||
tool_definitions = [
|
||
("Anonymously Hiding Tools", "🛡 ", "Anonymously Hiding"),
|
||
("Information gathering tools", "🔍", "Information Gathering"),
|
||
("Wordlist Generator", "📚", "Wordlist Generator"),
|
||
("Wireless attack tools", "📶", "Wireless Attack"),
|
||
("SQL Injection Tools", "🧩", "SQL Injection"),
|
||
("Phishing attack tools", "🎣", "Phishing Attack"),
|
||
("Web Attack tools", "🌐", "Web Attack"),
|
||
("Post exploitation tools", "🔧", "Post Exploitation"),
|
||
("Forensic tools", "🕵 ", "Forensics"),
|
||
("Payload creation tools", "📦", "Payload Creation"),
|
||
("Exploit framework", "🧰", "Exploit Framework"),
|
||
("Reverse engineering tools", "🔁", "Reverse Engineering"),
|
||
("DDOS Attack Tools", "⚡", "DDOS Attack"),
|
||
("Remote Administrator Tools (RAT)", "🖥 ", "Remote Admin (RAT)"),
|
||
("XSS Attack Tools", "💥", "XSS Attack"),
|
||
("Steganography tools", "🖼 ", "Steganography"),
|
||
("Active Directory Tools", "🏢", "Active Directory"),
|
||
("Cloud Security Tools", "☁ ", "Cloud Security"),
|
||
("Mobile Security Tools", "📱", "Mobile Security"),
|
||
("Other tools", "✨", "Other Tools"),
|
||
("Update or Uninstall | Hackingtool", "♻ ", "Update / Uninstall"),
|
||
]
|
||
|
||
all_tools = [
|
||
AnonSurfTools(),
|
||
InformationGatheringTools(),
|
||
WordlistGeneratorTools(),
|
||
WirelessAttackTools(),
|
||
SqlInjectionTools(),
|
||
PhishingAttackTools(),
|
||
WebAttackTools(),
|
||
PostExploitationTools(),
|
||
ForensicTools(),
|
||
PayloadCreatorTools(),
|
||
ExploitFrameworkTools(),
|
||
ReverseEngineeringTools(),
|
||
DDOSTools(),
|
||
RemoteAdministrationTools(),
|
||
XSSAttackTools(),
|
||
SteganographyTools(),
|
||
ActiveDirectoryTools(),
|
||
CloudSecurityTools(),
|
||
MobileSecurityTools(),
|
||
OtherTools(),
|
||
ToolManager(),
|
||
]
|
||
|
||
# Used by generate_readme.py
|
||
class AllTools(HackingToolsCollection):
|
||
TITLE = "All tools"
|
||
TOOLS = all_tools
|
||
|
||
|
||
# ── Help overlay ───────────────────────────────────────────────────────────────
|
||
|
||
def show_help():
|
||
console.print(Panel(
|
||
Text.assemble(
|
||
(" Main menu\n", "bold white"),
|
||
(" ─────────────────────────────────────\n", "dim"),
|
||
(" 1–20 ", "bold cyan"), ("open a category\n", "white"),
|
||
(" 21 ", "bold cyan"), ("Update / Uninstall hackingtool\n", "white"),
|
||
(" / or s ", "bold cyan"), ("search tools by name or keyword\n", "white"),
|
||
(" ? ", "bold cyan"), ("show this help\n", "white"),
|
||
(" q ", "bold cyan"), ("quit hackingtool\n\n", "white"),
|
||
(" Inside a category\n", "bold white"),
|
||
(" ─────────────────────────────────────\n", "dim"),
|
||
(" 1–N ", "bold cyan"), ("select a tool\n", "white"),
|
||
(" 99 ", "bold cyan"), ("back to main menu\n", "white"),
|
||
(" 98 ", "bold cyan"), ("open project page (if available)\n\n", "white"),
|
||
(" Inside a tool\n", "bold white"),
|
||
(" ─────────────────────────────────────\n", "dim"),
|
||
(" 1 ", "bold cyan"), ("install tool\n", "white"),
|
||
(" 2 ", "bold cyan"), ("run tool\n", "white"),
|
||
(" 99 ", "bold cyan"), ("back to category\n", "white"),
|
||
),
|
||
title="[bold magenta] ? Quick Help [/bold magenta]",
|
||
border_style="magenta",
|
||
box=box.ROUNDED,
|
||
padding=(0, 2),
|
||
))
|
||
Prompt.ask("[dim]Press Enter to return[/dim]", default="")
|
||
|
||
|
||
# ── Header: ASCII art + live system info ──────────────────────────────────────
|
||
|
||
# Full "HACKING TOOL" block-letter art — 12 lines, split layout with stats
|
||
_BANNER_ART = [
|
||
" ██╗ ██╗ █████╗ ██████╗██╗ ██╗██╗███╗ ██╗ ██████╗ ",
|
||
" ██║ ██║██╔══██╗██╔════╝██║ ██╔╝██║████╗ ██║██╔════╝ ",
|
||
" ███████║███████║██║ █████╔╝ ██║██╔██╗ ██║██║ ███╗",
|
||
" ██╔══██║██╔══██║██║ ██╔═██╗ ██║██║╚██╗██║██║ ██║",
|
||
" ██║ ██║██║ ██║╚██████╗██║ ██╗██║██║ ╚████║╚██████╔╝",
|
||
" ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝╚═╝╚═╝ ╚═══╝ ╚═════╝ ",
|
||
" ████████╗ ██████╗ ██████╗ ██╗",
|
||
" ╚══██╔══╝██╔═══██╗██╔═══██╗██║",
|
||
" ██║ ██║ ██║██║ ██║██║",
|
||
" ██║ ██║ ██║██║ ██║██║",
|
||
" ██║ ╚██████╔╝╚██████╔╝███████╗",
|
||
" ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝",
|
||
]
|
||
|
||
_QUOTES = [
|
||
'"The quieter you become, the more you can hear."',
|
||
'"Offense informs defense."',
|
||
'"There is no patch for human stupidity."',
|
||
'"In God we trust. All others we monitor."',
|
||
'"Hackers are the immune system of the internet."',
|
||
'"Every system is hackable — know yours before others do."',
|
||
'"Enumerate before you exploit."',
|
||
'"A scope defines your playground."',
|
||
'"The more you sweat in training, the less you bleed in battle."',
|
||
'"Security is a process, not a product."',
|
||
]
|
||
|
||
|
||
def _sys_info() -> dict:
|
||
"""Collect live system info for the header panel."""
|
||
info: dict = {}
|
||
|
||
# OS pretty name
|
||
try:
|
||
info["os"] = platform.freedesktop_os_release().get("PRETTY_NAME", "")
|
||
except Exception:
|
||
info["os"] = ""
|
||
if not info["os"]:
|
||
info["os"] = f"{platform.system()} {platform.release()}"
|
||
|
||
info["kernel"] = platform.release()
|
||
|
||
# Current user
|
||
try:
|
||
info["user"] = os.getlogin()
|
||
except Exception:
|
||
info["user"] = os.environ.get("USER", os.environ.get("LOGNAME", "root"))
|
||
|
||
info["host"] = socket.gethostname()
|
||
|
||
# Local IP — connect to a routable address without sending data
|
||
try:
|
||
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
|
||
s.settimeout(0)
|
||
s.connect(("10.254.254.254", 1))
|
||
info["ip"] = s.getsockname()[0]
|
||
s.close()
|
||
except Exception:
|
||
info["ip"] = "127.0.0.1"
|
||
|
||
info["time"] = datetime.datetime.now().strftime("%Y-%m-%d %H:%M")
|
||
return info
|
||
|
||
|
||
def _build_header() -> Panel:
|
||
info = _sys_info()
|
||
|
||
# 12 stat lines paired with the 12 art lines
|
||
stat_lines = [
|
||
(" os › ", info["os"][:34]),
|
||
(" kernel › ", info["kernel"][:34]),
|
||
(" user › ", f"{info['user']} @ {info['host'][:20]}"),
|
||
(" ip › ", info["ip"]),
|
||
(" tools › ", f"{len(all_tools)} categories · 185+ modules"),
|
||
(" session › ", info["time"]),
|
||
("", ""),
|
||
(" python › ", f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}"),
|
||
(" arch › ", platform.machine()),
|
||
(" status › ", "✔ READY"),
|
||
("", ""),
|
||
("", ""),
|
||
]
|
||
|
||
grid = Table.grid(padding=0)
|
||
grid.add_column("art", no_wrap=True)
|
||
grid.add_column("sep", no_wrap=True)
|
||
grid.add_column("lbl", no_wrap=True)
|
||
grid.add_column("val", no_wrap=True)
|
||
|
||
for art_line, (lbl_text, val_text) in zip(_BANNER_ART, stat_lines):
|
||
grid.add_row(
|
||
Text(art_line, style="bold bright_green"),
|
||
Text(" │ ", style="dim green"),
|
||
Text(lbl_text, style="dim green"),
|
||
Text(val_text, style="bright_green"),
|
||
)
|
||
|
||
# Quote + warning below the split row
|
||
quote = random.choice(_QUOTES)
|
||
body = Table.grid(padding=(0, 0))
|
||
body.add_column()
|
||
body.add_row(grid)
|
||
body.add_row(Text(""))
|
||
body.add_row(Text(f" {quote}", style="italic dim"))
|
||
body.add_row(Text(" ⚠ For authorized security testing only",
|
||
style="bold dim red"))
|
||
|
||
return Panel(
|
||
body,
|
||
title=f"[bold bright_magenta][ HackingTool {VERSION_DISPLAY} ][/bold bright_magenta]",
|
||
title_align="left",
|
||
subtitle=f"[dim][ {info['time']} ][/dim]",
|
||
subtitle_align="right",
|
||
border_style="bright_magenta",
|
||
box=box.HEAVY,
|
||
padding=(0, 1),
|
||
)
|
||
|
||
|
||
# ── Main menu renderer ─────────────────────────────────────────────────────────
|
||
|
||
def build_menu():
|
||
clear_screen()
|
||
console.print(_build_header())
|
||
|
||
# ── 2-column category grid ──
|
||
# Items 1-17 in two columns, item 18 (ToolManager) shown separately
|
||
categories = tool_definitions[:-1] # 17 items
|
||
update_def = tool_definitions[-1] # ToolManager
|
||
|
||
mid = (len(categories) + 1) // 2 # 9 (left), 8 (right)
|
||
left = list(enumerate(categories[:mid], start=1))
|
||
right = list(enumerate(categories[mid:], start=mid + 1))
|
||
|
||
grid = Table.grid(padding=(0, 1), expand=True)
|
||
grid.add_column("ln", justify="right", style="bold magenta", width=5)
|
||
grid.add_column("li", width=3)
|
||
grid.add_column("lt", style="magenta", ratio=1, no_wrap=True)
|
||
grid.add_column("gap", width=3)
|
||
grid.add_column("rn", justify="right", style="bold magenta", width=5)
|
||
grid.add_column("ri", width=3)
|
||
grid.add_column("rt", style="magenta", ratio=1, no_wrap=True)
|
||
|
||
for (li, (_, lic, ll)), r in zip_longest(left, right, fillvalue=None):
|
||
if r:
|
||
ri, (_, ric, rl) = r
|
||
grid.add_row(str(li), lic, ll, "", str(ri), ric, rl)
|
||
else:
|
||
grid.add_row(str(li), lic, ll, "", "", "", "")
|
||
|
||
console.print(Panel(
|
||
grid,
|
||
title="[bold magenta] Select a Category [/bold magenta]",
|
||
border_style="bright_magenta",
|
||
box=box.ROUNDED,
|
||
padding=(0, 1),
|
||
))
|
||
|
||
# ── ToolManager row ──
|
||
tm_num = len(categories) + 1
|
||
console.print(
|
||
f" [bold magenta] {tm_num}[/bold magenta] {update_def[1]} "
|
||
f"[magenta]{update_def[2]}[/magenta]"
|
||
)
|
||
|
||
# ── Hint bar ──
|
||
console.print(Rule(style="dim magenta"))
|
||
console.print(
|
||
" [dim]Enter number · "
|
||
"[bold cyan]/[/bold cyan] search · "
|
||
"[bold cyan]?[/bold cyan] help · "
|
||
"[bold cyan]q[/bold cyan] quit[/dim]\n"
|
||
)
|
||
|
||
|
||
# ── Search ─────────────────────────────────────────────────────────────────────
|
||
|
||
def _collect_all_tools() -> list[tuple]:
|
||
"""Walk all collections and return (tool_instance, category_name) pairs."""
|
||
from core import HackingTool, HackingToolsCollection
|
||
results = []
|
||
|
||
def _walk(items, parent_title=""):
|
||
for item in items:
|
||
if isinstance(item, HackingToolsCollection):
|
||
_walk(item.TOOLS, item.TITLE)
|
||
elif isinstance(item, HackingTool):
|
||
results.append((item, parent_title))
|
||
|
||
_walk(all_tools)
|
||
return results
|
||
|
||
|
||
def search_tools():
|
||
"""Interactive search — user types query, results update, select to jump."""
|
||
query = Prompt.ask("[bold cyan]/ Search[/bold cyan]", default="").strip().lower()
|
||
if not query:
|
||
return
|
||
|
||
all_tool_list = _collect_all_tools()
|
||
|
||
# Match against title + description
|
||
matches = []
|
||
for tool, category in all_tool_list:
|
||
title = (tool.TITLE or "").lower()
|
||
desc = (tool.DESCRIPTION or "").lower()
|
||
if query in title or query in desc:
|
||
matches.append((tool, category))
|
||
|
||
if not matches:
|
||
console.print(f"[dim]No tools found matching '{query}'[/dim]")
|
||
Prompt.ask("[dim]Press Enter to return[/dim]", default="")
|
||
return
|
||
|
||
# Display results
|
||
table = Table(
|
||
title=f"Search results for '{query}'",
|
||
box=box.SIMPLE_HEAD, show_lines=True,
|
||
)
|
||
table.add_column("No.", justify="center", style="bold cyan", width=5)
|
||
table.add_column("Tool", style="bold yellow", min_width=20)
|
||
table.add_column("Category", style="magenta", min_width=15)
|
||
table.add_column("Description", style="white", overflow="fold")
|
||
|
||
for i, (tool, cat) in enumerate(matches, start=1):
|
||
desc = (tool.DESCRIPTION or "—").splitlines()[0]
|
||
table.add_row(str(i), tool.TITLE, cat, desc)
|
||
|
||
table.add_row("99", "Back to main menu", "", "")
|
||
console.print(table)
|
||
|
||
raw = Prompt.ask("[bold cyan]>[/bold cyan]", default="").strip().lower()
|
||
if not raw or raw == "99":
|
||
return
|
||
|
||
try:
|
||
idx = int(raw)
|
||
except ValueError:
|
||
return
|
||
|
||
if 1 <= idx <= len(matches):
|
||
tool, cat = matches[idx - 1]
|
||
console.print(Panel(
|
||
f"[bold magenta]{tool.TITLE}[/bold magenta] [dim]({cat})[/dim]",
|
||
border_style="magenta", box=box.ROUNDED,
|
||
))
|
||
tool.show_options()
|
||
|
||
|
||
# ── Main interaction loop ──────────────────────────────────────────────────────
|
||
|
||
def interact_menu():
|
||
while True:
|
||
try:
|
||
build_menu()
|
||
raw = Prompt.ask("[bold magenta]>[/bold magenta]", default="").strip().lower()
|
||
|
||
if not raw:
|
||
continue
|
||
|
||
if raw in ("?", "help"):
|
||
show_help()
|
||
continue
|
||
|
||
if raw.startswith("/") or raw in ("s", "search"):
|
||
search_tools()
|
||
continue
|
||
|
||
if raw in ("q", "quit", "exit"):
|
||
console.print(Panel(
|
||
"[bold white on magenta] Goodbye — Come Back Safely [/bold white on magenta]",
|
||
box=box.HEAVY, border_style="magenta",
|
||
))
|
||
break
|
||
|
||
try:
|
||
choice = int(raw)
|
||
except ValueError:
|
||
console.print("[red]⚠ Invalid input — enter a number, ? for help, or q to quit.[/red]")
|
||
Prompt.ask("[dim]Press Enter to continue[/dim]", default="")
|
||
continue
|
||
|
||
if 1 <= choice <= len(all_tools):
|
||
title, icon, _ = tool_definitions[choice - 1]
|
||
console.print(Panel(
|
||
f"[bold magenta]{icon} {title}[/bold magenta]",
|
||
border_style="magenta", box=box.ROUNDED,
|
||
))
|
||
try:
|
||
all_tools[choice - 1].show_options()
|
||
except Exception as e:
|
||
console.print(Panel(
|
||
f"[red]Error while opening {title}[/red]\n{e}",
|
||
border_style="red",
|
||
))
|
||
Prompt.ask("[dim]Press Enter to return to main menu[/dim]", default="")
|
||
else:
|
||
console.print(f"[red]⚠ Choose 1–{len(all_tools)}, ? for help, or q to quit.[/red]")
|
||
Prompt.ask("[dim]Press Enter to continue[/dim]", default="")
|
||
|
||
except KeyboardInterrupt:
|
||
console.print("\n[bold red]Interrupted — exiting[/bold red]")
|
||
break
|
||
|
||
|
||
# ── Entry point ────────────────────────────────────────────────────────────────
|
||
|
||
def main():
|
||
try:
|
||
from os_detect import CURRENT_OS
|
||
|
||
if CURRENT_OS.system == "windows":
|
||
console.print(Panel("[bold red]Please run this tool on Linux or macOS.[/bold red]"))
|
||
if Confirm.ask("Open guidance link in your browser?", default=True):
|
||
webbrowser.open_new_tab(f"{REPO_WEB_URL}#windows")
|
||
return
|
||
|
||
if CURRENT_OS.system not in ("linux", "macos"):
|
||
console.print(f"[yellow]Unsupported OS: {CURRENT_OS.system}. Proceeding anyway...[/yellow]")
|
||
|
||
get_tools_dir() # ensures ~/.hackingtool/tools/ exists
|
||
interact_menu()
|
||
|
||
except KeyboardInterrupt:
|
||
console.print("\n[bold red]Exiting...[/bold red]")
|
||
|
||
|
||
if __name__ == "__main__":
|
||
main()
|