Budget management

igi SW


Table of Contents

Author
Introduction
History
I. Application time and date
1. Set the application global date
II. File operations
2. Save a document
3. Revert document changes
4. Export a document in XML format
5. Browse the master archive
6. Exit the program
III. Monthly report operations
7. Copy part of the report
8. Find a text portion in the report
IV. Funds operations
9. Store a new fund
10. Remove a fund
11. Modify the value of a fund
12. Set the total budget value
13. Set the default fund
V. Profits and expenses
14. Store a profit
15. Store an expense
16. Add a category to the report
17. Edit the list of categories
VI. Objects operations
18. Objects reception and donations
Store an object reception
Store an object donation
19. Lent objects
Store an object loan
Store the return of a previously lent object
20. Borrowed objects
Store the loaning of an object
Store the return of a previously borrowed object
VII. Alarms
21. Alarms
VIII. Credits
22. Store a new credit
23. Remove a credit
24. Condone a credit
IX. Debts
25. Store a new debt
26. Remove a debt
27. Condone a debt
X. Shopping list
28. Add an item to the shop-list
29. Remove an item from the shop-list
XI. Utilities
30. Program customisation
'General' page
'Charts' page
'Strings' page
'Advanced' page
'External tools' page
31. Alarm management utility - Biltray
32. Document creation wizard - BilWizard
33. Old document converter
34. Import document
35. Web Update - BilUpdate
A. Shortcuts

List of Tables

1. Change log

Author

Introduction

Bilancio is an application designed to manage small personal money budgets in the easiest way.

The idea was born when my informatic system was made by the awesome AMIGA 500. It managed through a basic interface and a dropdown menu a file containing three small arrays:

  • Funds
  • Credits
  • Debts

At the end of each month it generated a text document where all management operations were stored.

The basic idea is still substantially the same.

History

Table 1. Change log

DATEVERSIONDESCRIPTION
10/01/20163.0.2.5
  • Fixed bug LP #1654686 - Trend chart not created for master archive;
  • XDG Base Directory Specification for user paths;
  • Update library included for Fedora and OpenSuse.
02/01/20163.0.2.4
  • Fixed bug LP #1653461 - Master database wrongly reported;
  • Fixed bug LP #1578367 - Biltray icon size.
09/12/20163.1.1.2Export XML from archive.
27/11/20163.1.1.1Version 3.1 (Linux, Windows and Android)
18/07/20163.0.2.10Fixed bug LP #1603966 - Criptography on 32-bit machines.
02/06/20163.0.2.9Fixed bug LP #1588070 - Malformed XML.
03/04/20163.0.2.7Bilconvert deadlock resolved.
29/02/20163.0.2.5Solved crash when adding operations on leap day.
06/12/20153.0.2.2
  • new branding logo;
  • license added in AboutBox;
  • check if shop item already exists when adding a new one;
  • minor improvements.
29/08/20153.0.2.1Android support.
08/03/20153.0.1.5Scalable icons added (hicolor set).
08/02/20153.0.1.4Minor improvements.
04/01/20153.0.1.3Fixed bug LP #1407419 - external tools management.
08/12/20143.0.1.2Fixed bug in object deletion.
05/11/20143.0.1.1Version 3.0 (Linux and Windows)

Part I. Application time and date

Chapter 1. Set the application global date

Set the application global date using related calendar box on the right of the the main window.

Set application global time using the time picker on the right of the main window.

All operations will use this date and time unless the user specifies to use system time.

Part II. File operations

Chapter 2. Save a document

Click the menu item File ->Save or related button in the toolbar) to save a document.

If the document is saved for the first time since its creation, the dialog window to choose the document name will appear.

If the document password is not set, the dialog window to choose it will appear.

Shortcut: CTRL+S .

Related topics: Set or modify the document protection password.

Chapter 3. Revert document changes

Click the menu item File -> Revert to reopen a document, losing all changes.

Warning

All changes will not be recovereable.

Chapter 4. Export a document in XML format

Click the menu item File -> Export XML to export the active document in XML format.

Chapter 5. Browse the master archive

Click the menu item File -> Browse archive to browse the master archive.

When this menu is checked, it is possible to browse the archive using the calendar on the right side of the window. Selecting a month, items and operation stored for that month will be shown.

