Getting started

Installation

QPaMaT is very protable. It is written in C++ programming language using the Qt toolkit from Trolltech. This toolkit is avaiable for all major operating systems: Unix (including Linux, Solaris, HP-UX and many others) using X11, MacOS X and Microsoft Windows.

QPaMaT also uses the OpenSSL crypto library which is available for much platforms, too.

Unix

You have to have installed Qt4 on your computer. Qt3 does not work any more. If your distribution does not have Qt4 packages, get Qt4 from Trolltech and build it yourself. It's easy and described in the REAMDE file of the Qt distribution.

First try to find a binary package for your Unix. If you run Linux, the chances are good. I create RPMs of every releases. So, just install the packages using the following command:

$ rpm -Uvh qpamat-version-i586.rpm

If not, you need to compile it from source. Make sure that Qt is installed properly, including developer packages which contains the headers and the build tools like qmake. Also make sure that the environment variable QTDIR points to the right place, usually something like /usr/local/Trolltech/Qt-4.0.0. You also need to have OpenSSL installed, including header files.

You have to set also the QMAKESPEC variable to a correct value, for example /usr/local/Trolltech/Qt-4.0.0//mkspecs/linux-g++. qmake must be in PATH. Normally, just include $QTDIR/bin in your PATH environment.

You may edit qpamat.pro to change install location if you don't like /usr/local. To compile and install QPaMaT, run

$ qmake qpamat.pro

$ make

$ lrelease qpamat.pro

# make install

Windows

Just use the installer file which is available at the QPaMaT website. If you want to compile from source, you have to download the GPL version of Qt from the Trolltech website and basically perform the same steps as on Unix. The file WIN32.txt in the top-level directory of the source distribution contains some more hints.

First startup

QPaMaT is multi-user aware. On operating systems with different users (such as Unix or Windows NT), each user has different settings. QPaMaT stores its settings in the home directory or in the Windows registry. On first startup with that account, QPaMaT asks you to enter the master password. This master password is used to encrypt all your other passwords. So be careful and choose a good password. If the password is too simple, QPaMaT declines it. If the password is accepted, you find a empty windows.

Normal usage

You can now create your entries. On the left you see the "Sites" tree. Because you've not created any entries, there's no tree but a white area. If you right-click somewhere in this are, a menu opens. Choose Insert category and enter a name, e.g. "Onlineshops" and press the Return key. Now right-click on that item and choose Insert Item. Enter a name such as "Amazon".

Of course, you can now enter some data. On Amazon, you usually have a e-mail address for login, a password and the URL. On the right, you see the list of key-valuie pairs. The list is empty but you fill it now. Click somewhere in the list with the right mouse button and choose New. On the bottom, you can now edit the entry. Click on the combo box and choose "Username". The cursor is set in the Value text field. Enter your mail address. If you would like, you can change "Username" to "e-mail address" in the Key field.

Now enter a new item and choose "Password". Enter the password now in the Value field. You'll see that the password is not displayed. To get it, double-click the password in the list above. You can also copy it to clipboard by clicking on it with the middle mouse button or, if you have a two-button mouse, right click and choose Copy. After that, you can enter the URL as third entry. If you double-click the URL in the list, a browser will be opened to show the URL. You can change the browser in the preferences.

After that, you want to save the data. Just choose File->Save and the data will be saved in a XML file in your home directory. You can change the location in the preferences.

If you exit the application and start it again, just enter your password and you'll see that same screen as you saw it before you closed the application.