keyart(1)

1keyart(1)                   General Commands Manual                  keyart(1)
2
3
4

NAME

6       keyart - Create ASCII art of an OpenPGP key.
7

SYNOPSIS

9       keyart  [-c|--color]  [-l|--longid] [-f|--fingerprint HEX [-f|--finger‐
10       print HEX ...]]   [-k|--keyring  KEYRING  [-k|--keyring  KEYRING  ...]]
11       [KEYID ...]
12

DESCRIPTION

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

OPTIONS

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

ENVIRONMENT

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

EXIT STATUS

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

AUTHOR

78       keyart  and   its   documentation   is   written   by   Aaron   Toponce
79       <aaron.toponce@gmail.com>.
80
81
82
83                                  17 Jun 2014                        keyart(1)