1keyart(1) General Commands Manual keyart(1)
2
3
4
6 keyart - Create ASCII art of an OpenPGP key.
7
9 keyart [-c|--color] [-l|--longid] [-f|--fingerprint HEX [-f|--finger‐
10 print HEX ...]] [-k|--keyring KEYRING [-k|--keyring KEYRING ...]]
11 [KEYID ...]
12
14 keyart creates an ASCII art representation of public OpenPGP keys. The
15 art is an implementation of the Drunken Bishop by Dirk Loss. Documenta‐
16 tion about the algorithm can be found in /usr/share/doc/signing-
17 party/keyart/, or as appropriate for your distribution.
18
19 keyart supports printing the ASCII art in both plain text (default) and
20 ANSI color. ANSI color uses a "heat map", where cold (blue) represents
21 squares in the room the drunk bishop has rarely visited, and hot (red)
22 represents squares in the room the drunk bishop has frequently visited.
23 There is a 1:1 ratio of color to printed character.
24
25 The KEYIDs are key identifiers (fingerprint, keyid, user ID, etc. see
26 gpg(1) for details). If no KEYID is given, keyart creates an ASCII art
27 representation for all keys found.
28
29
31 -c | --color
32 Print the ASCII art using ANSI color to the terminal.
33
34 -l | --longid
35 Print the 16-character long ID of a on OpenPGP key in the
36 footer badge. Default is to print the 8-character short ID.
37 Silently ignored if "-f | --fingerprint HEX" is passed.
38
39 -f | --fingerprint HEX
40 Any arbitrary hexadecimal string of any length. Could be an
41 MD5, SHA1, SHA2, or SHA3 hexadecimal checksum. Useful for com‐
42 paring and analyzing potential collisions with existing keys.
43 This option can be repeated multiple times.
44
45 -k | --keyring KEYRING
46 An OpenPGP public key file or keyring, from which the KEYIDs
47 are to be found. If this option is not present, the KEYIDs are
48 found from GnuPG's default keyring (usually ~/.gnupg/pub‐
49 ring.gpg); if it is repeated multiple times, the provided
50 KEYRINGs are used as successive sources.
51
52 -h | --help
53 Print the help message and quit.
54
55
57 HOME Set the default home directory.
58
59 GNUPGBIN
60 Set the gpg binary. Default: "gpg".
61
62 GNUPGHOME
63 Set the default working directory for gpg. Default:
64 "~/.gnupg".
65
66
68 0 keyart was executed successfully.
69
70 1 gpg(1) or gpg2(1) are not installed.
71
72 2 The supplied hexadecimal string is not a multiple of 8 bytes.
73
75 gpg(1)
76
78 keyart and its documentation is written by Aaron Toponce
79 <aaron.toponce@gmail.com>.
80
81
82
83 17 Jun 2014 keyart(1)