Introduction

[japanease] [English]

KeyRing Mini is a password management application program with encryption. It can read a chosen name / password into the clipboard, and also start a designated application program (usually a browser) with an URL as an argument. Using the program, an encrypted password data file uploaded to a Web page could in principle be safely shared between two or more machines.

Please turn off Style Sheets if this file looks garbled when you view it using Netscape 4.x.

Relation to Keyring / 2

KeyRingMini was written almost from scratch in VirtualPascal, based on the design features of KeyRing/2. A few functions have been omitted. The native file formats are not interchangeable, but a Rexx script can be used to convert unencrypted (exported) KeyRing/2 files to the KeyRingMini unencrypted xml format.

About the source code

The Blowfish encryption module used in KeyRingMini comes from http://www.cityinthesky.co.uk/cryptography.html.
The toolbar code is based on the Pascalized version of the http://es.os2.ru/cell.html source available from hobbes.
The xml related source uses the fcl library from FreePascal ported to Virtual Pascal.

Limitations

(1) A new instance of the designated application (e.g. Netscape) is started for each record/URL. There are no plans to add a function to feed the URL to an existing instance of the web browser.

General usage

Here's an outline of how to use KeyRingMini.

Start-up

The program asks for a password at start-up. Click the Use encryption button after entering the the password. When there is no password or you choose the Don 't encrypt button, data is written to a plaintext file.

Input

Select Record->New from the menu bar to create a new record. Then double-click on the newly made record (or choose Record->Configure Record from the menu bar, or the Record configuration icon from the toolbar)

...to bring up the Record Configuration dialogue box. Enter the required information.

Individual fields can also be edited directly (without bringing up the dialogue box) by Alt+Left-clicking them.
Use whichever method you prefer.

Page creation

Select Page->New, and then

Page->Configure Page (or the Page Configuration icon on the toolbar.)

Now you can customize the page name, description and the display items.
The item display order can be changed by using the arrow buttons.
The X button toggles the item display on and off. A check mark next to an item indicates that it will be displayed.

Launch Application

Drag and drop an .exe file to the Drop .exe file here box to enable the Launch application feature. The value in the current record's URL field is given as an argument when the the application is launched. Note that .cmd files and command objects will not work.
Moreover, please note that this setting is page specific, and must be repeated for each page. This also means that a different application can be set for each page.

Saving files

A newly created file has no name, and should thus be saved using the File -> SaveAs menu item or Save file with new name icon on the toolbar.

Enter a descriptive name.
Using the extension xml for plain text and crp for encrypted files is recommended.

An existing file may be saved by using the File -> Save menu item or the Save file icon on the toolbar.

Opening files

Files can be loaded using the Open existing file icon on the toolbar, or File->Load on the menu bar.

The default extension for plaintext files is .xml and that for encrypted files is .xrp. All data must be in a KeyRingMini native format, as the program cannot handle files that are in incompatible formats.

Function overview

This section explains the various KeyRingMini functions.

Menu

File


Load

Opens a file. If another file is already open, the new file is appended to the previously open one.

Save

Saves current file. Please use the .crp extension for encrypted files. The .xml extension should be used for plaintext files.

SaveAs

Use to save current file with a different name.

Import

Used to read a plaintext file when KeyRingMini is in encrypted mode. The file can then be saved in encrypted form.

Export

Used to export an encrypted file as plaintext.

Exit

Closes KeyRingMini, unconditionally saving the current file. A new (unnamed) plaintext file is saved as new.xml and a new encrypted file as new.crp.

Page


New

Creates a new page titled "Blank." Choose Page->Config from the menu bar to open the page settings dialogue and give the page a descriptive name.

Delete

Deletes current page.

Show Expired

Applies a filter to show only records whose expiry date (set using Page->Configure Page on the menu bar or the Page Configuration icon on the toolbar) has passed. When the filter is active, the page background turns pink.

Configure Page

Invokes the page settings dialogue. Here you can modify the page name, description and launch application (by dragging & dropping the pertinent .exe file on the Application box.) You can also choose which fields to display, and change the display order.

Sort

Sorts the records on the current page by the chosen field.

Record


New

Adds an item to current page. (KeyRing Mini does not automatically invoke a settings dialogue when a new item is added.)

Delete

Deletes the currently chosen record.

Move To

Moves the currently chosen record to another page.

Copy To

Copies the currently chosen item to another page.

Configure Record

Opens the record settings dialogue.

View

Changes the way records are displayed.

Icon

Shows icons only.

Detail

Shows detailed information on each record.

Toolbar


Open existing file

Opens a file. If another file is already open, the new file is appended to the one that is already open.

Save file

Saves the currently open file. Please use the .crp extension for encrypted files. The .xml extension should be used for plaintext files. KeyRing Mini is unable to distinguish file types automatically.

Save file with new name

Use to save the currently open file with a different name, or to save a new file that has not yet been given a descriptive name.

Page configuration

Invokes the page settings dialogue. Here you can modify the page name, description and launch application (by dragging & dropping the pertinent .exe file on the Application box.) You can also choose which fields to display, and change the display order.

Record configuration

Invokes the record settings dialogue. Checking the "No Expiry" checkbox makes the current record immortal as far as the expiry filter is concerned.

Filter expired records

Applies a filter to show only records whose expiry date has passed. When the filter is active, the page background turns pink.

Execute program

Starts the programs whose .exe file was dropped on the Application box on the Page settings page. The value in the URL field of the current record is fed to the program as an argument.

Exit

Closes the application, unconditionally saving the current file. A new (unnamed) plaintext file is saved as new.xml and a new encrypted file as new.crp.

Show / Hide passwords

Toggles between the following three display modes: passwords visible, password fields visible but crossed out, and password fields invisible. The data itself is in no way affected.

Context menu


New Record

Creates a new record.

Properties

Opens the record settings dialogue.

Delete Record

Deletes the currently selected record.

Move To

Moves the currently selected record to another page.

Copy To

Copies the currently selected record to another page.

Sort

Sorts the items on the current page by the chosen field.

Copy Password

Copies value in the currently selected record's Password field to the clipboard.

Copy User

Copies the value in the currently selected record's User field to the clipboard.