_ __ _____ __ __ ___ _ _ _____ ______ ______ ___ ___ ___ _____ _ _ _____ ______ _ __
| | / /| _ |\ \ / / / _ \ | \ | || ___| | ___|| ___ \ / _ \ | \/ || ___|| | | || _ || ___ \| | / /
| |/ / | | | | \ V / / /_\ \| \| || |__ ______ | |_ | |_/ // /_\ \| . . || |__ | | | || | | || |_/ /| |/ /
| \ | | | | \ / | _ || . ` || __| |______|| _| | / | _ || |\/| || __| | |/\| || | | || / | \
| |\ \\ \_/ / | | | | | || |\ || |___ | | | |\ \ | | | || | | || |___ \ /\ /\ \_/ /| |\ \ | |\ \
\_| \_/ \___/ \_/ \_| |_/\_| \_/\____/ \_| \_| \_|\_| |_/\_| |_/\____/ \/ \/ \___/ \_| \_|\_| \_/
Koyane-Framework :: wordlist forge & analysis toolkit
made by Puppetm4ster
Koyane is a modular framework for generating, editing, finding, and analyzing wordlists, designed for password cracking and ethical security testing.
The project is named after Ame-no-Koyane, a kami (deity) in Japanese mythology associated with structure, ritual, and the power of words.
The installation has only been tested on Linux operating systems so far. Due to the program's path handling, it will probably not be able to run on Windows. Future versions are also planned to be compatible with Windows.
Debian, Ubuntu:
sudo apt update
sudo apt install build-essential- Other used go libs are automatically downloaded from the source code during compilation.
Download the last version -> unzip the directory -> go into program directory:
wget https://gitlab.com/puppetm4ster/koyane-framework/-/archive/0.7.0-beta/koyane-framework-0.7.0-beta.zip?ref_type=tags
unzip koyane-framework-0.7.0-beta.zip\?ref_type\=tags
cd koyane-framework-0.7.0-betayou can use the auto_install.sh for installing
sudo chmod +x auto_install.sh
sudo ./auto_install.shor install manually with make
make build
sudo make install
make cleanGo to the project directory where the Makefile is located and run:
sudo make uninstall koyane-frameworkYou can install the deprecated build directly with pip:
pip install koyaneframeworkThe project is in a early stage of development. Functionality is limited and subject to change. This is my very first bigger coding project so i am grateful for every improvement suggestion at puppetma4ster@proton.me I try to update the project once a week.
The program serves as a helpful framework for developing, editing, analyzing, and finding word lists for password hash analysis, directory discovery, web fuzzing, and much more. The following features are listed per module:
- support for mask-based generation with multiple wildcards using ?d (digits) and fixed character segments using ! (e.g. !A for 'A', !abc123 for custom sets).
- wordlist sorting
- remove words by length
- remove words who match a mask
- remove words containing given characters
- filter all words that are not in european chars
- analyze basic word list info
- line count
- word length statistics
- complexity metrics
- char statistics and frequency
- search and filter stats from outer word lists
- download them from terminal
- CLI interface
- Basic status messages
Not yet implemented:
- Deduplication and merging
- TUI or rich CLI frontend
- Contextual generation based on target information (name, location, job, hobbies, birthday...)
- extract and build rules out of wordlists
- console version
Koyane aims to become a fast, modular, and scriptable framework for:
- Wordlist generation using rules, masks, templates, and personal context
- Large-scale list manipulation and cleanup
- Format conversion and statistical inspection
- Efficient pipelines for password audit and red team workflows
koyane-framework [command] flags(s)
koyane-framework generate -M !AS?l?l?l?lL?d?d?! ~/MyList
koyane-framework edit -r 8:* --european ~/MyList ~/EditList
koyane-framework search --biggest-word 8:14 --smallest-word 8:8 --digits-perc 30.0:*
koyane-framework show 22
koyane-framework get -p ~/OuterList 22
This project is licensed under the Apache License 2.0.
You may use, modify, and distribute it freely, provided you include proper attribution and preserve this license.
See the full license text in the LICENSE file.
Koyane is intended for educational purposes and authorized security testing only.
The author strictly opposes any misuse of this tool for illegal, unethical, or oppressive purposes.
Use responsibly. Break rules, not laws.
This software may not be used by government surveillance agencies, intelligence services, or law enforcement bodies without explicit and provable ethical clearance.
Any use for mass surveillance, targeted repression, or covert intelligence operations is explicitly forbidden by the author.