README.md

voldemot

voldemot takes a set of letters (such as a name) and assembles combinations of words based on it.

It uses the English word list from SCOWL.

Try a live demo at urra.ca!

Dat link: dat://f5b4ee786d09f17b271a3cb11fc02edc937dca9bcdea3a1316fe380d47f320ae/voldemot/

Web Interfaces

• The web_client version relies on a WebSockets server running on port 9000 (see voldemot_server.py).

• The static_web_client version is built with vanilla JavaScript, and is peer-to-peer friendly!

Command Line Interface

Requirements

• Python >= 3.6
• WebSockets library (only needed for the web interface server)

Usage

python voldemot.py [-h] [-d DICTIONARY] [-c COUNT] [-v] [-p] [-o [OUTPUT]] input

input
the letters to de-scramble

-h, --help
show this help message and exit

-d DICTIONARY, --dictionary DICTIONARY
dictionary file: newline must separate all words
default: words/voldemot.dict.txt

-c COUNT, --count COUNT
number of words to split the letters into
default: 2

-v, --verbose
show progress

-p, --print
print results

-o, --output [OUTPUT]
print results to file
default: voldemot.txt

Example

$ python voldemot.py "tom marvolo riddle" -c 3 -v -o marvolo.txt
Input (tommarvoloriddle) has 16 characters
Found 862 words.
 |██████████████████████████████████████████████████| 100.0%
10.37 seconds elapsed, there are 430 full matches.
Saving results to marvolo.txt...done.

$ head marvolo.txt
a milord voldemort
admired toll vroom
admit mod rollover
admit mol overlord
admit roll vroomed
admit rolled vroom
advert loom milord
advil dorm tremolo
advil dormer molto
advil drool mortem