Budget management


Table of Contents

Author
Introduction
I. Application date
1. Set the application global date
II. File operations
2. Export a document in XML format
III. Funds operations
3. Store a new fund
4. Remove a fund
5. Modify the value of a fund
6. Set the total budget value
7. Set the default fund
IV. Profits and expenses
8. Store a profit
9. Store an expense
10. Edit the categories
V. Objects operations
11. Objects reception and donations
Store an object reception
Store an object donation
12. Lent objects
Store an object loan
Store the return of a previously lent object
13. Borrowed objects
Store the loaning of an object
Store the return of a previously borrowed object
VI. Alarms
14. Alarms
VII. Credits
15. Store a new credit
16. Remove a credit
17. Remit a credit
VIII. Debts
18. Store a new debt
19. Remove a debt
20. Remit a debt
IX. Shopping list
21. Add an item to the shop-list
22. Remove an item from the shop-list
X. Utilities
23. Program customization
24. Document creation wizard - OmbWizard
25. Export archive
A. History

List of Tables

A.1. Change log

Author

Introduction

OpenMoneyBox 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.

Definitions

  • Fund: every kind of saving e.g. cash, a bank account, where you add your income and such;
  • Credit: money other people owe you;
  • Debt: money you owe to somebody else.

Note

The screenshots for this manual have been created using a Z00VD, a FRD-L09 and a FP3 smartphones.

Part I. Application date

Chapter 1. Set the application global date

Set the application global date using related calendar box in the dashboard tab.

All operations will use this date.

Part II. File operations

Chapter 2. Export a document in XML format

Tap the button Export XML to export the active document in XML format.

Part III. Funds operations

Chapter 3. Store a new fund

Tap the button New fund int the Funds tab to store a new fund.

Type in the first edit box the name to identify the new fund: it will be added to the list view.

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.

Related topics: Set the defaut fund.

Chapter 4. Remove a fund

Select from the list int the Funds tab the fund to be removed.

Tap the button Remove fund to remove a previously stored fund.

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.

Related topics: Set the default fund.

Chapter 5. Modify the value of a fund

Select from the listview int the Funds tab the fund you want to modify the value of.

Tap the button Reset fund to modify the value of a previously stored fund.

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.

Related topics: Set the default fund.

Chapter 6. Set the total budget value

Tap the options menu item 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.

Related topics: Set the default fund.

Chapter 7. Set the default fund

Tap the options menu item 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 list the fund you want to specify as default.

Part IV. Profits and expenses

Chapter 8. Store a profit

Tap the button Profit in the Dashboard tab to store a profit.

Select from the dropbox 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).

Default currency.  Uncheck this box to use a custom currency for the operation. Insert the currency symbol in the first edit box. Insert the change rate in the second edit box.

Select from the last dropbox the optional category for the operation.

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

Chapter 9. Store an expense

Tap the button Expense in the Dashboard tab 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).

Default currency.  Uncheck this box to use a custom currency for the operation. Insert the currency symbol in the first edit box. Insert the change rate in the second edit box.

Select from the last dropbox the optional category for the operation.

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

Chapter 10. Edit the categories

Tap the options menu item Edit categories to add or remove categories.

Categories can be added to profits and expenses so they can be better organized.

Part V. Objects operations

Chapter 11. Objects reception and donations

Store an object reception

Tap the button Received object in the Dashboard tab 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.

You can browse for a phone contact by tapping on the magnifier button.

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

Store an object donation

Tap the button Given object in the Dashboard tap to store an object donation.

Type in the first edit-box the donated object.

Type in the second edito-box the object receiver.

You can browse for a phone contact by tapping on the magnifier button.

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

Chapter 12. Lent objects

Store an object loan

Tap the button Lend object in the Objects tab to store an object loan.

Type in the first edit-box the lent object.

Type in the second edit-box the object receiver.

You can browse for a phone contact by tapping on the magnifier button.

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

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

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

Store the return of a previously lent object

Select from the list view the lent object.

Tap the button Get back object in the Objects tab to store the return of a previously lent object.

The lent object will be cancelled from the list view.

Chapter 13. Borrowed objects

Store the loaning of an object

Tap the button Borrow object in the Objects tab 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.

You can browse for a phone contact by tapping on the magnifier button.

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

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

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

Store the return of a previously borrowed object

Select from the list view the borrowed object.

Tap the button Give back object in the Objects tab to store the return of a previously borrowed object.

The borrowed object will be cancelled from the list view.

Part VI. Alarms

Table of Contents

14. Alarms

Chapter 14. Alarms

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

Part VII. Credits

Chapter 15. Store a new credit

Tap the button Set credit in the Credits tab to store a new credit.

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

You can browse for a phone contact by tapping on the magnifier button.

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.

