explaingit

landgrey/pydictor

Analysis updated 2026-05-18

3,626PythonAudience · ops devopsComplexity · 2/5LicenseSetup · easy

TLDR

A command-line tool that builds custom password wordlists for authorized security testing, with merging, filtering, and encoding utilities.

Mindmap

mindmap
  root((pydictor))
    Generation modes
      Character combinations
      Custom patterns
      Personal info based
      Social engineering scraping
    Utilities
      Merge lists
      Remove duplicates
      Filter by length
      Encode entries
    Use cases
      Authorized password testing
      Weak credential audits
    Tech stack
      Python
      Cross platform CLI

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate wordlists from character combinations or custom patterns for authorized password testing.

USE CASE 2

Build a targeted wordlist from a person's known birthdays or personal details.

USE CASE 3

Merge and deduplicate multiple existing wordlists into one.

USE CASE 4

Encode a wordlist with base64 or MD5 to match how a target system stores passwords.

What is it built with?

Python

How does it compare?

landgrey/pydictorgeex-arts/django-jethkuds/paper2slides
Stars3,6263,6273,625
LanguagePythonPythonPython
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audienceops devopsdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Runs on Windows, Linux, and Mac with Python 2.7 or 3, no external infra needed.

GPLv3: you can use and modify the code, but any derivative software you distribute must also be open source under GPLv3.

In plain English

Pydictor is a Python command-line tool that generates large lists of candidate passwords, known as wordlists, for use in security testing. When a security professional needs to test whether an account or system is protected by a weak password, they often run automated attempts against it using a prepared list of guesses. Pydictor helps build those lists. The tool supports several approaches to wordlist generation. You can generate lists based on simple character combinations, define patterns, or create lists derived from personal information like birthdays, which people commonly use in passwords. There is also a social engineering mode that builds lists based on information scraped from web pages, since people often choose passwords related to their own names, organizations, or interests. The README includes a legal disclaimer stating the tool is for authorized testing only. Beyond generating raw lists, the tool includes utilities for processing them: merging multiple lists, removing duplicates, counting how often certain words appear, filtering by length or character type, and applying encodings like base64 or MD5 hashing to each entry. This matters because some systems store or transmit passwords in encoded forms, so a security test may need to submit the encoded version rather than the plain text. It runs on Windows, Linux, and Mac, and supports both Python 2.7 and Python 3. The project is licensed under GPLv3 and includes API documentation for developers who want to extend it with their own plugins or encoding scripts.

Copy-paste prompts

Prompt 1
Explain how to generate a password wordlist from a birthdate pattern using pydictor.
Prompt 2
Show me how to merge and deduplicate two wordlists with pydictor's utilities.
Prompt 3
Walk me through pydictor's social engineering mode for building a wordlist from a webpage.
Prompt 4
How do I apply MD5 encoding to every entry in a generated wordlist?

Frequently asked questions

What is pydictor?

A command-line tool that builds custom password wordlists for authorized security testing, with merging, filtering, and encoding utilities.

What language is pydictor written in?

Mainly Python. The stack also includes Python.

What license does pydictor use?

GPLv3: you can use and modify the code, but any derivative software you distribute must also be open source under GPLv3.

How hard is pydictor to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is pydictor for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.