bin2pass(1)

📦
version 2.0.4 · 3 versions
, in nixos 26.05, nixpkgs unstable, ubuntu stonking

💖 bin2pass(1) — the manual, but make it cute 💖

okay bestie, so you know bin2pass(1)? yeah. the icon. it converts binary input to passwords. that's the whole vibe. let's get into it 🫶

✨ NAME ✨

bin2pass — converts binary input to passwords 💅

🌸 SYNOPSIS 🌸

bin2pass [d|u|l] [<max size>] [<symbols>] <binary

like. that's it. that's the whole entrance. slay.

🦋 DESCRIPTION 🦋

bin2pass takes binary input from standard input and turns it into human-readable passwords. no cap, that's literally its job. 😭✨

and listen, it accepts three optional parameters, and it uses the same syntax as sphinx(1), so if you already know that one you're already winning:

  • Character set — a combo of the letters uld, which turn on upper-case letters, lower-case letters, and digits respectively. if you don't say anything, it defaults to uld. 💖
  • Maximum length — sets the max password length. but bestie, heads up: if you ask for a length that's longer than what's actually possible from the input, the output gets padded with leading A characters. so like, you asked, you received, but with A's. 🙈 Defaults to the longest possible output from the input.
  • Symbol set — a string listing every symbol that's allowed in the password. the default symbol set includes:
| !"#$%&'()*+,-./:;<=>?@[\]^_`{}~
⚠️ note that spaces are allowed in the symbol set! but be careful to properly quote special characters your shell might try to interpret — things like ", !, and \. your shell is nosy and will absolutely try to touch them. 💀

🎀 EXAMPLES 🎀

okay so here's the moment. generating the longest possible random password from /dev/random, where the resulting password has characters from digits, lowercase and uppercase letters, and the space and * symbols:

dd if=/dev/random bs=1 count=32 | ./pwdsphinx/bin2pass.py " *"

iconic. ate. periodt. 👑

😤 REPORTING BUGS 😤

found something cursed? tell them here, fr fr:

https://github.com/stef/pwdsphinx/issues/

👑 AUTHOR 👑

Written by Stefan Marsiske 🫶

Copyright © 2023 Stefan Marsiske. License GPLv3+: GNU GPL version 3 or later https://gnu.org/licenses/gpl.html. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. (no warranty bestie, that's the deal 💀)

🌈 SEE ALSO 🌈

sphinx(1)

that's the whole page, you're welcome, go forth and password-ify 💜

bin2pass(1) — mwah, that's a wrap ✨🎀

📦 where this page comes from