Manage all your UserId & Password

Version 3.0 Build 2
Author : Ramesh Natarajan
( Home Page : email : ramix_info@yahoo.com )
12-JUL-2003

CONTENTS:

1. Overview
2. Major Features
3. Installation
• New Installation
• Upgrade from previous version
4. Usage
• Password Manager
  • Tool Bar
  • Menu Bar
  • Panel Buttons
  • Record Menu
  • Search Account Name
  • Sort the Records ( Order By )
  • View based on Category
• Password Generator
  • Password Generator Mode
• Password Options
• Generate Password
• Panel Buttons
• Password Mask ( Password Format )
• Keyboard Controls
5. Registration
6. Release history and updates
7. Future plans
8. Disclaimer and legal stuff
   

1. Overview

Did you forget the password for the account which you have created on a website... ? Are you trying your luck to login into the website with all the different combination of the standard password which you always use... ? Tired of keeping track of all the passwords for your different accounts?. It's time to organize all your userid's and passwords in one place safely.

Keep all your account information with user id,password,url and notes information in one place. With PasswordManager, you can organize passwords in multiple files. Data files will be encrypted. Each and every file has to be assigned with a password which will be asked when the file is open for viewing/editing. You can choose to store any personal data which can be stored in tabular form.

This also includes a flexible and configurable random password generator.

2. Major Features

• Can run on ALL platforms as this is written in Java
• Organize all your account name,userid,password,url and notes information in one file
• Store additional information using the 10 additional attributes for an account
• Data files are encrypted using Blowfish algorithm
• Built-in random password generator
• Copy UserId and password to clipboard
• Backup Facility
• File Lock capacity
• Unlimited records and data files
• Launch URL from the application
• Either Choose browser for URL launch or use system default browser
• Records can be grouped using user defined categories
• Import records from text file
• Export all/selected records to text,HTML file
• Search records on all/specific columns
• Records sorting based on column names
• Password can be masked in the main table
• Kunststoff Look and Feel is used in password manager
• etc..

3. Installation

New Installation

Install/Verify the Java Runtime Environment :

Make sure you have java runtime environment installed in your machine. I have tried with java 1.2.2, 1.3.1 and 1.4.0_01. Type java -version in the command prompt, you should get something similar to the following.
java version "1.3.1"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.1-b24)

If java runtime is not installed in your machine, download it from http://java.sun.com/j2se/downloads.html and following the instruction to install it on your platform.

Install Password Manager :

Unzip the passwordmanager.zip , which will create passwordmanager folder and all files will be put underneath this directory. The following files are distributed with this zip file.

Run PasswordManager :

Setup is done. Double click on the passwordmanager.jar to bringup the application. (or) type java -jar passwordmanager.jar from the install directory.

Upgrade from previous version.

For all other versions :

• Take a backup of all the data files which you are using to a different location.
• Unzip the passwordmanager.zip to the same directory structure as you did in previous version. ( i.e if you have c:\passwordmanager directory created by version 1.0, unzip the passwordmanager.zip to c:\ which will overwrite all the files inside c:\passwordmanager )

From Version 2.x to Version 3.0

• Step 1 : Take a backup of all the data files which you are using to a different location.
• Step 2 : Take a backup of your previous version's install directory. ( i.e if you have installed previous version under c:\passwordmanager, take a backup of the whole directory. This step is needed because of the next step, where you have to export your *.pwm file to a text file. )
• Step 3 : Important : Since a new encryption ( BlowfishJ is used in this release ), the *.pwm file of previous version cannot be directly opened from this version. Instead, take a export of the *.pwm file using your previous version of password manager first. Follow the steps below to take an export.
• Launch your passwordmanager V2.x application
• Open your *.pwm data file
• Go to File Menu -> Export Menu -> To Text
• Click on 'Password' and 'Additional Attributes' checkboxes. Make sure 'All Rows' radio button is selected. Make sure Account Name,UserId, Password, URL, Notes, Category and Additional Attributes are selected.
• Click on Export, and give a file name and directory location where the text file needs to be stored [ Note : This file will have all the information in a clear text format including your password, make sure you delete this file once you import it to the new version of password manager. ]
• Step 4: Unzip the passwordmanager.zip to the same directory structure as you did in previous version. ( i.e if you have c:\passwordmanager directory created by version 2.x, unzip the passwordmanager.zip to c:\ which will overwrite all the files inside c:\passwordmanager )
• Step 5 : Now launch the new version of passwordmanager. Follow the steps below to import the records which you exported as mentioned above.
• Launch your passwordmanager V3.0 application
• Click on 'New File'
• Go to File Menu -> Import Menu -> Select the text file which you exported before.
• This should've imported all your records.
• Click on 'Save As' button from the toolbar, and save this new *.pwm file , which will be encrypted using the BlowfishJ encryption algorithm.


