_   __ _____ __   __  ___   _   _  _____         ______ ______   ___  ___  ___ _____  _    _  _____ ______  _   __
| | / /|  _  |\ \ / / / _ \ | \ | ||  ___|        |  ___|| ___ \ / _ \ |  \/  ||  ___|| |  | ||  _  || ___ \| | / /
| |/ / | | | | \ 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.

• golang >= 1.25.0
• make

Debian, Ubuntu:

sudo apt update
sudo apt install build-essential golang-go

• 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-beta

you can use the auto_install.sh for installing

chmod +x auto_install.sh
sudo ./auto_install.sh

or install manually with make

make build
sudo make install
make clean

Go to the project directory where the Makefile is located and run:

sudo make uninstall koyane-framework

You can install the deprecated build directly with pip:

pip install koyaneframework

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).
• extraction passwords from hashcat potfiles
• support for string permutation

• 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

kyfgen -M !AS?l?l?l?lL?d?d?! -o ~/MyList.txt

kyfinfo --all ~/MyList.txt
kyfedit -r 8:* --european ~/MyList.txt ~/EditList.txt

kyfdb search --biggest-word 8:14 --smallest-word 8:8 --digits-perc 30.0:*

kyfdb show 22

kyfdb 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.