Puppy Money help

                                                                                               

Table of contents


    Introduction
    Starting Puppy Money
    Using Puppy Money
    Viewing Entries
    Printing
    Backup
    Troubleshooting 
    Disclaimer
  

Introduction

Puppy Money is written in tcl/Tk and utilises the sqlite database. For more information about sqlite go to their home page here.

Puppy Money is meant to be a lightweight money manager for single home use and thus does not contain all the bells & whistles that other financial programs have.

It is designed to be simple to use and to  provide you with a means of keeping track of your finances through a simple interface. The interface consists of a series of graphical tools that allow you to enter and retrieve data from the database with the minimum of fuss.

Because Puppy Money is designed to be simple the interface contains a series of buttons, labels and entry fields that have been written in plain English to enable you to understand easily what is required to use Puppy Money.

Puppy Money is designed to be installed and run in Puppy, if you wish to use it in any other version of Linux you will have to unpack the dotpup and install it by hand you will also have to compile sqlite for your version.

Back to top

Starting Puppy Money

When you start Puppy Money for the first time you will be presented with a main window containing a message to read this help file and the following menu buttons:

File
Create Account
Open Account
Help

             

The File button has a popdown menu with the following item:

    Close
   
The Create Account menu contains one item:

    Create New Account

The Open Account menu contains one item:
   
    Select Account

Note: Closing the main window will close all other Puppy Money windows that are open except for the Help, About  and Main Monthly Expenses Summary windows which must be closed by a left click on the X in the top right corner.

Create Account
Before you can start using Puppy Money you must create a personal account.

To create an account in Puppy Money click on the File menu then click on Create New Account. This will open another window that contains buttons and entry fields.
Note that except for the account selection box all selections in Puppy Money are accomplished by a single click on the left mouse button.

               

The menu buttons are File, Edit, Help and at the bottom of the window is a button, Create Account.
There is a button to allow you to select the currency of your country, note that this will display the international three letter code for the selected country and not a symbol i.e GBP for Great Britan.

The fields are for Name of account, Your Name, Address, Phone Number, Start Date and Start Balance.

The File menu only contains a Close entry, Edit has a Grab & Paste Text entry and Help has Help and About.

Entering Details

To enter details into the provided fields you can use use various methods. First ensure that the field that you wish to use has the flashing ibar in it.
This allows you type or paste into this field, to change to the next or another field use either the tab key at the left of the keyboard or use the mouse and left click in the field you wish to use.
 
 1. Type the information in using the keyboard.

 2. Use the Grab & Paste utility.
        If you have information in a document that you wish to enter open the document in a word processor and highlight the information you wish to use. Return to the Puppy Money window where you wish to enter the information and click on Edit/Grab & Paste, this will paste the information into the selected field.

 3. Use keystrokes to copy and paste.
         Follow the same procedure above but instead of using the mouse hit the c key while holding down the Ctrl key, ensure the field has the flashing Ibar by moving the mouse cursor over the Puppy Money window then hit the v key while holding down the Ctrl key.

The above instructions apply to all the different entry sections in Puppy Money.

      Currency
To select your currency click on the Currency button which will open a selection box with a listing of countries

                                             

click on a country then click the OK button at the bottom this will display the currency that you have selected.

                  


    Account Name 
Enter a name for your account using a single word, if you wished to use your name e.g. John then you would enter John.
An important point to remember is that you can create more than one account. If you enter a name that has been previously used you will receive a message informing you that the account already exists and to enter a different name. You can use any name but for display purposes try to keep it short.

                                                      
 

The name you enter will be displayed with the last two digits of the year that you enter i.e. john06. As you can see the name is displayed in lower case, this is not an error but a function of the backup procedure.

    Name
The name you use for the account and the owners name can be the same as the owners name does not affect the account.

    Address
Your address is not important it is just an identifier, you could enter your street name, city/town, state and country using abbrevations. This field is mainly to enable you to keep track of the location of different accounts.

    Postcode
Enter your postcode or zipcode or a four digit number if you do not have a postcode.

    Phone Number
Again this is just an identifier if you do not have a phone number just enter a number.

    Date