Note : In your exported text file of V2.x application, If you have any commas in a field [say for e.g. notes field had a comma in it], make sure you enclose the notes field within double quotes, by editing the exported *.txt file. In V3.0 this issue is fixed, if any field has a comma in it, it will be automatically enclosed within double quotes during export.

From Version 1.0 to Version 1.1

• Take a backup of all the data files which you are using to a different location.
• Unzip the passwordmanager.zip to the same directory structure as you did in previous version. ( i.e if you have c:\passwordmanager directory created by version 1.0, unzip the passwordmanager.zip to c:\ which will overwrite all the files inside c:\passwordmanager )
• Rename all your old data files to *.pwm. From version 1.1, only *.pwm will be the standard extension for the data files.

4. USAGE

PASSWORD MANAGER

Tool Bar Buttons :

1. After the Password Manager is started, user can choose to create a new file (or) open an existing file. In the initial window, the Save and SaveAs button will be disabled, as no file is open (or) created yet.
   
   
2. New File : Clicking on this New File Icon on the toolbar will enable user to add records. Clicking on New File will also enable the 'Save As' button. ( Note : This will just enable the 'saveas' button. Now, user should click on 'Add' to add records. )
   
   
3. Open File : Clicking on the Open File Icon on the toolbar will ask the user to open an previously saved data file. Upon choosing the data file, user will be prompted to enter the password specific to that particular file. ( Note : This is the same password which user will enter when doing the 'Save As' of the file. )
   
   
   
4. Save File : When you are working on the records, clicking on the 'Save' will just save the newly created/modified records to the data file. This will take the current file name to overwrite.
   
   
5. SaveAs File: This option will let user choose the directory where he wants to save the file and give a file name. After choosing an file name, user will be prompted to enter an password for the file. This password has to be remembered when opening the file next time using the Password Manager.
   
   
   

MenuBar :

1. File
   • Reopen
     • Clear List ( This will clear the open file list. )
     • FileName 1 ( the last open file )
     • FileName 2 ( the last open file )
     • FileName 3 ( the last open file )
   • Close
   • Change Password ( This will let you change the password for the current file )
   • Lock ( This will close the current open file and prompt for the file password to reopen. )
   • Import
     • Records can be imported from a comma delimited file. A sample of the file is shown below
     • Records should follow the following field format in a single line.

     account_name,user_id,password,url,notes,category,attribute 1,attribute 2,attribute 3,attribute 4,attribute 5,attribute 6,attribute 7,attribute 8,attribute 9,attribute 10

     • If there is a comma in any field, please enclose that field by a double quote ", as shown below in the sample_import.txt's third record.
     • sample_import.txt :

     yahoo,ramix_info,,http://mail.yahoo.com,This account is my yahoo email account,Personal
     hotmail,ramix_info,test,http://www.hotmail.com,Need to change this account info,Personal,Q:What is your pet name?.A:Scooby
     travel,travel_user,test,http://www.travelocity.com,Travel Info,Personal,"attribute 1 has comma, in it",attribute 2
     

   • Export ( For both the option, you can export either All rows (or) selected rows. There is an option to choose which fields needs to go in the export file. But default password field is not selected. If you choose to export a password field, keep the exported file in a safe location. )

   

   • To Text : Records will be exported to a comma delimited text file.
   • To HTML : Records will be exported to a HTML file.
   • Exit ( Exit application )
     