Keep current budget.  Check this box to store the credit or debit without changing your budget. This is useful to store exchanges made in the past.

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

Chapter 16. Remove a credit

Tap the button Remove credit in the Credits tab 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.

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

Chapter 17. Remit a credit

Tap the button Remit credit in the Credits tab to remit a previously stored credit.

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

Remove:

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

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

Part VIII. Debts

Chapter 18. Store a new debt

Tap the button Set debt in the Debts tab to store a new debt.

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

You can browse for a phone contact by tapping on the magnifier button.

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.

Keep current budget.  Check this box to store the credit or debit without changing your budget. This is useful to store exchanges made in the past.

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

Chapter 19. Remove a debt

Tap the button Remove debt in the Debts tab 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.

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

Chapter 20. Remit a debt

Tap the button Remit debt in the Debts tab to remit a previously stored debt.

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

Remove:

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

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

Part IX. Shopping list

Chapter 21. Add an item to the shop-list

Tap the button Add shop-list item in the Shopping List tab 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.

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

Chapter 22. Remove an item from the shop-list

Select from the list view the item to be removed.

Tap the button Remove shop-list item in the Shopping List tab to remove a previously stored item from the shop-list.

Part X. Utilities

Chapter 23. Program customization

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

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

  • Default document: type the full path of default document;
  • Password: type in the edit box the default document password;
  • 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;
  • Prefix for generated documents: type the prefix you want to use for your documents, when generating xml's or backups;
  • Save positions: check this box to save known positions for operations.

Chapter 24. Document creation wizard - OmbWizard

OmbWizard is a tool for the assisted creation of OpenMoneyBox documents.

First time OpenMoneyBox is started - or whenever there is no default document set - a dialog allows to browse for an existing OpenMoneyBox document or to run OmbWizard.

Tap the button Document creation Wizard to create a new document using OmbWizard assisted procedure.

Chapter 25. Export archive

Tap the options menu item Export archive to export a copy of the local master archive into the local file storage.

Appendix A. History

Table A.1. Change log

DATEVERSIONDESCRIPTION
23/03/20243.4.2.10
  • First run dialog sequence improved;
  • fixed crash on first run password input;
  • Privacy policy added;
  • migrate to sqlcipher-android.
