MyPasswordSafe

© 2004 Semantic GapTM Solutions

Contents

Introduction

MyPasswordSafe is a straight-forward, easy-to-use password manager that maintains compatibility with Password Safe files. MyPasswordSafe has the following features:

The download page was http://www.semanticgap.com/myps/release/, in case you want to skip the rest of this.

The latest code is available on Github at http://github.com/sneakin/mypasswordsafe. It contains code that is more recent than the last release.

Back to top

Changes

February 4th, 2004

January 23rd, 2004

January 22nd, 2004

January 19th, 2004

January 18th, 2004

January 12th, 2004

Just some minor updates. Thanks for all the positive responses I've been getting. Back to top

Legal

Copyright and Trademark

MyPasswordSafe and this manual are Copyright © 2004 Semantic Gap Solutions, and is covered by the same license as the software. Semantic Gap and the double spiral are trademarks of Nolan Eakins.

License

Copyright © 2004, Semantic GapTM Solutions
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "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 COPYRIGHT OWNER OR CONTRIBUTORS 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.

Back to top

Installing

If you're reading this then you're either warm or hot. MyPasswordSafe comes in two distributions: a binary distribution and the source distribution. MyPasswordSafe requires Qt 3 and Boost, so make sure you have those. Boost is only required to compile MyPasswordSafe, but Qt needs to be installed to run the binaries.

...From Binaries

The binary distribution is precompiled. It can be downloaded from MyPasswordSafe's download page. Once that's downloaded, just untar it:

tar xvfz MyPasswordSafe-bin.tgz

That should create a directory with the MyPasswordSafe binary, this file, and some other documentation. Running "make install" inside the MyPasswordSafe directory will install everything under /usr/local. It should work in other locations, but the language files won't be found if they're not in /usr/local/share/MyPasswordSafe/locale. That should be all assuming it works. If it didn't keep reading.

...From Source

So you want to compile it for yourself. Make sure Qt 3 is installed, and download Boost. Boost doesn't need to be compiled, just untarred.Download the sources and then untar MyPasswordSafe:

tar xvfz MyPasswordSafe.src.tgz

You can untar Boost into MyPasswordSafe's directory. The project file (MyPasswordSafe.pro) expects "boost-1.30.2" to be in the directory. If it's not, a simple link made from your boost directory will work. You can change the project file by hand if your boost path is different. The Makefile also contains a PREFIX variable which sets the location where MyPasswordSafe will install it and its associated files. Change it if /usr/local isn't where you want it to install itself. Finally you can run make:

cd MyPasswordSafe
make
make install

Now if that was successful you can start using MyPasswordSafe. If not, send me an email describing your situation. If for any reason you want to uninstall MyPasswordSafe, the Makefile has an uninstall directive. Running "make uninstall" will remove the files it installed.

Back to top

Usage

MyPasswordSafe is straight-forward to use. Nearly all of the commands can be accessed from the menu, toolbar, context menu, or by keyboard. Before we delve into actual usage, let's cover how MyPasswordSafe can be started.

Starting MyPasswordSafe

Starting MyPasswordSafe is just like any other program, you just need to run it. If you copied the binary into your PATH, all you need to is type MyPasswordSafe. Otherwise you need to either change to the directory where the binary is or include that in the command line. Adding an icon to your favorite launcher may also be desired.

When MyPasswordSafe starts for the first time, an empty safe is created. As you'll learn later, MyPasswordSafe has a thing called the active safe. The active safe gets opened when MyPasswordSafe starts saving you from having to always find it over and over.

The Main Window

The main window isn't to complex. There's a list box, tool-bar, and menu. The tool-bar and menu duplicate each other quite a bit. Most of the action happens in the list box.

Screenshot of MyPasswordSafe's main window

The list box contains the passwords from the current safe. Double clicking on a password in the list box fetches the password for that item, and right clicking convienently pops up the edit menu next to the pointer. So what do those commands do?

Back to top

Managing Passwords

The edit menu contains the commands used to manage passwords. Each command's name is descriptive of what it does. For example, Add Password really does add a new password. Delete Password deletes the password selected password. And Edit Password opens up a dialog to edit the selected password.

The last two commands may need some explanation. They are Fetch User and Fetch Password. Both copy information to the clipboard. One copies the user, and the other copies the password field.

Back to top

Edit Password Dialog

Screenshot of the
	edit password dialog

Both Add Password and Edit Password make use of the same dialog to edit a password's data. Passwords have four fields of information: name, user, password, and notes. All but the password field is displayed in the main window. The dialog also has three buttons that affect the password field.

Back to top

Opening and saving safes

Safes can be created, opened, and saved from the file menu. The commands work like any other application except when a pass-phrase is needed. MyPasswordSafe does support multiple file formats. Currently MyPasswordSafe only two file formats are supported, Password Safe safes and text files.

Password Safe is a similiar to MyPasswordSafe, but runs only on Windows. Files created by Password Safe can be opened by MyPasswordSafe and vice-versa. The files are encrypted using the Blowfish algorithm, and are presumed to be secure. Use dat for the extension.

Text files should NEVER be used. All information is stored unencrypted. If you find them useful, go ahead and use them.

Back to top

Preferences

Screenshot of the Preferences Dialog

MyPasswordSafe isn't the most configurable, but it does have some options.

MyPasswordSafe also stores the position and size of the window as well as the column widths. These are set by changing them, and are not available in the Preferences dialog.

Back to top

FAQ

How secure is MyPasswordSafe?

It beats me. The safes should be secure unless the Blowfish algorithm gets cracked. It's when the program is running that I'm unsure of the security. I'm sure some pesky program could find your passwords in memory.

If you know anything about how to make this program bullet proof, send me an email or a patch.

Where is the Windows version?

I really wish there was a Windows version, but I can't afford a Qt license. If you need a password manager for Windows, get Password Safe. Versions < 2 create files that MyPasswordSafe can load and save. [ Note to developers: if you have Qt for Windows, could you compile and package it for me? ]

Back to top

Contact

Semantic GapTM Solutions can be contacted using the following:

Credits

Programming and design:
Nolan Eakins

Peter Palfrader contributed bug fixes for 64 bit cleanliness, and character encoding problems. He also reported some other bugs and issues.

Some of the file loading and saving code is from Password Safe.

And most of the icons came from KDE

The French translation was done by Emmanuel Adeline.