Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

 ______     __     ______   ______     ______     __    __     ______    
/\___  \   /\ \   /\  == \ /\  == \   /\  __ \   /\ "-./  \   /\  == \   
\/_/  /__  \ \ \  \ \  _-/ \ \  __<   \ \ \/\ \  \ \ \-./\ \  \ \  __<   
  /\_____\  \ \_\  \ \_\    \ \_____\  \ \_____\  \ \_\ \ \_\  \ \_____\ 
  \/_____/   \/_/   \/_/     \/_____/   \/_____/   \/_/  \/_/   \/_____/ 

πŸ’£ ZipBomb Generator

A browser-based ZIP bomb generator β€” enter your unzip size and filename, download in one click.

Live Demo GitHub Repo License: MIT Open Source PRs Welcome


⚠️ DISCLAIMER: This tool is intended strictly for educational and security research purposes only β€” such as testing antivirus engines, decompression bomb detection, and understanding compression mechanics. Do not use this against any system you do not own or have explicit written permission to test. The author bears no responsibility for any misuse.


🌐 Live Demo

No installation needed β€” runs entirely in your browser:

πŸ‘‰ https://anonymous-201.github.io/zipbomb/


πŸ“Έ Preview

The tool features a clean dark UI where you input a ZIP filename and select your desired unzipped size (Bytes β†’ Petabytes), then generate and download the ZIP bomb in one click.


πŸ“– What is a ZIP Bomb?

A ZIP bomb (decompression bomb / zip of death) is a small archive file that expands to a massive size when extracted. They are used in security research to:

  • Test how antivirus software handles malformed or extreme archives
  • Stress-test file upload handlers and decompression pipelines
  • Explore the limits of compression algorithms like DEFLATE

The key mechanic: null bytes (\x00) compress at ratios up to ~1000:1 β€” a 1 MB ZIP can unpack to 1 GB+.


✨ Features

Feature Details
🎯 Custom unzip size Choose from Bytes, KB, MB, GB, TB, or PB
πŸ“ Custom filename Name your output ZIP anything you want
⚑ One-click generation Runs fully in-browser, no server needed
πŸ—œοΈ DEFLATE level 9 Maximum compression for smallest output file
πŸ”’ No data sent anywhere 100% client-side, nothing leaves your machine
🌍 No install required Open the HTML file or visit the GitHub Pages link

πŸš€ Usage

Option 1 β€” GitHub Pages (Recommended)

Visit the live site directly:

https://anonymous-201.github.io/zipbomb/

Option 2 β€” Run Locally

# Clone the repository
git clone https://github.com/anonymous-201/zipbomb.git

# Open in browser
cd zipbomb
open index.html        # macOS
start index.html       # Windows
xdg-open index.html    # Linux

How to Use

  1. Enter ZIP File Name β€” type your desired output filename (e.g. bomb)
  2. Enter Unzipped Size β€” type a number (e.g. 10)
  3. Select Unit β€” choose from B, KB, MB, GB, TB, or PB
  4. Click Generate & Download
  5. The .zip file downloads automatically to your machine

πŸ“‚ Project Structure

zipbomb/
β”œβ”€β”€ index.html       # Main tool β€” fully self-contained, no build step
β”œβ”€β”€ README.md        # Project documentation
β”œβ”€β”€ LICENSE          # MIT License
└── preview.png      # Screenshot for social previews (optional)

βš™οΈ How It Works

User Input (size + filename)
        β”‚
        β–Ό
Uint8Array of null bytes (\x00) created in browser memory
        β”‚
        β–Ό
JSZip compresses with DEFLATE level 9
        β”‚
        β–Ό
Blob URL generated β†’ <a> tag triggered β†’ ZIP downloaded
  • Small sizes (B/KB/MB/GB ≀ 2GB): Allocates exact byte count in memory, compresses to a single file.
  • Large sizes (TB/PB or GB > 2GB): Uses a 50 MB base block repeated across multiple archive entries to stay within browser memory limits while reporting the full virtual size.

🀝 Contributing

Contributions, issues, and feature requests are welcome!

  1. Fork the repo
  2. Create your branch: git checkout -b feature/my-feature
  3. Commit your changes: git commit -m 'Add my feature'
  4. Push to the branch: git push origin feature/my-feature
  5. Open a Pull Request

Ideas for Contributions

  • Add a progress bar for large file generation
  • Support nested/recursive ZIP layers
  • Dark/light theme toggle
  • Add compression ratio display
  • PWA support (offline use)

πŸ›‘οΈ Ethical Use Cases

  • βœ… Testing antivirus and endpoint protection software
  • βœ… Auditing file upload handlers for decompression bomb vulnerabilities
  • βœ… Security research and CTF challenges
  • βœ… Learning about DEFLATE and compression internals
  • βœ… Penetration testing (with authorization)
  • ❌ Attacking systems without permission β€” strictly prohibited

πŸ“œ License

This project is licensed under the MIT License β€” see LICENSE for details.

MIT License β€” Copyright (c) 2025 anonymous-201
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software to use, copy, modify, merge, and distribute it, subject to
the conditions in the LICENSE file.

πŸ‘€ Author

anonymous-201


Made with πŸ’€ for the open-source security research community.

⭐ If this was useful, please star the repo!

Star History

About

πŸ’£ Browser-based ZIP bomb generator β€” create DEFLATE-compressed decompression bombs up to petabytes. For security research & AV testing only.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages