stow/oh-my-zsh/.oh-my-zsh/plugins/genpass/README.md

   1 # genpass
   2
   3 This plugin provides three unique password generators for ZSH. Each generator
   4 has at least a 128-bit security margin and generates passwords from the
   5 cryptographically secure `/dev/urandom`. Each generator can also take an
   6 optional numeric argument to generate multiple passwords.
   7
   8 To use it from an interactive ZSH, add `genpass` to the plugins array in your
   9 zshrc file:
  10
  11     plugins=(... genpass)
  12
  13 You can also invoke password generators directly (they are implemented as
  14 standalone executable files), which can be handy when you need to generate
  15 passwords in a script:
  16
  17     ~/.oh-my-zsh/plugins/genpass/genpass-apple 3
  18
  19 ## genpass-apple
  20
  21 Generates a pronounceable pseudoword passphrase of the "cvccvc" consonant/vowel
  22 syntax, inspired by [Apple's iCloud Keychain password generator][1]. Each
  23 password has exactly 1 digit placed at the edge of a "word" and exactly 1
  24 capital letter to satisfy most password security requirements.
  25
  26     % genpass-apple
  27     gelcyv-foqtam-fotqoh-viMleb-lexduv-6ixfuk
  28
  29     % genpass-apple 3
  30     japvyz-qyjti4-kajrod-nubxaW-hukkan-dijcaf
  31     vydpig-fucnul-3ukpog-voggom-zygNad-jepgad
  32     zocmez-byznis-hegTaj-jecdyq-qiqmiq-5enwom
  33
  34 [1]: https://developer.apple.com/password-rules/
  35
  36 ## genpass-monkey
  37
  38 Generates visually unambiguous random meaningless strings using [Crockford's
  39 base32][2].
  40
  41     % genpass-monkey
  42     xt7gn976e7jj3fstgpy27330x3
  43
  44     % genpass-monkey 3
  45     n1qqwtzgejwgqve9yzf2gxvx4m
  46     r2n3f5s6vbqs2yx7xjnmahqewy
  47     296w9y9rts3p5r9yay0raek8e5
  48
  49 [2]: https://www.crockford.com/base32.html
  50
  51 ## genpass-xkcd
  52
  53 Generates passphrases from `/usr/share/dict/words` inspired by the [famous (and
  54 slightly misleading) XKCD comic][3]. Each passphrase is prepended with a digit
  55 showing the number of words in the passphrase to adhere to password security
  56 requirements that require digits. Each word is 6 characters or less.
  57
  58     % genpass-xkcd
  59     9-eaten-Slav-rife-aired-hill-cordon-splits-welsh-napes
  60
  61     % genpass-xkcd 3
  62     9-worker-Vlad-horde-shrubs-smite-thwart-paw-alters-prawns
  63     9-tutors-stink-rhythm-junk-snappy-hooray-barbs-mewl-clomp
  64     9-vital-escape-Angkor-Huff-wet-Mayra-abbés-putts-guzzle
  65
  66 [3]: https://xkcd.com/936/