This field is important, make sure that you enter the correct date here and in the other entry windows using the format laid out below.
Enter the date using the format ( dd-mm-yyyy ) which means the date must be entered as the number of the day, the number of the month, and the number of the year i.e.

01-01-2006  the first of January 2006 or

26-02-2006   the twentysixth of February 2006

do not use any other format apart from this as Puppy Money will not recognize it and will produce an error message when you try to create your account:

                              

click OK and you will be returned to the create account window where you can re-enter the date.

Note: This message will appear every time you try to enter an incorrect date format in any of the other sections.


    Start balance
Enter the amount you wish to start your account with, if you are not using a starting balance just enter zero.

 When you have entered the details click on the Create Account button in the left hand bottom corner. Your account has now been created.

If you wish to close the window without saving your settings click on File/Close,

                                          

this will bring up a message asking if you wish to close without saving your settings or not.
Clicking Yes will close the window returning you to the main window.

You must fill in all the fields, if you fail to do so an error message will appear prompting you to fill all fields:

                                          


If you make any mistakes entering data such as dates and names you cannot remove this data from the database, wrong amounts can be adjusted by entering the same amount in the opposite entry format.

Wrong names or punctuation marks can only be removed by deleting the database and starting from the beginning using the reset menu option.

Once you have created your account it is time to start filling in the details of your income and expenses.


Back to top

Using Puppy Money

Select Account  

When you click on the Create Account button a selection box will open with your account listed in it, if you double click on your account using the left mouse button the account window will open.

                                                

Any additional accounts that are created can be opened in this box by a left mouse button click on 'Open Account' in the main Puppy Money window and then double clicking on the account name with the left mouse button.

The Account window

When the account window opens you will be presented with a message, the details of the selected account and a set of menu buttons.

             

The File menu contains:

    Close
    Remove
    Backup
    Restore

The Update Account menu contains:

    Add Income Details
    Add Expense Details
    Add Loans Details
    Add Loans Payments
    Add Insurance Details
    Add Insurance Payments

The View menu contains:

       View Details ___
                                  Monthly Summary  
                                  Main Costs
                                      Loans Details 
                                  Loans Payments
                                  Insurance Details
                                  Insurance Payments
                                  Income Details
                                  Balance Sheet  
    Find Details ___     
                                  Find by Date
                                  Find by Heading
 
The Help menu contains:

    Puppy Help
    About

Add Income Details

When you click on the OK button to create your account the 'Enter Income Details' window will open with fields to enter details of your income. There are two sections here, one for your main income and one for any additional income that you might have.

This window can be accessed in any account by clicking on 'Update Account / Add Income Details'

                 
 
The fields are simple enough:
Date: for the date on which you received the payment. 
Source: For the source of the payment e.g. your place of employment etc.
Amount: For the amount of the payment.
The same applies to the 'Other' income section.

For instructions on how to fill in the fields refer the previous section on 'Entering Details' .
 
You can fill in each section on its own and save the details separately, as before you must put an entry in each of the three fields, failure to do so will result in an error message.

                           

When you click on the Save .... button the following message will appear,

                        

If you have finished click Cancel if not click OK.
Clicking OK will clear the fields and allow you to enter fresh data.

To close the window at any time click on File/Close.

    Add Expense Details


To enter expense details click on 'Update Account' and from the dropdown menu click on 'Add expense Details', this will open the Expense entry window.

                         

There are preset fields in this window covering most areas of cost and a Misc field for any expense not included in this window.
This window does not require you to fill in all the fields but the date must be entered. When you have finished entering data click Save Expenses to save the details or File/Close to exit without saving.

    Add Loans Details

The next section deals with loans, click on 'Update Account / Loans Details' to open the loans details window.

                    

The 'Loan Details' window contains fields for four categories of loans, Personal, Credit Card, Car and House. The fields are as follows:

    Provider: This is who you have borrowed the money from e.g. Bank, Credit Company etc.
    Date: The date that the loan was obtained.
    Amount: The total amount that was borrowed.
    Duration: The time over which the loan must be repaid.
    Interest: The amount of interest that must be paid on the loan.
    Charges: Any charges that must be added to the loan.

