Skip to content
KitploitKITPLOIT
ToolsExploitsBlog
Log in
Submit
ToolsExploitsBlog
Submit

Hacking, PenTest, and Cybersecurity Tools for Your Security Arsenal!

Kitploit is a directory of hacking, cybersecurity, and pentesting tools. Discover the latest project updates to find vulnerabilities, analyze systems, automate testing, and strengthen your security.

FeedsContactPrivacy© 2026 Kitploit

Tool Directory

Categories

View all categories
Loading categories
Tools/GitHubGitHub/d00movenok/htmlsmuggler
Payload GenerationIDS/IPS EvasionWeb Application ExploitationPhishingRed Teaming
GitHubd00movenok/htmlsmuggler

HTMLSmuggler

✉️ HTML Smuggling generator&obfuscator for your Red Team operations

View Repository
20024472 years agoReviewed by Kitploit
Share

HTMLSmuggler ✉️

License: MIT

HTMLSmuggler - JS payload generator for IDS bypass and payload delivery via HTML smuggling.

Description

The full explanation what is HTML Smuggling may be found here.

The primary objective of HTML smuggling is to bypass network security controls, such as firewalls and intrusion detection systems, by disguising malicious payloads (e.g. executables/archives/etc.) within seemingly harmless HTML and JavaScript code. By exploiting the dynamic nature of web applications, attackers can deliver malicious content to a user's browser without triggering security alerts or being detected by traditional security mechanisms. Thanks to this technique, the download of a malicious file is not displayed in any way in modern IDS solutions.

The main goal of HTMLSmuggler tool is creating an independent javascript library with embedded malicious user-defined payload. This library may be integrated into your phishing sites/email html attachments/etc. to deliver embedded payload to the target user system (bypassing IDS and IPS system). An example of created javascript library may be found here.

Features

  • Built-in highly configurable JavaScript obfuscator that fully hides your payload makes it impossible to extract your payload from javascript manually.
  • Powerful client-side bots and headless crawlers detection library that doesn't share your payloads with smart secure mail gateways and their friends.
  • Delay before loading to avoid sandboxes that are in a hurry.
  • May be used both as an independent JS library or embedded in JS frameworks such as React, Vue.js, etc.
  • The simplicity of the template allows you to add extra data handlers/compressions/obfuscations.
  • Support a lot of browsers (including old IE10).

Installation

  1. Install yarn package manager.

  2. Install dependencies:

    yarn
    
  3. Read help message.

    yarn build -h
    
    Options:
      -p, --payload <string>   Path to payload file you want to smuggle
      -n, --name <string>      Name of file, that would be downloaded
      -t, --type <string>      Contet-Type of downlonaded file (default: "application/octet-stream")
      -f, --function <string>  Name of exported function (default: "download")
      -c, --compress           Enable payload compression (gzip)
      -d, --delay <number>     Delay before antibot and download in ms (default: 0)
      -a, --antibot            Enable bot detection and block them (recommended)
      -h, --help               display help for command
    

Usage

Preparation steps

  1. (Optional) Modify javascript-obfuscator options in obfuscator.js, my preset is nice, but very slow.

  2. Compile your javascript payload:

    ⚠️ AVOID USAGE OF PAYLOADS BIGGER THAN 3 MiB (see FAQ)

    yarn build -p /path/to/payload -n file.exe -t "application/octet-stream" -c -a -d 3000
    
  3. Get your payload from dist/payload.esm.js or dist/payload.umd.js. After that, it may be inserted into your page and called with download() (or custom specified with -f flag) function.

    payload.esm.js is used in import { download } from 'payload.esm'; imports (ECMAScript standart).

    payload.umd.js is used in html script SRC and require('payload.umd'); imports (CommonJS, AMD and pure html).

Pure HTML example

A full example may be found here.

  1. Do preparation steps.

  2. Import created script to html file (or insert it inline):

    <head>
      <script src="payload.umd.js"></script>
    </head>
    
  3. Call download() function from body:

    <body>
      <button onclick="download()">Some phishy button</button>
    </body>
    
  4. Happy phishing :)

VueJS example

A full example may be found here.

  1. Do preparation steps.

  2. Import created script to vue file:

    <script>
      import { download } from './payload.esm';
    </script>
    
  3. Call download() function:

    <template>
      <button @click="download()">Some phishy button</button>
    </template>
    
  4. Happy phishing :)

FAQ

Q: I have an error RangeError: Maximum call stack size exceeded, how to solve it?

A: This issue described here. To fix it, try to disable splitStrings in obfuscator.js or make smaller payload (it's recommended to use up to 2 MB payloads because of this issue).


Q: Why does my payload build so long?

A: The bigger payload you use, the longer it takes to create a JS file. To decrease time of build, try to disable splitStrings in obfuscator.js. Below is a table with estimated build times using default obfuscator.js.

Payload sizeBuild time
525 KB53 s
1.25 MB8 m
3.59 MB25 m
Download Tool

Most Popular

View all →

Discover the most used tools by our community.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 The ultimate OSINT toolkit: investigation graph, confidence scoring, alias families, map, timeline and reports. 49 modules, 400+ sites, no API keys required.

    786
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    GhostLock One-Tap Execution App (CVE-2026-43499)

    506
  • 3

    ARTEX

    baarai/artex

    LLM multi-agent autonomous penetration testing platform with planner/worker agents, asset and exploration graphs, MITM traffic recording, and vulnerability retesting.

    429
  • 4

    redforge

    cybersecurity91/redforge

    Browser-side red team toolkit with 102 offline tools for recon, payload generation, credential attacks, crypto, encoding and engagement reporting.

    345
  • 5

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    The system of action for AI-native cybersecurity—where intent becomes governed execution, evidence becomes operational memory, and every operation improves the next.

    262
  • 6

    looking-glass

    anonghosty/looking-glass

    CSIRT platform that ingests Shadowserver reports into MongoDB and replays them as interactive maps, analysis, findings, advisories and executive dashboards.

    256

Explore all tools

Browse our collection of tools

View all tools →