# GPG Keychain Access

# Read Me

for version 0.7.0.1

## Notice

Note that only the English and German localizations work correctly. If you are interested in translating this to other languages, please, visit our website.

## Introduction

This is a simple key management program for GNU Privacy Guard. It has a GUI and does some basic things. You'll have to go to the command line for real power, though.

You'll need GNU Privacy Guard for OS X installed. You can get it from http://www.gnupg.org/.

## Instructions

Usage is simple. GPG Keychain Access will list your keys and then you can do stuff with them. You can also import and export keys. Some actions, like importing and exporting, are nice and integrated. Other features cannot be implemented fully, though, so Terminal will be started up and you'll be able to do what you want (the command you want will be run for you). At most you might have an interactive interface. At least, you'll be asked for your password. When done, just close the Terminal window that was created.

## Known Issues

- This program has only been tested on Mac OS X 10.3 ("Panther").
- Generating large keys can take at least 15 minutes. It may look like the program has frozen or crashed, but it hasn't. Be patient or get a cup of coffee or just do something else. Key generation can happen in the the background.
- The file system name for this program is "GPG Keychain Access.app" and the Finder should localize this (in English it should read "GPG Keychain Access") but may not.
- This program is incompletely translated. The English and German language versions should work and the other languages will probably appear in a combination of English or German with some text in the working language. This will be fixed before the 0.7.0 stable version.
- If you installed GnuPG with fink or, when you built it yourself, installed GnuPG in a directory other than /usr/local, you need to run GPGPreferences before using GPG Keychain Access. GPGPreferences will fix your system to work with the entire suite of Mac GPG applications. If it still doesn't work, create symlinks from your binaries of gpg and gpgv to /usr/local/bin.
- It is not possible to export a secret key. This is because the current method of exporting secret keys is not secure, though you can do it at the command line if you really want to. This will be fixed in future versions. NOTE: This is once again secure in 1.0.7, but still not possible via GPGME.
- There are conditions where GPG Keychain Access may crash after opening the key information dialog. These conditions remain ill-defined and are under investigation.

## Frequently Asked Questions

Why does GPG Keychain seem to freeze for a few seconds when I try to use some commands under the Keys and GPG menus?
  GPG Keychain pauses while AppleScript talks to Terminal to start up GPG running an appropriate command. This is intended as a feature, so that you know that GPG Keychain is working. Most of the time you'll get a spinning cursor to illustrate this, but sometimes you don't. Just wait for a few more seconds and it should be working. If it has been a minute or more, something is probably the matter and you should go ahead and force quit GPG Keychain.

## Contact

This application is the result of the combined efforts of the Mac GPG project, which can be found Online at http://macgpg.sourceforge.net. Either visit the Web site for contact information or try rhwood@users.sourceforge.net.