Chapter 6. Exit the program

Click the menu item File ->Exit> to exit the program.

Shortcut: CTRL+E

Part III. Monthly report operations

Chapter 7. Copy part of the report

Click the menu item Edit -> Copy (or the related button in the toolbar) to copy currently selected line of the monthly report in Linux clipboard.

Shortcut: CTRL+C

Chapter 8. Find a text portion in the report

Click the menu item Edit ->Find (or the related button in the toolbar) to find specified text in the monthly report, starting from currently selected position.

Shortcut: CTRL+T

Part IV. Funds operations

Chapter 9. Store a new fund

Click the menu item Funds -> New (or the related button in the toolbar) to store a new fund.

Type in the first edit box the name to identify the new fund: it will be added in the list on the left of the client window.

Type in the second edit box the value to be assigned to the fund: it will be subtracted to the default fund; in case the specified value is bigger of that fund an error message will be shown.

In case of missing or wrong data entry an error message will be shown.

Shortcut: CTRL+ALT+N

Related topics: Set the defaut fund.

Chapter 10. Remove a fund

Click the menu item Funds ->Remove (or related button in the toolbar) to remove a previously stored fund.

Select from the dropbox the fund to be removed: it will be removed from the list in the left of the client window.

The value of removed fund will be added to the default fund.

In case of missing or wrong data entry an error message will be shown.

Shortcut: CTRL+ALT+R

Related topics: Set the default fund.

Chapter 11. Modify the value of a fund

Click the menu item Funds ->Reset to modify the value of a previously stored fund.

Select from the dropbox the fund of which you want to modify the value.

Type in the edit-box the new value of the fund.

The difference between previous and new values will be added or subtracted from the default fund.

In case of missing or wrong date entry an error message will be shown.

Shortcut: CTRL+ALT+I

Related topics: Set the default fund.

Chapter 12. Set the total budget value

Click the menu item Funds -> Set total to change the complete current budget value.

Type in the edit box the new budget value.

The difference between the new and previous values will be added to or subtracted from the default fund.

In case of missing or wrong data entry an error message will be shown.

Note

This function is useful only to increase the budget value. It cannot be decreased, unless if done with the Expense function.

Shortcut: CTRL+ALT+T

Related topics: Set the default fund.

Chapter 13. Set the default fund

Click the menu item Funds -> Default fund to set the budget default fund.

The default fund is the one gains, expenses and changes to other funds are added or subtracted to, unless a different one is specified during the storing of these operations.

Select from the dropbox the fund you want to specify as default.

Shortcut: CTRL+ALT+P

Part V. Profits and expenses

Chapter 14. Store a profit

Click the menu item Operations -> Profit (or the related button in the toolbar) to store a profit.

Select from the drop-box the fund to add the profit to.

Type in the first edit box the value to add to the fund.

Insert in the second edit box the reason of this profit (required).

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data entry an error message will be shown.

Shortcut: F2

Chapter 15. Store an expense

Click the menu item Operations -> Expense (or the related button in the toolbar) to store an expense.

Select from the dropbox the fund to subtract the expense from.

Type in the first edit box the value to subtract from the fund.

Type in the second edit box the reason of this expense (required).

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data entry an error message will be shown.

Shortcut: F3

Chapter 16. Add a category to the report

Click the menu item Operations -> Category (or the related button in the toolbar) to add a category in the monthly report.

Select the desired category from the dropdown list.

Chapter 17. Edit the list of categories

Click the menu item Operations -> Edit categories to edit the personal list of categories.

Enter a category and click the Add button to add a new category.

Select a category in the list and click the Remove button to remove that category.

Part VI. Objects operations

Chapter 18. Objects reception and donations

Store an object reception

Click the menu item Objects -> Received (or the related button in the toolbar) to store the reception of an object.

Type in the first edit-box the received object.

Type in the second edit-box the donor of the object.

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data entry an error message will be shown.

Shortcut: SHIFT+F1

Store an object donation

Click the menu item Objects -> Given (or the related button in the toolbar) to store an object donation.

Type in the first edit-box the donated object.

Type in the second edito-box the object receiver.

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data entry an error message will be shown.

Shortcut: SHIFT+F2

Chapter 19. Lent objects

Store an object loan