2. Tool
   • Option ( Set the column Names, Choose whether the password column needs to be masked or not - ******, Choose whether the default browser needs to be used [or] select the browser location, etc...)
   • Backup TAB : There are two backup option given under this tab.
     • Backup Option 1 : This option cannot be changed. This will always be defaulted to 'Take Backup'. Whenever a pwm file is opened, a backup will be created as *.pwm_bak1 in the backup directory specified. If no backup directory is specified, *.pwm_bak1 will be saved in the same directory where the application is installed.
     • Backup Option 2 : This option can be customized. Default is 'No Backup'. User can change this option to 'Take Backup'. Whenever 'Save' button is clicked, a backup will be created as *.pwm_bak in the backup directory specified. If no backup directory is specified, *.pwm_bak2 will be saved in the same directory where the application is installed.
     • Backup Directory : Specifiy the backup directory which can be used by the Backup Option 1 and 2. If no directory is specified, backup will be saved in the same directory where the application is installed.
     • 
   • Category ( This option will be highlighted, only after opening a file (or) after clicking on 'new file'. This will let u manage the category. The category which is created is for each and every file. ). If a particular category which you are trying to delete has records associated with it, it will prompt you with a warning message, if you still wish to delete that category, it will only delete the category, all the records associated with this particular category will be changed to 'Unfiled' category. You can also delete multiple category by selecting multiple category.

   

   • Password Generator : This will generate random passwords.
   • Clear ClipBoard : This will clear the content of the clipboard. After 'Copy Password', if you wish to clear the clipboard, use this option.
   • Record Count : This will give the total number of records in the current open file.
3. Help
   • Help - This will open readme.html ( this file ) in the system browser.
   • Web Site - This will take you to the Password Manager home page.
   • About

Panel Buttons ( These actions are specific to a particular record displayed in the table ) :

1. Add - Add's new record
2. Edit - Edit the selected record
3. Delete - Delete the selected set of records
4. View - View the selected record
5. Copy UserId - Copy the selected record's userid to the clipboard
6. Copy Password - Copy the selected record's password to the clipboard
7. Go URL - Invoke the browser with the selected record's URL

Record Menu - ( Right mouse click on the table after selecting a particular record to get this popup menu ) :

1. Add - Add's new record
2. Edit - Edit the selected record
3. Delete - Delete the selected set of records
4. View - View the selected record
5. Duplicate - This will copy the selected record. i.e will create a new record based on the selected one.
6. Copy UserId - Copy the selected record's userid to the clipboard
7. Copy Password - Copy the selected record's password to the clipboard
8. Copy URL - Copy the selected record's URL to the clipboard
9. Copy Record - Copy the selected record's information to the clipboard
10. Go URL - Invoke the browser with the selected record's URL

Search Account Name :

• Enter the search string in the textbox and either hit enter (or) click on Find to search that particular search string. All the records which matches the particular search criteria will be displayed in the table. Search result is based on the combination of search string,order by and category. So, you can search in a particular category for a specific key word and sort the search result on a particular column. If no records are found , a message will be displayed.
• Search can be on 'All Columns' or on a specific column by selecting the column name from the dropdown box.
• Search string is case insensitive.

Sort the records ( Order By ):

All the records can be sorted based on all the fields. Click on this drop down list and selected the column name on which you want to sort. Select 'None' to see the default order ( the order in which the records were added ).

View based on Category :

Records can be viewed based on the Category. Click on the drop down list and select the category. If 'Personal' category is selected, all the records which belongs to 'Personal' category will be displayed.

PASSWORD GENERATOR

Password Generator Mode: Password Generator can be used in two modes.

• Default Mode where user chooses all the password options and generates random password.

• Password Mask Mode where user specifies the password mask ( password format ), based on which random password will be generated. This option is very flexible.

  

Password Options :

1. Password Alpha-Numeric : Password can be of alphabet type, numeric type or alphanumeric type. Optionally you can include special characters also by clicking on the 'Special Character' check box.
2. Password Case : Password can be either lowercase, uppercase or mixedcase. If 'numbers only' option is selected from the previous group, the case has no effect.
3. Password Length : Password can be variable length or fixed length. If fixed length is selected, specify the length of the password.
   

Generate Password :

Enter the total number of passwords which needs to be generated and click on 'Generate Password' Button.

Panel Buttons :

Save to File : Once the passwords are generated, click on 'Save to File' to save these passwords to a file.

Copy to Clipboard : Select the password and click on 'Copy to ClipBoard', which will copy it to the system clipboard, which you can paste it anywhere you want.

Password Mask ( Password Format ) :

Passowrd Mask CheckBox : You also have the powerful flexibility of specifying your own password mask ( password format ). This means that you can specify where a lowercase character should come, where a special character should come, where a numeral should come etc. To enable this functionality click on the 'Password Mask' Check box.

