xpg 0.12.0

xkcd-style password generator
Documentation

About

xkcd-style password generator

xkcd #936: Password Strength

Usage

$ xpg -h
xpg 0.12.0 <https://crates.io/crates/xpg>

xkcd-style password generator

Usage: xpg [OPTIONS] [PATTERNS]...

Arguments:
  [PATTERNS]...  Pattern(s) (see note 1) [default: `wwww`, `-L`: `{a}`]

Options:
  -c, --count <NUMBER>     Number of passwords (0:∞ ) [default: 1]
  -l, --length <NUMBER>    Length
  -m, --minimum <NUMBER>   Minimum length
  -M, --maximum <NUMBER>   Maximum length
  -a, --attempts <NUMBER>  Attempts [default: 10]
  -C, --config <PATH>      Configuration file
  -e, --extended           Merge extended words (see note 2)
  -L, --list               List words in `{sub}`(s)
  -d, --dump-config        Print configuration
  -r, --readme             Print readme
  -h, --help               Print help
  -V, --version            Print version

---

Notes

1. Patterns
    * Words
        * `W`: WORD
        * `w`: word
        * `T`: Word
        * `k`: `shuffle(cccc(c|d)(C|c))`
        * `{sub}`: see `WordKind`s section in readme
    * Characters
        * `C`: A-Z
        * `c`: a-z
        * `d`: 0-9
        * `s`: `~!@#$%^&*-_=+;:,./?()[]{}<>`
        * `a`: `C` | `c` | `d` | `s`
    * Special
        * `keychain`
        * `codename`
        * `codename-series`
        * `haiku`
        * `haiku+`
        * `haiku-`
        * `haiku--`
        * `haiku++`
        * `haiku+++`

2. By default, extended words are only available in exclusively extended word
   kinds; however, with `-e`, they are merged with regular word kinds; use with
   the `-L` option to see its effect.

$ xpg -V
xpg 0.12.0

See also the Configuration section below.

Examples

$ xpg
compoundmethodbecomeridden

Generate 10 passwords

$ xpg -c 10
backguardhalfshoulder
cleardictionaryorderfifth
asiasurfacewhatjoin
tradedemandjamaicaleast
sidemoonroundfortieth
quicklydemandminemaybe
trueseparatemothermercury
delawaremailkissindustry
hoursanswerlivevalue
blueevershareworth

Generate passwords forever

or until Ctrl+C / SIGINT

$ xpg -c 0
serveseparatemovementbeside
foundstrongfieldthousands
everythingraisedconditioncity
suffixsolutionsignhard
soilpointroundberlin
tripwhetheranimalinformation
buildcoursebetweeneach
behinddecimalriddenlaughter
visitearsactionsell
healthwomenmexicoescape
^C

Generate a password with 8 words

$ xpg wwwwwwww
poembusinesspowersoftcomparesurfacenetherlandswhile

Generate 10 passwords with 8 words

$ xpg wwwwwwww -c 10
pagetreeyourdrawingregionarrivedsongchoose
australiaathenseveningoutsidecharacterwhererockexperience
detailsbookjoinmarsthemcausepointscale
withinstationsharetallthousandsbelievemightinches
glassprettyresentearscolumnpullstationhowever
worktestinsideenergycottonenoughfourfriend
plainduskwhenclasscollegearmyinstrumentshard
happybesidequicklywomanfractionschoolrollalmost
reacheddrinkprovesaturndelawarecloudbrightsuppose
electricityfriendseasyoslofoolgalaxybusyvowel

Generate a password with 2 words followed by 3 digits

$ xpg wwddd
informationaway761

Generate a password with 2 words followed by 2 symbols

$ xpg wwss
signalworkers!}

Generate a password with 2 words followed by a digit and a symbol

$ xpg wwds
centuryresult8>

Generate a password with 4 words followed by 2 lowercase letters

$ xpg wwwwcc
fromarticlelookcenturyvz

Generate a password with 4 words followed by 2 uppercase letters

$ xpg wwwwCC
learnthirdhonorfifteenCB

Generate a password with 4 title case words

$ xpg TTTT
GreekPushArmsNeighbor

Generate a password with 4 uppercase words

$ xpg WWWW
SPACERESTNECESSARYFEELING

Generate a password with 4 words followed by 5 "any" characters

An "any" character can be a lowercase letter, uppercase letter, digit, or symbol.

$ xpg wwwwaaaaa
galaxythemselvesresenthealth.,_3j

Generate a password with 3 words and at least 15 characters

$ xpg www -m 15
kitchenthereforemore

Generate a password with 3 words and no more than 20 characters

$ xpg www -M 20
roadmostwhat

Generate a password with 4 words and between 20 and 25 characters

Increase attempts to help it succeed.

$ xpg www -m 20 -M 25 -a 1000
markquestionshistory

Generate a password with 2 words, 3 digits, 1 symbol, and exactly 16 characters

Increase attempts to help it succeed.