Click the menu item Objects -> Lend (or the related button in the toolbar) to store an object loan.

Type in the first edit-box the lent object.

Type in the second edit-box the object receiver.

If it is necessary to set an alarm for the object, mark the alarm checkbox and select the loan expiration date.

Note

This function is useful only if the Alarm Management Utility is installed..

The borrowed object will be visible under the name of who borrowed the object.

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data entry an error message will be shown.

Shortcut: SHIFT+F3

Store the return of a previously lent object

Click the menu item Objects -> Get back (or the related button in the toolbar) to store the return of a previously lent object.

Select from the first drop-box the lent object.

Select from the second edit-box the object receiver.

The lent object will be cancelled from the client window.

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data entry an error message will be shown.

Shortcut: SHIFT+F4

Chapter 20. Borrowed objects

Store the loaning of an object

Click the menu item Objects -> Borrow (or the related button in the toolbar) to store the loaning of an object.

Type in the first edit-box the borrowed object.

Type in the second edit-box the name of who lent the object.

If it is necessary to set an alarm for the object, mark the alarm checkbox and select the loan expiration date.

Note

This function is useful only if the Alarm Management Utility is installed..

The borrowed object will be visible under the name of who lent the object.

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data entry an error message will be shown.

Shortcut: SHIFT+F5

Store the return of a previously borrowed object

Click the menu item Objects -> Give back (or the related button in the toolbar) to store the return of a previously borrowed object.

Select from the first drop-box the borrowed object.

Select from the second edit-box the object lender.

The borrowed object will be cancelled from the client window.

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data entry an error message will be shown.

Shortcut: SHIFT+F6

Part VII. Alarms

Table of Contents

21. Alarms

Chapter 21. Alarms

Lent and borrowed objects, credits, debts and shop-list items can contain an alarm. If BilTray, component is installed, a message will be generated if this alarm is expired.

Part VIII. Credits

Chapter 22. Store a new credit

Click the menu item Credits -> Set (or the related button in the toolbar) to store a new credit.

Type in the first edit ox the name of new credit (usually the debtor name).

Type in the second edit box the credit value. If a credit with this name already exists the new inserted value will be added to the one previously stored.

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data entry an error message will be shown.

Shortcut: CTRL+ALT+C

Chapter 23. Remove a credit

Click the menu item Credits -> Remove (or the related button in the toolbar) to remove a previously stored credit.

Select in the drop-box the credit to be modified or removed.

Remove:

  • the whole value: completely removes the credit;
  • partially: removes only a part of the credit. In this case, type in the edit box below the collected amount of money.

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data entry an error message will be shown.

Shortcut: CTRL+ALT+A

Chapter 24. Condone a credit

Click the menu item Credits -> Condone (or the related button in the toolbar) to condone a previously stored credit.

Select in the drop-box the credit to be condoned.

Remove:

  • the whole value: completely condones the credit;
  • partially: condones only a part of the credit. In this case, type in the edit box below the condoned amount of money.

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data entry an error message will be shown.

Part IX. Debts

Chapter 25. Store a new debt

Click the menu item Debts -> Set (or the related button in the toolbar) to store a new debt.

Type in the first edit ox the name of new debt (usually the creditor name).

Type in the second edit box the debt value. If a debt with this name already exists the new inserted value will be added to the one previously stored.

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data entry an error message will be shown.

Shortcut: CTRL+ALT+D

Chapter 26. Remove a debt

Click the menu item Debts -> Remove (or the related button in the toolbar) to remove a previously stored debt.

Select in the drop-box the debt to be modified or removed.

Remove:

  • the whole value: completely removes the debt;
  • partially: removes only a part of the debt. In this case, type in the edit box below the collected amount of money.

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data entry an error message will be shown.

Shortcut: CTRL+ALT+B

Chapter 27. Condone a debt

Click the menu item Debts -> Condone (or the related button in the toolbar) to condone a previously stored debt.

Select in the drop-box the debt to be condoned.

Remove:

  • the whole value: completely condones the debt;
  • partially: condones only a part of the debt. In this case, type in the edit box below the condoned amount of money.

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data entry an error message will be shown.

Part X. Shopping list

Chapter 28. Add an item to the shop-list

Click the menu item Shop-List -> Add item (or the related button in the toolbar) to store a new shop-list item.

