keyart(1)

💖 hey bestie, you found the keyart(1) page 💖

It lives in the General Commands Manual, and it is so much fun. Grab a snack, we're making ASCII art out of OpenPGP keys and it's gonna be iconic. 🎀

✨ NAME ✨

keyart — create ASCII art of an OpenPGP key. That's it, that's the whole job, and she does it beautifully. 🦋

🌸 SYNOPSIS 🌸

keyart [-c|--color] [-l|--longid] [-f|--fingerprint HEX
[-f|--fingerprint HEX ...]]  [-k|--keyring KEYRING [-k|--keyring KEYRING
...]]  [KEYID ...]

👑 DESCRIPTION 👑

okay so here's the tea: keyart creates an ASCII art representation of public OpenPGP keys. The art is an implementation of the Drunken Bishop by Dirk Loss. 📖 If you wanna read up on the algorithm (and honestly, main character behavior), the documentation can be found in /usr/share/doc/signing-party/keyart/, or wherever is appropriate for your distribution. iykyk.

keyart supports printing the ASCII art in both plain text (that's the default, bestie) and ANSI color. The ANSI color mode uses a "heat map" — cold (blue) represents squares in the room the drunk bishop has rarely visited, and hot (red) represents squares in the room the drunk bishop has frequently visited. 🥵 And the way that there's a 1:1 ratio of color to printed character? Obsessed. Literally one color per one printed character, no notes.

The KEYIDs are key identifiers — fingerprint, keyid, user ID, etc. (see gpg(1) for details, she explains it better than me). If no KEYID is given, keyart creates an ASCII art representation for all keys found. Go off, queen. 👑

💅 OPTIONS 💅

• -c | --color — print the ASCII art using ANSI color to the terminal. That's the glow-up mode. 🌈
• -l | --longid — print the 16-character long ID of an OpenPGP key in the footer badge. Default is to print the 8-character short ID. Silently ignored if -f | --fingerprint HEX is passed. (not her ignoring you like that 💀)
• -f | --fingerprint HEX — any arbitrary hexadecimal string of any length. Could be an MD5, SHA1, SHA2, or SHA3 hexadecimal checksum. Useful for comparing and analyzing potential collisions with existing keys. This option can be repeated multiple times. 🔁
• -k | --keyring KEYRING — an OpenPGP public key file or keyring, from which the KEYIDs are to be found. If this option is not present, the KEYIDs are found from GnuPG's default keyring (usually ~/.gnupg/pubring.gpg); if it is repeated multiple times, the provided KEYRINGs are used as successive sources. 🗂️
• -h | --help — print the help message and quit. We love a girl who tells you how to use her. 🫶

🧚 ENVIRONMENT 🧚

• HOME — set the default home directory. 🏠
• GNUPGBIN — set the gpg binary. Default: "gpg".
• GNUPGHOME — set the default working directory for gpg. Default: "~/.gnupg".

⭐ EXIT STATUS ⭐

• 0 — keyart was executed successfully. slay. ✨
• 1 — gpg(1) or gpg2(1) are not installed. 😭
• 2 — the supplied hexadecimal string is not a multiple of 8 bytes. 💀

🦋 SEE ALSO 🦋

• gpg(1)

🎀 AUTHOR 🎀

keyart and its documentation is written by Aaron Toponce <aaron.toponce@gmail.com>. Thank you for your service, king. 🫡

lowkey a whole masterpiece. periodt. 💜

and that's the whole page bestie — this was keyart(1), dated 17 Jun 2014. stay artsy, stay drunk-bishop-coded. bye bestie!! 🌸💖