03/03/20243.4.2.9Fixed Crash on Alarm Notification on Android S and higher [gitlab #35].
23/02/20243.4.2.8
  • Fixed tracker detected in source code [gitlab #31];
  • XmlSerializer now used for XML export;
  • AndroidChart 3.1.0.21.
14/01/20243.4.2.7
  • Fixed missing widgets in Dashboard screen [gitlab #32];
  • Chart screen look improved;
  • osmdroid 6.1.18.
19/12/20233.4.2.6
  • Added splash screen colors;
  • Removed unused permissions (Phone and Network status);
  • compileSdk 34;
  • AndroidChart v3.1.0.18;
  • osmdroid 6.1.17.
05/08/20233.4.2.5
  • Fingerprint class lowered for Android 13 on certain devices;
  • Notification permission added for Android 13.
30/05/20233.4.2.4AndroidChart 3.1.0.15.
02/05/20233.4.2.3sqlcipher 4.5.4.
15/04/20233.4.2.2osmdroid 6.1.16.
19/03/20233.4.2.1
  • Graph trend color based on first date value;
  • sqlcipher 4.5.3.
11/11/20223.4.1.18Style and look improved [#30].
15/10/20223.4.1.17
  • Memory leak fixed [#28];
  • English translation improved [#29];
  • Swedish translation updated, thanks to Simon Nilsson (simon@ordskiftet.se);
  • sqlcipher 4.5.2;
  • osmdroid 6.1.14.
20/07/20223.4.1.16
  • Fixed objects names in notifications [#26];
  • Added generic image in case contact picture is not available [#27].
21/05/20223.4.1.15
  • Fixed Map Marker bubbles not readable in dark mode [#6];
  • Fixed crash on postponing alarms [#25];
  • Fixed dark mode for alarms;
  • Swedish translation updated, thanks to Simon Nilsson (Simon@Observeramera.com);
  • osmdroid 6.1.13.
30/04/20223.4.1.14
  • User authentication added [#23];
  • Show 2 decimal digits in chart values [#21];
  • Fix unreadable text with dark theme [#22];
  • Notifications start on boot;
  • Swedish translation added, thanks to Simon Nilsson (Simon@Observeramera.com);
  • Code refreshed (removed deprecations).
08/03/20223.4.1.13
  • Fixed crash in Edit Categories [gitlab #19];
  • Fixed clumsy items in Edit Categories [gitlab #20];
  • About dialog readability improved;
  • sqlcipher 4.5.1.
15/08/20213.4.1.11
  • Global file permission fixed on Android 11 [gitlab #13];
  • Fixed crash when active locale has non-latin numbers [gitlab #16];
  • Italian translation updated;
  • sqlcipher 4.4.3;
  • osmdroid 6.1.11;
  • New icon for Add Shopping-list item.
06/04/20213.4.1.10Spanish translation added (thanks to einerds@nauta.cu).
27/03/20213.4.1.9Fixed crash on entering the Map view [gitlab #15].
26/03/20213.4.1.8Added the capability to store old debits and credits.
28/02/20213.4.1.7
  • Fixed crash on open on Android 10 [gitlab #14];
  • Top Categories color contrast improved [gitlab #12].
05/02/20213.4.1.6
  • Top categories improved when less than three items are shown;
  • Shopping List user interface improved;
  • dark theme refined;
  • sqlcipher v4.4.2;
  • osmdroid v6.1.10.
22/11/20203.4.1.5
  • Fixed crash for Credits and Debts [gitlab #8];
  • Fixed crash on searching contacts [gitlab #9];
  • Fixed crash on storing objects [gitlab #10];
  • sqlcipher v4.4.1.
16/08/20203.4.1.4
  • Fixed crash during creation wizard;
  • Dialog UI refreshed;
  • Bug report link updated;
  • Fixed missing translation;
  • osmdroid v6.1.8;
  • sqlcipher v4.4.0.
09/03/20203.4.1.3
  • Fixed crash due to old master format [gitlab #5];
  • osmdroid v6.1.5;
  • sqlcipher v4.3.0.
04/12/20193.4.1.1
  • Category icons and Top categories added;
  • fix LP #1848840 - Wrong category id assigned in operation;
  • fix LP #1848370 - Custom currency fields not exported in archive;
  • dark theme refined;
  • osmdroid v6.1.4.
04/09/20193.3.1.7Fixed crash during wizard [gitlab #3].
11/08/20193.3.1.6
  • sqlcipher v4.2.0;
  • deprecate omb31x format.
26/05/20193.3.1.4Fixed error on profit or expense [gitlab #2].
21/05/20193.3.1.3
  • Battery consumption improved (location stop on exit);
  • dark theme improved;
  • osmdroid v6.1.0;
  • MPAndroidChart v3.1.0.
07/04/20193.3.1.2Fixed crash on startup.
02/04/20193.3.1.1
  • Encryption added;
  • launcher shortcuts added.
08/12/20183.2.2.10
  • Keep active page on rotation;
  • osmdroid v6.0.3.
01/12/20183.2.2.8XML export fixed (quotes in values).
24/11/20183.2.2.7Dark theme improved.
19/11/20183.2.2.6
  • Improved theme;
  • Dark theme added.
30/09/20183.2.2.4Contact information update when contacts are changed in the phone.
28/08/20183.2.2.3
  • Oreo notifications;
  • improved dialogs.
23/08/20183.2.2.2Fixed crash if null contact photo.
07/08/20183.2.1.3Fixed bug LP #1785375 - Crash on startup.
01/08/20183.2.1.2
  • Fixed bug LP #1779746 - Crash during monthly backup;
  • document browser fixed;
  • simplified dialogs.
04/06/20183.2.1.1
  • added support for phone contacts;
  • added storage of locations;
  • fixed bug LP #1737495 - Shoplist item not removed when confirmed on external alertBox.
30/10/20173.1.2.5
  • fixed crash on BACK press;
  • publication in F-Droid.
18/10/20173.1.2.4Check write permission on startup.
20/08/20173.1.2.3Fixed bug LP #1711917 - Wizard malformed document.
06/08/20173.1.2.2Updated chart rendering.
02/06/20173.1.2.1
  • Renamed to OpenMoneyBox and rebranded;
  • Feature LP #1664378 - User setting for export prefix;
  • Fixed bug LP #1664735 - Wrong export folder name.
27/12/20163.1.1.3Report with cards.
09/12/20163.1.1.2XML Export improved.
27/11/20163.1.1.1Version 3.1 (Linux, Windows and Android)
02/06/20163.0.2.9
  • fixed bug https://goo.gl/91Hzuf;
  • Lollipop notification icon improved;
  • Lollipop Material theme.
02/05/20163.0.2.8
  • Lollipop notification icon fixed;
  • report visualization improvement;
  • fixed file manager integration crash;
  • bug report menu item added.
02/04/20163.0.2.6Translation added to XML export notification.
28/02/20163.0.2.5Fixed default fund dialog selection.
02/01/20163.0.2.4Fixed bug https://goo.gl/4EXWVY.
30/12/20153.0.2.3Fixed bug https://goo.gl/97HzE5.
06/12/20153.0.2.2
  • license screen added;
  • check if shop item already exists when adding a new one.
12/11/20153.0.2.1Android first version.