Each loan can be saved separately so that if you only have one loan but acquire another one at a later date you can save the details at that time but you can only use each section once. If you attempt to reuse a loan section you will receive a warning  message informing you that the section has been closed, you can of course use a different unused section but when they have all been used you will have to go back to using pencil & paper.
Of course if you have more loans than are catered for here you obviously need a bigger financial program.

The first three fields must be filled in, failure to do so will result in an error message and nothing will be saved. If you do not need to fill in the last three fields just enter zeros otherwise you will receive an error message informing you that the fields are blank.
When you have finished filling in the details of the loan/loans click the Save button below the relevant loan.

Click File/Close to close the window at any time.

    Loan Payments

To record the payments you make on any loan click on 'Update Account / Add Loan Payments' to open the "Enter Loan Payment Details' window.

                     

 This window contains fields to record the date and amount of loan payments for different loans plus an Edit menu that contains a Grab and Paste section, there is also a link to this Help file in the Help menu.
 
Enter the date and amount and click on the save button relating to the type of loan. If you leave either field blank you will receive an error message.

Click on the File/Close button to close the window at any time and you will receive this message.


                                             


    Insurance Details
   
    Click on Add Insurance Details to add details of insurance that you may have. As in the loans section these are predefined areas and can only be used once so if you have a lot of different policies you probably need a bigger program to accommodate them.

                      

This section is the same as the rest, you must fill in each field, failure to do so will result in an error message. The same applies to the date format

    Insurance Payments

When you have filled in a section of the details you can add payments by clicking on Add Insurance Payments.


                                    

Here again if you fail to enter data in both fields you will receive messages reminding you to do so.

Back to top

Viewing entries

 Clicking on the 'View Details' menu selection will open a cascading menu containing the following submenus:

    View Details
                         Monthly Summary
                         Main Costs
                         Loans Details
                         Loans Payments
                         Insurance Details
                         Insurance Payments
                         Income
                         Balance Sheet

    Find Details
                         Find by Date
                         Find by Heading
   

  Monthly Summary       

This selection displays the 'Main entries' information in a spreadsheet format . The data is arranged as a summary of the monthly totals for each field with a complete monthly total in the green section on the left hand side.

Each field is also totaled at the bottom which results in a yearly total of each field in the green section.

Finally the sum of the totals is displayed in the bottom left hand corner. This total is only for the main entries, the loans details are displayed separately.

   

This display helps you keep a check on monthly expenses for your main costs.Click the X in the top left hand corner to close the window.

       Main Costs
       Main Costs displays the above information in a scrolling format and shows the cost of each item with a total for each column at the bottom. There is no total for all the items and no monthy totals, this information is displayed in the 'Monthly Summary' window.



There is a 'Save' button in the top left hand corner which can be used to create a file containing the data in these fields, this file can be opened in a spreadsheet and thus printed out.
This window helps you find the cost and entry date of each item in the main expenses section. Click the X in the top left hand corner to close the window.

         Loans Details
       The Loan Account Details window contains four buttons, one for each loan.
      

                  

Clicking on a button will open a scrollable display showing the details for the selected loan.displaying the information for each loan that you have regarding the following:

       Provider
       Date
       Amount
       Duration
       Interest
       Charges


                     

Click on the Ok button to close the window.
       Loans Payments
       This is another scrolling window that displays the payments and date for each loan that you have.

At the bottom of each loan Amount column is a Total field which shows the total of the payments already made to show how much has been already paid off each loan.


                     

Click OK to close the window.
       Income
       The details of your income, main and any other, are displayed in this scrolling window with the date , the source of the income and the amount. The totals are shown at the bottom of the window.


  

Click Ok to close the window.
        Balance Sheet
        The final selection in this section displays the starting and finishing dates , the total income and expenses and the starting and finishing balances of the account.      

If the account shows that the income exceeds the expenditure the figure will be displayed in black, if expenditure exceeds income the figure will be displayed in red.

                     

There is a 'Save' button in the bottom left hand corner that allows you to save the data for printing.
    Note: See the section on printing for further details.
Click Close to close the window.

Find Details

