xkcdpass(1)

πŸ“¦
version 1.30.0 Β· 4 versions
, in arch rolling, nixos 26.05, nixpkgs unstable

πŸ’– xkcdpass β€” the iconic passphrase generator πŸ’–

okay so this is the xkcdpass(1) page from the General Commands Manual, and bestie, it’s giving password-generator main character energy ✨

🌸 NAME 🌸

xkcdpass β€” generate memorable, secure multiword passphrases. literally the assignment, no cap πŸ’…

✨ SYNOPSIS ✨

run it like this:

xkcdpass [ options ]
xkcdpass --help

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so xkcdpass is a flexible and scriptable password generator which generates strong passphrases, inspired by XKCD 936:

$ xkcdpass
> correct horse battery staple

iconic. periodt. πŸ΄πŸ”‹πŸ“Ž

πŸŽ€ OPTIONS πŸŽ€

here’s the full menu, bestie β€” no skips, no summaries, fr fr:

  • --help β€” describes how to use this command. read it, bestie 🫢
  • --wordfile WORDFILE, -w WORDFILE β€” specify that the file WORDFILE contains the list of valid words from which to generate passphrases.
  • --min MIN_LENGTH β€” minimum number of letters required in words used to make password. (Default: 5)
  • --max MAX_LENGTH β€” maximum number of letters allowed in words used to make password. (Default: 9)
  • --numwords NUM_WORDS, -n NUM_WORDS β€” generate passphrases containing exactly NUM_WORDS words. (Default: 6)
  • --interactive, -i β€” generate and output a passphrase, query the user to accept it, and loop until one is accepted. it’s giving try-again energy πŸ”
  • --valid_chars VALID_CHARS, -v VALID_CHARS β€” limit passphrases to only include words matching the regex pattern VALID_CHARS (e.g. '[a-z]').
  • --verbose, -V β€” report various metrics for given options. numbers girlies rise ✨
  • --acrostic ACROSTIC, -a ACROSTIC β€” generate passphrases with an acrostic matching ACROSTIC. structured AND cute πŸŽ€
  • --count COUNT, -c COUNT β€” generate COUNT passphrases. (Default: 1)
  • --delimiter DELIM, -d DELIM β€” separate words within a passphrase with DELIM. (Default: ' ')
  • --separator SEP, -s SEP β€” separate generated passphrases with SEP. (Default: ' ')

πŸŽ€ EXAMPLES πŸŽ€

  • xkcdpass β€” generates one passphrase with the default options. Example output:
pinball previous deprive militancy bereaved numeric
  • xkcdpass --count=5 --acrostic='chaos' --delimiter='|' --min=5 --max=6 --valid_chars='[a-z]' β€” generates 5 passphrases, all from lower-case words and meeting the acrostic "chaos", delimited by the "|" character. Example output:
collar|highly|asset|ovoid|sultan
caper|hangup|addle|oboist|scroll
couple|honcho|abbot|obtain|simple
cutler|hotly|aortae|outset|stool
cradle|helot|axial|ordure|shale

πŸ“œ HISTORY πŸ“œ

the xkcdpass command invokes the Python program xkcd_password.py.

the inspiration for the program's purpose is the XKCD 936 "Password Strength" cartoon.

no cap, that’s the origin story πŸ¦‹


that’s the whole page, bestie β€” xkcdpass(1) from the General Commands Manual. there’s no extra source/version/date line in this copy, so this is the cute sign-off: stay memorable, stay secure, and slay those passphrases πŸ’…βœ¨

πŸ“¦ where this page comes from