Keyring for webOS


Easy password management on your phone

Keyring for webOS stores your account information securely, so you don’t have to rely on your memory or little scraps of paper. Sensitive data are encrypted using the Blowfish algorithm, and protected by a master password.


Keyring supports import/export from/to a URL, a file, or the clipboard. The simplest method is to export to the clipboard, paste the output (which is an encrypted blob) into an email, and send it to yourself. If you want to backup to a URL, you’ll need a service on the other end that supports it. Eventually I’d like to build something on Google AppEngine, but for now, you can copy this incredibly lame python CGI program, and stick it on a server you own.

Converting from other formats

If you’ve been using Keyring for PalmOS, CodeWallet, eWallet, or any system that can export to CSV, you can convert your data to Keyring format with a handy Java utility. The PalmOS Keyring import code was written by the GnuKeyring folks, and the importers for CodeWallet, eWallet & CSV were contributed by Matt Williams (Grabber5.0).

  1. Install Java on your computer (it’s probably already there).

  2. Download the converter.

  3. Get hold of your old data:

    • GnuKeyring: Back up your PalmOS device, or otherwise get access to the Keyring for PalmOS database. It’s generally named Keys-Gtkr.pdb.
    • CodeWallet: Go to “Data Export” and save as “Text file”. Attachments can not be converted at this time.
    • eWallet: Export data as a .txt file.
    • CSV: Allowed column headers are: title or name, category, username or account, password, note, url, created, changed, viewed. Any other labels will be ignored. The title, username, and password fields are mandatory, others are optional. The converter supports both Excel and standard CSV formats.
  4. Run the converter:

    java -jar keyring-converter.jar /path/to/old-data.ext /path/to/output-file.json old-data-type

    Where “old-data-type” is one of “keyring”, “codewallet”, “ewallet” or “csv”.

  5. Enter passwords as prompted (pdb import requires the password for the GnuKeyring database).

  6. Get the new file onto your webOS phone – it’s probably easiest to load it onto the media partition via USB.

  7. Import the converted file.

  8. Profit!

Due to US encryption export rules, you may need to install the “Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy” files from Sun. If you need them, the converter will throw an error, so it’s probably simpler just to forge ahead, and go through the trouble only if necessary. Get them from; download the zip file, and follow the instructions.

Desktop Client

An alpha release of the desktop client is now available (or as a Windows .exe). It provides the following features:

Running from the command line (on OSX and Linux):

java -jar keyring-ui.jar [json-db-file]
    To start up the full-featured GUI, optionally loading the given db.
java -jar keyring-ui.jar input-file json-output-file [keyring|csv|ewallet|codewallet]
    To convert input-file from the given format and write to json-output-file.

In the second mode, it works just like the old converter; however, it’s a lot easier to do conversion in GUI mode. See the instructions for the converter for details on format conversion and export encryption stuff.

DANGER: This is alpha code. It’s got bugs. It’s got foibles. It wants to eat your data. If you trust it with your important data, you deserve the suffering that you get, and I’ll laugh at you.

Discussion and Bug Tracking

If you want to talk about Keyring, ask questions, or report a bug, there are a few options:

Get Keyring

Keyring is usually available via Preware, from the PreCentral Homebrew App Gallery, and right here: com.otisbean.keyring_0.3.0_all.ipk.

Source for Keyring and keyring-converter is available on GitHub.


Keyring is part of the wide world of Open Source, and I’m happy to work with other people to make it a better package. If you’re interested in helping, please contact me.

I’m currently looking for:

Contemplated Future Features

Change Log


List of keysList of keys

A keyA key



PreferencesPassword generator