ZipCrack

KO | EN

gitlite — search

#javascript #python #hacktoberfest #golang #go #machine-learning #rust #deep-learning #macos #awesome #cli #kubernetes #vue #pytorch

(★ 110)

Crack password protected zip files

File Explorer

Download Latest Version (.zip)

- FUNDING.yml
go.mod
go.sum
LICENSE
README.md
ZipCrack.go
ZipCrack_test.go

# Installation Guide

1. Get the code

git clone https://github.com/henriksb/ZipCrack

Downloads the entire project code from GitHub to your computer.

cd ZipCrack

Moves into the project folder you just downloaded.

2. Go

Medium Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Go The Go compiler and toolchain.

go build -o zipcrack .

Compiles the Go program into an executable.

✅ If the build finishes without errors, it worked. If you used go run ., check the terminal output.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ZipCrack

ZipCrack is a fast command-line tool for recovering passwords from encrypted ZIP archives. It works entirely in-process (no calls out to 7-Zip/WinRAR), supports **dictionary** and **brute-force** attacks, and understands both traditional **ZipCrypto** and **WinZip AES** encryption.

## Features

- **In-memory verification** — the encrypted entry is loaded once; passwords are tested without reopening the archive
- **Fast ZipCrypto filter** — 12-byte encryption-header check rejects ~255/256 wrong passwords before inflate/CRC
- **Fast AES path** — PBKDF2 password-verification value + HMAC confirmation
- **Dictionary & brute-force** modes (hashcat-style flags)
- **stdin wordlists**, progress with rate/ETA, configurable worker threads
- Pipe-friendly: password on **stdout**, status on **stderr**

## Usage

```
zipcrack -m <mode> -z <file.zip> [options]

Attack modes:
  0  dictionary   try passwords from a wordlist file (or stdin)
  1  brute-force  try all combinations from a character set

Options:
  -m, --attack-mode INT       Attack mode: 0=dictionary, 1=brute-force (required)
  -z, --zip FILE              Target ZIP file (required)
  -w, --wordlist FILE         Wordlist file for mode 0 (use "-" for stdin)
  -1, --custom-charset STR    Custom characters to include (mode 1)
      --increment-min INT     Minimum password length [default: 1]
      --increment-max INT     Maximum password length [default: 6]
  -t, --threads INT           Worker threads [default: NumCPU]
  -q, --quiet                 Suppress progress output
  -v, --version               Print version and exit
  -h, --help                  Show this help

Charset shortcuts (mode 1, combinable with --custom-charset):
  -a   lowercase a-z
  -A   uppercase A-Z
  -d   digits 0-9
  -s   special characters
```

### Examples

```bash
# Dictionary attack
zipcrack -m 0 -z vault.zip -w rockyou.txt

# Dictionary from stdin
cat words.txt | zipcrack -m 0 -z vault.zip -w -

# Brute-force lowercase + digits, length 4–6
zipcrack -m 1 -z vault.zip -a -d --increment-min 4 --increment-max 6

# Custom charset, 16 threads
zipcrack -m 1 -z vault.zip --custom-charset "abc123!" --increment-max 4 -t 16
```

### Exit codes

| Code | Meaning                            |
|------|------------------------------------|
| 0    | Password found (printed on stdout) |
| 1    | Password not found                 |
| 2    | Error (bad args, I/O, invalid zip) |

## Build

```bash
go build -o zipcrack .
```

Requires Go 1.21+.

```bash
go test ./...
```

## Downloads

[Download pre-compiled version 3 Linux](https://github.com/henriksb/ZipCrack/releases/download/3.0/ZipCrack)

Currently no available binaries for other operating systems, so you'll have to compile it yourself.

Version 2 was tested and estimated to be about 88% faster than version 1.  
Version 3 avoids per-attempt archive I/O and adds early-reject crypto checks for a large additional speedup on ZipCrypto targets.

## License

MIT — see [LICENSE](LICENSE).

ZipCrack

File Explorer

# Installation Guide

2. Go

Today's picks

Was this content helpful?

Recent Feedback

ZipCrack

File Explorer

# Installation Guide

2. Go

Today's picks

Was this content helpful?

Recent Feedback

Download README