Windows

Detailed H4X-Tools Installation Guide for Windows

Click here to view a video tutorial.

Note

Make sure your system is up to date.

Prerequisites

Before installing H4X-Tools, you need to have Python and Git installed on your system. You can install them using the Windows Package Manager (winget) or by downloading their installers directly.

Installing Python and Git

Using Windows Package Manager (winget):

1. Open PowerShell or Command Prompt as Administrator.

2. Install Python:

   winget install python

3. Install Git:

   winget install git.git

Alternatively, Using Direct Downloads:

1. Download Python Installer:

   Visit the official Python downloads page. Run the installer and follow the on-screen instructions.

2. Download Git Installer:

   Visit the official Git downloads page. Run the installer and follow the on-screen instructions.

Installing H4X-Tools

After installing Python and Git, you can proceed to install H4X-Tools:

1. Clone the H4X-Tools repository:

   git clone https://github.com/vil/h4x-tools.git

2. Navigate to the H4X-Tools Directory:

   cd h4x-tools

3. Run the setup.bat script:

   .\setup.bat

   The setup.bat script will:

   • Install required Python dependencies listed in requirements.txt.
   • Build the H4X-Tools executable using PyInstaller.

   If you encounter any issues during this process, ensure that all dependencies are correctly installed and that you have the necessary permissions.

   The setup.bat script is designed to automate the setup process. You can view its contents here.

4. Locate the Executable:

   After the setup completes, the built executable will be located in the dist folder within the H4X-Tools directory.

5. Move the Executable to a Desired Location (Optional):

   The script will ask if you want to do this, however if you want to do it manually, execute:

   move dist\h4xtools.exe C:\Users\YOUR_USERNAME\Desktop

Updating H4X-Tools

To update H4X-Tools to the latest version:

1. Navigate to the H4X-Tools Directory:

   cd C:\path\to\h4x-tools

2. Run the update.bat script:

   .\update.bat

   You can also update the toolkit manually by executing the following commands:

   git fetch && git pull

   .\setup.bat

   This will rebuild the tool with the latest updates.

Using Pre-Built Executables

If you prefer not to build H4X-Tools from source, you can download pre-built executables from the Releases page. Be aware that Windows Defender might flag these executables as potential threats. If this occurs, you may need to temporarily disable Windows Defender or allow the execution of the file.

Warning

Exercise caution when downloading and running executables from the internet. Ensure that the source is trustworthy.