$ xpg wwddds -l 16 -a 1000
sisterspring557%

Generate a password with a 1, 2 title case words, and !

$ xpg '1TT!'
1SurfaceMeeting!

Generate a password with 1 symbol, 2 adjectives, 1 noun, and 2 digits

$ xpg 's{adj}{adj}{n}dd'
~japanesenorthinch62

Generate a password with 2 words and 1 extended word

$ xpg 'ww{ext}'
chairwarsawarkansas

Generate a password with 2 words and 1 title case extended word

$ xpg 'ww{T:ext}'
hourscreatePraxidike

Generate a password with 2 words and 1 uppercase extended word

$ xpg 'ww{W:ext}'
kindballEURYDOME

Generate 10 passwords with 4 title case words and extended words merged

$ xpg -ec 10 TTTT
PassedSinopeCookMeat
ThinDinnerClothesShout
ChangeSweetForeignOffice
OxygenTogetherSummerMadrid
BackRuleMustLight
RestMaybePennsylvaniaSpecial
WorkersFloridaBackNorthamerica
DutyFractionButterWant
ShoutNeverPleasantWide
NextPlaneProblemExactly

Generate a keychain-style password

$ xpg keychain
ceg0sb-Pfhnbe-gaaikq

Generate a code name

$ xpg codename
HALF COUNTRY

Generate a code name series

$ xpg codename-series
PARTICULARPERIOD BASEOBJECT
PARTICULARPERIOD EIGHTLAND
PARTICULARPERIOD LARGEDINNER
PARTICULARPERIOD LOWERBABY
PARTICULARPERIOD NICESHOW
PARTICULARPERIOD FUTURESYSTEM
PARTICULARPERIOD PARTIALDARE
PARTICULARPERIOD SUCHMOUTH
PARTICULARPERIOD FINALLYMONDAY
PARTICULARPERIOD TWENTYPRODUCE

Generate a code name series with 20 code names

$ xpg codename-series -c 20
REALLYFIND EIGHTORDER
REALLYFIND WRITTENTHOUSANDS
REALLYFIND USUALLYSYSTEM
REALLYFIND PARTIALSIGN
REALLYFIND ALONEGLASS
REALLYFIND BUILTWHEAT
REALLYFIND WIDEBABY
REALLYFIND MODERNTASTE
REALLYFIND BASEGRAY
REALLYFIND LIKELYMETHOD
REALLYFIND DAILYMOUTH
REALLYFIND ANOTHERPASS
REALLYFIND MOREHURT
REALLYFIND WHOLESHAPE
REALLYFIND QUITETRIES
REALLYFIND THISPART
REALLYFIND CLEARCROPS
REALLYFIND ABOUTPLAINS
REALLYFIND SOUTHERNBICYCLE
REALLYFIND YOUNGEARS

Generate a haiku

$ xpg haiku
Temperature sleep / Animal necessary / Report part grave tree

Generate a haiku with syllable pattern

$ xpg haiku+
Electricity (5) / Presidents right write around (3,1,1,2) / Free nature farmers (1,2,2)

Generate a condensed haiku with syllable pattern

$ xpg haiku-
Holland-opposite(2,3)/Electricity-although(5,2)/What-ridden-gather(1,2,2)

Generate a condensed haiku

$ xpg haiku--
Melody-inches/England-article-yellow/Considerable

Generate a haiku with newlines

$ xpg haiku++
Electricity
Considerable open
Desire root twenty

Generate a haiku with syllable pattern and newlines

$ xpg haiku+++
They section within (1,2,2)
Dictionary might afraid (4,1,2)
Insects steel food strange (2,1,1,1)

Generate a haiku with extended words

$ xpg -e haiku
Orthosie storm / Bone opposite Malta does / Louisiana

Generate a password with 20 "any" characters

$ xpg aaaaaaaaaaaaaaaaaaaa
j@BeIsvDLoGySARx:pLC

Same as the previous example, but shorter

This works because a character-only pattern is padded to the minimum length with the last character.

