I have just released v1.01 of my SingleWord Combiner. An interactive, terminal-based Python utility designed to filter, mutate, and expand baseline wordlists. It provides precise control over word lengths and applies combinations of numbers and special characters to generate highly tailored word permutations for security auditing and custom dictionary generation.

🐙 Download SingleWord Combiner#! v1.01 here

__________________________________________________________________________

Readme.md -

🛠️ SingleWord Combiner#!

An interactive, terminal-based Python utility designed to filter, mutate, and expand baseline wordlists. It provides precise control over word lengths and applies combinations of numbers and special characters to generate highly tailored word permutations for security auditing and custom dictionary generation.

📌 Features

Drag-and-Drop Path Support - Automatically cleans up raw paths, single quotes, or double quotes wrapped around files when dragging files directly into the terminal window.
Flexible Length Filtering - Extract target base words using exact matches, comma-separated lists, numeric ranges (e.g., 6-9), or process the entire list at once.
Smart Numeric Appends - Generate multi-digit sequential pools (from 1 to 4 digits) and attach them globally to either the front or the end of your base words.
Restricted Special Character Sets - Append custom symbol permutations using a targeted, safe character set (!@#$&*-) up to 4 characters deep.
Cross-Product Permutations - Uses optimized combinatorics via standard Python libraries to build exact combinatorial outputs without blowing up memory.

⚙️ How It Works

The script operates as a linear, interactive terminal wizard that walks you through six distinct phases:

[1. Load Wordlist] ➡️ [2. Filter Lengths] ➡️ [3. Inject Numbers] ➡️ [4. Inject Symbols] ➡️ [5. Set Output] ➡️ [6. Compute & Write]

🧠 Combinatorial Math Breakdown

When combining features, the script calculates permutations multiplicatively. For example:

1,000 base words filtered
3-digit numbers attached to the end (1,000 possible combinations)
2 special characters attached to the front (7² = 49 possible combinations)
Total unique permutations generated: 1,000 × 1,000 × 49 = 49,000,000 lines written to the output file.

🛠️ Prerequisites

The script runs out of the box using core Python libraries. No external pip installations are required.

Python 3.6 or higher
Standard modules used: os, string, itertools

🚀 Installation & Setup

Clone this repository to your local environment:

git clone https://github.com/mrvirginis/SingleWord_Combiner
cd SingleWord_Combiner

Verify your Python installation:
```
python --version
```
Run the tool:
```
python SingleWord_Combiner.py
```

📖 Usage Guide & Options

1. Filtering Target Word Lengths

When prompted for target word lengths, you can pass values in four different ways:

6 — Extracts only words exactly 6 characters long.
6,9,12 — Extracts words matching exactly 6, 9, or 12 characters.
6-9 — Extracts a comprehensive range of words between 6 and 9 characters inclusive.
all — Bypasses string filtering entirely and parses every non-empty line in the document.

2. Special Characters Map

The application restricts special character generation to standard high-frequency algorithmic values to minimize unneeded combinations:

!  @  #  $  &  *  -

📝 Example Output Session

=== Interactive Wordlist Customization Tool ===

Drag and drop your primary wordlist .txt file here and press Enter: /paths/rockyou.txt

Enter target word lengths. Options:
 • Single exact size: 6
 • Comma separated list: 6,9,12
 • Numeric range block: 6-9
 • Use all words regardless of size: all
Selection: 6-8

Reading file and extracting target words...
✅ Found 45,210 matching base words.

Do you want to add combinations of numbers to your words? (y/n): y
Add numbers to the 'front' or 'end' of the word?: end
Enter the total length of those numbers (1 to 4 digits): 2

Do you want to add combinations of special characters? (y/n): y
Add special characters to the 'front' or 'end' of the combo?: front
Enter the total length of special characters (1 to 4 characters): 1

Enter the name/path for your finished output file (e.g., custom_list.txt): custom_output.txt

Generating full combination list... Please wait...

=====================================
✨ Custom Generation Complete! ✨
📁 Target Output File: /paths/custom_output.txt
-------------------------------------
📊 Total permutations created: 31,647,000
=====================================

👤 Credits

Author: BlackzodiaK
Release Version: v1.01 (2026)
Official Blog: TheBlackZodiak.blogspot.com

📝 License

Distributed under the MIT License. Feel free to use, modify, and distribute this script for personal or professional security evaluations.