Password Mask : You can specify your own password mask. For e.g. specifying a mask AAaa99## means, the password generated will have the first two characters as 'Upper case alphabets', the next two characters as 'Lower case alphabets', the next two characters as 'Numerals' and the last two characters as 'Special Characters'. This gives you a total control on how you want to generate your random password.

Keyboard Controls

5. Register Password Manager

Password Manager is a Freeware. Enjoy . :-) .
As a token of appreciation please send me an email with your comments/suggestions, if you like this freeware.

6. Release History

V3.0 Build 2 - 07/12/2003

• Implemented the automatic backup. i.e whenever the pwm file is opened, a backup will be taken.
• Enhanced the Tools->'Record Count' to give the record count based on category.
• Enhanced the Splash Screen, About and License.

V3.0 - 05/18/2003

• Implemented BlowfishJ algorithm for encryption written by markus_hahn@gmx.net. www.come.to/hahn .
• File -> Help will open the readme.html in the system browser
• 'File -> Export -> To Text'. If an attribute is having a comma in it, during export it will be enclosed with double quotes.
• Ability to delete multiple categories
• In the 'File -> Export -> To HTML', the URL fields will be hyperlinked in the generated html output
• Ability to view a record. Ability to mask the password in the view record option.

V2.1 - 01/05/2003

• Added File->Export-> to HTML
• Better Search Capabilities
• Added Tool->Record Count

V2.0 - 11/03/2002

• Added more options in the Tools -> Options Menu
  • Clear clipboard on Exit
  • Show password in the table
  • Copy UserId or Password to clipboard on URL launch
  • Use Default Browser or select browser
  • Backup Option
  • Startup File Option
• Added GeneratePassword option during add/edit records
• Added File -> Change Password, File -> Lock option
• Added Duplicate Record
• Better Category Management
• Default values can be given for all fields including additional attributes
• If {sysdate} is added as default value, it will put the current date during record add.
• Added Keyboard Control
• Added Kunststoff Look and Feel

V1.1 - 08/18/2002

• Some minor bug fixes
• Added the current filename to the titlebar of the application.
• Added the file name to the 'file open' and 'file save' dialog title bar.
• Added ability to delete multiple records.
• Added clipboard clear functionality.
• If some data is changed, prompt user to save before exiting the application.
• Added ability to close an open file.
• From this version all the data files will have extension as *.pwm . If you have a
  data file in V1.0, rename it with *.pwm extension.
  

V1.0 - 07/23/2002 - Initial release

For latest release and other information visit PasswordManager home page

7. Future Plan

• Please send your suggestions to me ( ramix_info@yahoo.com )

8. Disclaimer and legal stuff

Password Manager License :

Password Manager is a freeware. No warranty of any kind, either express or implied. The user must assume the entire risk of using the Password Manager. The software provided herein may have bugs or errors that have not been found and/or corrected. The Author will not be held liable for any damage that occurs from use of the software. Use of the Password Manager is at the user's own risk.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. THE AUTHOR DOES NOT WARRANT THAT THE OPERATION OF THE PROGRAMS WILL BE WITHOUT INTERRUPTION OR ERROR FREE.

BlowFishJ :

Password Manager uses BlowfishJ for encryption, which is covered by the LGPL. BlowfishJ is written by markus_hahn@gmx.net . Check Markus Hahn HomePage for more information on BlowfishJ .

Kunststoff Look and Feel :

Password Manager uses Kunststoff Look and Feel which is covered by the LGPL. Check www.incors.org for more details on Kunststoff Look and Feel.

Graphics License :

The graphics used in this application were obtained from Sun Microsystems. The license for these graphics is as follows.

Sun grants you ("Licensee") a non-exclusive, royalty free, license to use, and redistribute this software graphics artwork, as individual graphics or as a collection, as part of software code or programs that you develop, provided that i) this copyright notice and license accompany the software graphics artwork; and ii) you do not utilize the software graphics artwork in a manner which is disparaging to Sun. Unless enforcement is prohibited by applicable law, you may not modify the graphics, and must use them true to color and unmodified in every way.

This software graphics artwork is provided "AS IS," without a warranty of any kind. ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE GRAPHICS ARTWORK.

IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE SOFTWARE GRAPHICS ARTWORK, EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

If any of the above provisions are held to be in violation of applicable law, void, or unenforceable in any jurisdiction, then such provisions are waived to the extent necessary for this Disclaimer to be otherwise enforceable in such jurisdiction.