Provided by: signing-party_2.9-1_amd64 bug


       keyart - Create ASCII art of an OpenPGP key.


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


       keyart creates an ASCII  art  representation  of  public  OpenPGP  keys.  The  art  is  an
       implementation  of  the Drunken Bishop by Dirk Loss. Documentation about the algorithm can
       be found in /usr/share/doc/signing-party/keyart/, or as appropriate for your distribution.

       keyart supports printing the ASCII art in both plain text (default) and ANSI  color.  ANSI
       color uses a "heat map", where 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. There is a 1:1 ratio of color to printed character.

       The  KEYIDs  are  key  identifiers  (fingerprint,  keyid,  user  ID,  etc.  see gpg(1) for
       details).  If no KEYID is given, keyart creates an ASCII art representation for  all  keys


       -c | --color
               Print the ASCII art using ANSI color to the terminal.

       -l | --longid
               Print the 16-character long ID of a on OpenPGP key in the footer badge. Default is
               to print the 8-character short ID. Silently ignored if "-f | --fingerprint HEX" is

       -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.


       HOME    Set the default home directory.

               Set the gpg binary.  Default: "gpg".

               Set the default working directory for gpg.  Default: "~/.gnupg".


       0       keyart was executed successfully.

       1       gpg(1) or gpg2(1) are not installed.

       2       The supplied hexadecimal string is not a multiple of 8 bytes.




       keyart and its documentation is written by Aaron Toponce <>.

                                           17 Jun 2014                                  keyart(1)