Insert in the text box the object to de added in the shop-list.

If you want to set an alarm for this item, mark the alarm checkbox and select the expiration day.

Note

This function is useful only if theAlarm Management Utility is installed.

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data, an error message will appear.

Shortcut: F5

Chapter 29. Remove an item from the shop-list

Click the menu item Shop-List -> Remove item (or the related button in the toolbar) to remove a previously stored item from the shop-list.

Select from the drop-box the item to be removed.

Use system time.  Check this box to store the operation with the system time instead of time selected in the client window.

In case of missing or wrong data, an error message will appear.

Shortcut: F6

Part XI. Utilities

Chapter 30. Program customisation

The program can be customised through the menu item Tools -> Options.

The dialog window will be shown, where it is possible to choose settings.

'General' page

  • Default document: type the full path of default document or click the Browse button to search it;

    Note

    This function is useful only if the Alarm management utility is installed..
  • Show command toolbar: check this box to show the command toolbar;
  • Show splashscreen: check this box if you want the presentation dialog is shown on program startup;
  • Automatically convert as XML at the end of each month: check this box if you want the program to convert documents to XML on month change;
  • Enable tray-bar icon: check this box if you want to run the Alarm management utility on program shutdown to work in background.

    Note

    This function is useful only if the Alarm management utility is installed..

'Charts' page

  • Show fund chart: check this box if you want to show the pie chart related to bugdet distribution;
  • Show trend chart: check this box if you want to show the chart related to budget trend in current month;

'Strings' page

This page allows to customise string to identify various operation types with, in order to be shown in the monthly report and in documents converted as text.

'Advanced' page

  • Search for new version on startup: check this box if you want the program to verify online the availability of possible updates

    Note

    This function is useful only if the Web update Utility is installed.

'External tools' page

Click the Add button to browse and add an application or document as an external tool.

Select an external tool in the list and click the Remove button to remove it from the list.

Stored external tools can be accessed through the menu item Tools -> External tools.

Shortcut: CTRL+O

Related topics: Alarm management Utility; Web update Utility.

Chapter 31. Alarm management utility - Biltray

BilTray is an additional component for expirations management.

If it has been installed, it is possible to add an alarm when a credit or a debt is created, or when an object loan or borrow or a shop.list item is set.

When one or more alarms expire, BilTray will pop a message up. It will be possible to postpone or remove the expired alarm.

Note

In order for BilTray to be active, it is necessary to set a default document.

Chapter 32. Document creation wizard - BilWizard

BilWizard is an additional component for the assisted creation of a Bilancio document.

Click the menu item Tools -> Document creation Wizard to create a new document using BilWizard assisted procedure.

Chapter 33. Old document converter

BilConvert is an additional component for the assisted conversion of an old Bilancio document.

Click the menu item Tools -> Old document converter to convert an old document.

Chapter 34. Import document

Click the menu item Tools -> Import to import a Bilancio document into the master database.

Chapter 35. Web Update - BilUpdate

BilUpdate is an additional component for the verification of online program updates.

If activated, it will verify on startup the availability of possible updates and will announce them.

Related topics: Program customisation.

Appendix A. Shortcuts

CTRL+A: open a saved document

CTRL+ALT+A: remove or modify a previously stored credit

CTRL+ALT+B: remove or modify a previously stored debt

CTRL+ALT+C: store a credit

CTRL+ALT+D: stores a debt

CTRL+ALT+I: reset the value of a previously stored fund

CTRL+ALT+N: store a new fund

CTRL+ALT+P: set the default fund

CTRL+ALT+R: delete a previously stored fund

CTRL+ALT+T: modify the total budget amount

CTRL+C: close active document

CTRL+E: exit the program

CTRL+N: create a new document

CTRL+O: open the application option dialog

CTRL+P: set the protection password of the active document

CTRL+S: save the active document

CTRL+T: search for a text in the monthly report

F2: store a profit

F3: store an expense

F5: add an item to the shop-list

F6: remove an item from the shop-list

SHIFT+F1: store the reception of an object

SHIFT+F2: store the donation of an object

SHIFT+F3: store an object borrow

SHIFT+F4: store the restitution of a lent object

SHIFT+F5: store an object loan

SHIFT+F6: store the restitution of a borrowed object