$ xpg a -m 20
jrtrDmv>opSWSq/=1(:k

Generate 3 passwords each from a different pattern

$ xpg wwww WWWW TTTT
coolsomethingmoleculeshello
WILDJUPITERVALUESTRANGER
KilledBeingRoundSlow

Generate a password with words with 1, 2, 3, 4, and 5 syllables

$ xpg '{a:1}-{W:a:2}-{T:a:3}-{olympian:4}-{T:ext:5}'
block-SILVER-Cigarette-dionysus-Northcarolina

List the words in Color / {color}

$ xpg -L '{color}'
black
blue
brown
gray
green
white
yellow

List the words in Color / {color} in uppercase

$ xpg -L '{W:color}'
BLACK
BLUE
BROWN
GRAY
GREEN
WHITE
YELLOW

List the words in Color / {color} in title case

$ xpg -L '{T:color}'
Black
Blue
Brown
Gray
Green
White
Yellow

Count the words in Color / {color}

$ xpg -L '{color}' |wc -l
7

List the words in Color / {color} and Element / {W:el}

$ xpg -L '{color}' '{W:el}'
black
blue
brown
gray
green
white
yellow
GOLD
IRON
LEAD
MERCURY
OXYGEN
SILVER

Count words

$ xpg -L |wc -l
1257

Count words with extended

$ xpg -Le |wc -l
1401

Configuration

See config.json or use -d for the default configuration compiled into the binary executable.

If another file is placed at any of the following locations or the path provided via the -C option at runtime, it will be used instead.

  • Linux: /home/username/.config/xpg/config.json
  • Windows: C:\Users\username\AppData\Roaming\qtfkwk\xpg\config\config.json
  • macOS: /Users/username/Library/Application Support/com.qtfkwk.xpg/config.json

WordKinds

  • AllExtended / {a.ext}
    • All / {a}
      • Adjective / {adj}
        • Color* / {color}
        • Nationality / {nat}
      • Adverb / {adv}
      • Conjunction / {conj}
      • Interjection / {i}
      • Noun / {n}
        • PluralNoun / {n.pl}
        • Pronoun / {n.pro}
        • SingularNoun / {n.s}
          • Astronomy / {ast}
            • Moon / {moon}
            • Planet / {planet}
          • Color* / {color}
          • Day / {day}
          • Month / {mon}
          • ProperNoun / {n.prop}
            • Element / {el}
            • Name / {name}
              • FemaleName / {fname}
              • MaleName / {mname}
            • Place / {place}
              • City / {city}
              • Continent / {cont}
              • Country / {country}
              • UsState / {us-state}
            • Mythology / {myth}
              • GreekMyth / {greekmyth}
                • Olympian / {olympian}
                • Chthonic / {chthonic}
              • RomanMyth / {romanmyth}
      • Preposition / {prep}
      • Verb / {v}
        • AuxiliaryVerb / {v.aux}
        • IntransitiveVerb / {v.int}
        • TransitiveVerb / {v.tr}
        • VerbPast / {v.past}
    • Extended / {ext}
      • Noun / {n}
        • SingularNoun / {n.s}
          • Astronomy / {ast}
            • Moon / {moon}
              • MarsMoon / {marsmoon}
              • JupiterMoon / {jupitermoon}
              • SaturnMoon / {saturnmoon}
              • UranusMoon / {uranusmoon}
              • NeptuneMoon / {neptunemoon}

Notes

  1. WordKind / {sub}

  2. It is only necessary to set the most descriptive WordKind(s) since they are automatically included in the larger word kinds.

  3. The characters object value must contain the C, c, and d keys with non-empty values. Additional keys/values can be added and used.

  4. {sub}s produce lowercase words by default, but if prefixed with W: or T: words will be uppercase or title case, respectively: i.e. {W:sub} or {T:sub} (replace sub with an actual {sub} name above).

  5. {sub}s include all words by default, but if suffixed with :N where N is a number, it will only include words with that number of syllables: i.e. {sub:N} (replace sub with an actual {sub} name above and N with the desired number of syllables ~1-5).

Changelog

  • 0.1.0 (2019-09-08): store wordlist as constant and operate on it without copying; select N words without repetition via choose_multiple; tests; benchmark various implementations; xpg function; xpg! macro to enable optional word count argument; command line interface via clap
  • 0.1.1 (2019-09-08): minor fixes
  • 0.1.2 (2019-09-08): minor fixes
  • 0.2.0 (2019-09-09): expose xpg! macro; improve documentation
  • 0.3.0 (2022-10-01): update dependencies; add digits and symbols options
  • 0.3.1 (2022-10-01): fix readme
  • 0.4.0 (2022-10-02): add --lowercase, --uppercase, and --any options; enable --words option to be zero if --any option is greater than zero; enable infinite passwords via -c 0
  • 0.5.0 (2022-10-13): add --keychain and --code-name options
  • 0.6.0 (2023-11-22): remove num and factorial crate dependencies; improve permutations function; update dependencies; apply clippy fixes and cargo fmt; reorganize
  • 0.6.1 (2023-11-22): fix readme
  • 0.7.0 (2023-11-24): complete redesign
  • 0.8.0 (2023-11-25): remove benchmark; simplify cli options; add -r and -C options; restore -c 0 functionality; add codename-series special pattern; add word kind subpatterns; enable external runtime configuration via new Config struct
  • 0.8.1 (2023-11-25): fix -C option
  • 0.9.0 (2023-11-26): add extended words; enable multiple patterns; add -e and -L options; make -d dump the loaded not default configuration
  • 0.10.0 (2023-11-27): add syllables and haiku* special patterns; fix the codename series algorithm; make olympian/chthonic kinds extended; update dependencies
  • 0.11.0 (2023-11-28): add bat pager on *nix
  • 0.12.0 (2023-11-29): fix haiku algorithm; updated dependencies

References