Skip to main content
HackingTool must be run as root on a Linux-based system. It is designed for Kali Linux, Parrot OS, Arch Linux, and other security-focused distributions.

​
System Requirements

Before installing HackingTool, ensure your system meets these requirements:
  • Operating System: Linux (Kali Linux, Parrot OS, Arch Linux, or similar)
  • Python: Python 3.6 or higher
  • Root Access: Required for installation and running tools
  • Internet Connection: Required for downloading tools and dependencies
  • Git: For cloning the repository
HackingTool is designed for Linux only. Windows users should use WSL2, VirtualBox, or Docker.

​
Installation Methods

​
Step-by-Step Installation

1

Clone the Repository

Clone the HackingTool repository from GitHub:
git clone https://github.com/Z4nzu/hackingtool.git
2

Set Permissions

Grant execute permissions to the hackingtool directory:
chmod -R 755 hackingtool
3

Navigate to Directory

Move into the hackingtool directory:
cd hackingtool
4

Run Installer

Execute the installer script with root privileges:
sudo python3 install.py
The installer will:
  • Check for root access
  • Verify internet connectivity
  • Update system packages
  • Install required dependencies (git, python3-pip, python3-venv, figlet, boxes, php, curl, xdotool, wget)
  • Clone the repository to /usr/share/hackingtool
  • Create a virtual environment
  • Install Python requirements (boxes, flask, lolcat, requests, rich)
  • Create a launcher script at /usr/bin/hackingtool
5

Launch HackingTool

After installation completes, start HackingTool:
sudo hackingtool

​
Installation Output

During installation, you’ll see:
Select Best Option:

              [1] Kali Linux / Parrot-Os (apt)
              [2] Arch Linux (pacman)
              [0] Exit
Choose your distribution’s package manager, and the installer will handle the rest.

​
Dependencies

​
System Packages

The installer automatically installs these system packages: For Debian/Ubuntu-based systems (apt):
  • git
  • python3-pip
  • python3-venv
  • figlet
  • boxes
  • php
  • curl
  • xdotool
  • wget
For Arch Linux (pacman):
  • git
  • python-pip
  • figlet (may require AUR)

​
Python Packages

Installed via pip in a virtual environment:
  • boxes - Text formatting
  • flask - Web framework for certain tools
  • lolcat - Colorful output
  • requests - HTTP library
  • rich - Terminal UI framework

​
Installation Locations

After installation:
ComponentLocation
Main installation/usr/share/hackingtool/
Virtual environment/usr/share/hackingtool/venv/
Launcher script/usr/bin/hackingtool
Tool downloads~/hackingtool/ (configurable) or /home/hackingtool/

​
Post-Installation Verification

1

Check Installation

Verify the launcher is accessible:
which hackingtool
Expected output:
/usr/bin/hackingtool
2

Test Launch

Run HackingTool to verify it starts correctly:
sudo hackingtool
You should see the ASCII logo and main menu with 18 options.
3

Configure Tool Path

On first run, you’ll be prompted to set a path for tool installations:
Set Path
[1] Custom Path
[2] Default Path (/home/hackingtool/)
This path is saved to ~/hackingtoolpath.txt and used for all future tool downloads.

​
Troubleshooting

Problem: Permission denied when running installer or hackingtoolSolution: Ensure you’re running with root privileges:
sudo python3 install.py
sudo hackingtool
Problem: Installer reports no internet connectionSolution: The installer checks connectivity by pinging Google and GitHub. Verify your network:
curl -sSf https://github.com
Problem: apt or pacman errors during installationSolution: Update your package manager first:
# For Debian/Ubuntu
sudo apt update && sudo apt upgrade -y

# For Arch
sudo pacman -Syu
Problem: /usr/share/hackingtool already exists from previous installationSolution: The installer will ask if you want to replace it. Choose yes to proceed:
The directory /usr/share/hackingtool already exists.
Replace it? This will remove the existing directory [y/N]:
Problem: python3: command not foundSolution: Install Python 3:
# Debian/Ubuntu
sudo apt install python3 python3-pip

# Arch
sudo pacman -S python python-pip

​
Updating HackingTool

To update to the latest version: 
sudo hackingtool
# Select option 99: "Update or Uninstall | Hackingtool"
# Choose update option

​
Uninstalling

To completely remove HackingTool: 
sudo hackingtool
# Select option 99: "Update or Uninstall | Hackingtool"
# Choose uninstall option
Legal Disclaimer: HackingTool is for educational and authorized security testing only. Do not use for illegal activities. Always obtain proper authorization before testing any systems you don’t own.

​
Next Steps

Quickstart Guide

Learn how to launch HackingTool and install your first security tool

Tool Categories

Explore the 17 categories of security tools available

Build docs developers (and LLMs) love

Get started for freeTalk to us