The 'Find Details' menu contains the following sections:

    Find by date
       When you click on the Find by date submenu a window opens containing the following:

             An 'Enter Date' field    
             A set of selection buttons
             A search button
             A Reset button

                  

   Enter Date: To search for an item in the main expenses table enter the date when the data was saved, click on the item you are searching for then click on Search.

       The results of your search will be displayed in the lower area of the window.

                  

   If you enter an invalid date i.e., one for which there is no amount saved, the Amount field will be blank.
   If you do not enter a date you will receive an Error message telling you to close the window and try again.
   If you enter a date with the wrong format you will receive an error message.
   Click on 'Close' to close the window.

    Find by Heading

    Clicking on the Find by Heading menu cause the following display to appear:

            

Click on the item you wish to find then click on 'Search' this will produce a dropdown scrollable display:

             
    
If you wish to search again simply click on the Reset  button.  

Back to top

Printing

Printing from Puppy Money is not possible at the moment but there is a workaround that will give you hard copies of some of your data.

To print a copy of the main expenses table simply click on the 'Save' button and then open up Gnumeric. Click on 'Open' either from the Open icon or 'File/Open', click on the file select button ( it probably says Spreadsheets ) then open /root/my-documents and locate the file that has your account name and ends in SVA i.e. if the account name is john look for johnSVA then click on Open at the bottom. This will display the data in a spreadsheet.
You will have to highlight the amounts and click on the 'Align left justify 'icon in the upper section of the window.

Save the file and print it out. If you do not have a working printer in Puppy save the file as an MS Excel document, this allows you to open the document in Excel and print it from there.

The same applies to the balance sheet simply click on ' Save ' then locate the file with the account name ending in SVB in my-documents and follow the same procedure as above.

Back to top

Backup Puppy Money


Because sqlite creates each database as a single file to do a backup is a simple matter of making a copy of that file. In Puppy Money a feature called Backup and Restore has been implemented.

When you wish to do a backup of your account simply click on 'File/Backup' in your account:

                

select where you wish to backup your data by left clicking on the appropiate button.
If you select 'Save to your computer' the data will be saved on your hard drive and you will receive a message:

                                    

click to close the message.

When you select 'Save to floppy disk' you will receive a message:

                           

use a new floppy disk if possible to avoid errors, label the disk insert it and click OK.
Wait until you receive the message:

                           

you may now remove the floppy disk, do not attempt to remove the disk while writing is in progress as indicated by the floppy light being on.
Removing the floppy disk before  being told to do so may result in an incomplete backup and corruption of data.

Restoring from Backups

To restore from your backups click on File/Restore this will open the Restore window with the options to restore from your computer or a floppy disk.

                              

If you have saved you backup to your computer click the 'Restore from your computer' button to restore your data. When the data is sucessfully restored you will receive a message.

                              

If you try to restore without previously saving you will receive a message similar to the one below.

               

To restore from a floppy click on the 'Restore from floppy disk' button which will display this message:

                                 

of course the name will not be the same (unless your account name is bill) but will be the name of the account that you have open.
When the data is restored you will receive a message.

                                 

If there are any problems you will receive error messages and the data will not be restored.

Troubleshooting Puppy Money

One of the first things most people like to do with a new program is explore it but in Puppy Money this can lead to a rash of error messages as the database must have tables in it before they can be read.
These tables are only created when the account is created so you must first create an account and populate the tables with entries.

If you have entered the wrong amount in any of the fields you can rectify this by putting a minus entry in the same section i.e.


If you have entered an extra $20 in the expenses section just  enter -20 in the same field.
If you wish to start over again because the entries  are wrong or you have mixed things up simply click on File in the main window and click on 'Remove', This will remove the database and allow you to start from the beginning, you will receive a message telling you to click Yes to proceed or No to exit.


If you receive any other error messages not covered in this help section just click Ok, close Puppy Money and start over again.

If you have problems read the Help file first then either PM me, Ian, on the forum or email me at [ ian@puppylinux.org ].

Disclaimer

Because Puppy Money is designed to be installed and run in Puppy I can give no guarantee that it will run in any other Linux distro.
Puppy Money was written in Chubby Puppy 1.0.4 and tested in Puppy 1.0.7 but I give no guarantee that it will run on your Puppy setup or that it will not destroy your installation. If you have any doubts back up your data before attempting to install and use Puppy Money.

Back to top