https://github.com/hashcracky/brainstorm
Fast wordlist processor for cryptographic hash recovery.
https://github.com/hashcracky/brainstorm
cybersecurity-education hashcat hashcracking password
Last synced: 6 months ago
JSON representation
Fast wordlist processor for cryptographic hash recovery.
- Host: GitHub
- URL: https://github.com/hashcracky/brainstorm
- Owner: Hashcracky
- License: gpl-3.0
- Created: 2025-11-23T18:41:34.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-12-05T16:21:04.000Z (7 months ago)
- Last Synced: 2025-12-22T22:10:06.232Z (7 months ago)
- Topics: cybersecurity-education, hashcat, hashcracking, password
- Language: Go
- Homepage:
- Size: 27.3 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: docs/README.md
- License: LICENSE
Awesome Lists containing this project
README
# Brainstorm
Brainstorm is a focused text transformation tool designed to help generate and normalize candidate strings from raw text. It is particularly useful for tasks like wordlist creation, passphrase / token derivation, and transforming free-form text into structured candidate outputs.
`Brainstorm` is written in `Go`, is compatible with multiple platforms, and is designed to work well in Unix-style pipelines. It reads from standard input and writes transformed output to standard output.
> Brainstorm is intentionally minimal. It focuses on:
> - N‑gram generation from sentences.
> - Filtering noisy or non-word-like input.
> - Generating normalized, case-adjusted tokens with configurable length ranges.
## Features
- **Streaming stdin pipeline:** Reads from standard input and writes to standard output, making it easy to chain with other tools.
- **N‑gram Generation:** Generates n‑grams over a configurable word-length range.
- **Normalization & Cleanup:**
- Removes leading/trailing non-letter characters on each line.
- Filters out lines that are unlikely to contain meaningful words.
- Cleans common control and whitespace characters.
- **Case Transformations:**
- Generates title-cased concatenations (e.g., `"hello world"` → `"HelloWorld"`).
- **Parallel Processing:**
- Uses a worker pool to process lines concurrently.
### Install
From source with `go`:
```bash
go install github.com/hashcracky/brainstorm@latest
```
From `git` clone then build with `go`:
```bash
git clone https://github.com/hashcracky/brainstorm
cd brainstorm
go build ./main.go
mv ./main ~/go/bin/brainstorm
brainstorm
```
---
## Basic Usage
Brainstorm reads from standard input and writes to standard output. There are no positional arguments; all behavior is controlled via flags.
### Core Flags
- `-w string`
- N‑gram word-length range in the form `start-end`.
- Default: `1-5`
- `-l string`
- Final output length range in the form `min-max`.
- Default: `4-32`
Example:
```bash
cat source.txt | brainstorm -w 1-4 -l 6-20 > candidates.txt
```
### Full Flags
```bash
Usage of Brainstorm version (0.1.4):
input | brainstorm [options] > output
Accepts standard input and writes transformed output to standard output.
Options:
-l string
Final output length range in the form min-max (for example, 4-32). (default "4-32")
-unicode
Include non-Latin multi-byte letter sequences by relaxing Latin vowel heuristics.
-w string
N-gram word length range in the form start-end (for example, 1-5). (default "1-5")
```