Saturday, August 6, 2011

iFreeBudget - Android documentation


Introduction

iFreeBudget is free, open-source expense tracking and budget application for Android platform. A full featured desktop version is also available.

Accounts and Categories:

Accounts are maintained in a hierarchy similar to a file system folder structure. Category is similar to a folder and an account is analogous to a file.

There are four base categories:
  1. Assets
  2. Income
  3. Expense
  4. Liabilities
Assets category will contain all accounts that contribute positively to personal equity. Examples are checking accounts, savings accounts etc.

Income category will contain all income accounts like Payroll, Interest earned, Dividends etc.

Expense category will contain all expense accounts like bills, purchases, personal expenses etc.

Liabilities category will contain all accounts that contribute negatively to personal equity. Examples are credit cards, loans, mortgages.

Accounts and categories can be created under any of the top level categories. Categories can also be nested under other categories. Accounts are created within categories. This provides flexibility in organizing accounts.

For example expenses can be organized as shown:

Category - Expense
     Category - Auto expenses
          Category - Gas
               Account - Honda
               Account – Toyota
Accounts are identified by this icon.





Categories are identified by this icon





Transactions


A transaction is transfer of funds from one account to another. There are always two components to a transaction, a source account and a destination account. Transactions can be categorized by types (income, expense, transfer).

For recording an income, the source account is always one of the accounts under Income category or its children and the destinations is always one of the accounts under “Asset” category or its children.

For recording an expense, the source account is always one of the accounts under “Asset” or “Liability” category or its children and the destinations is always one of the accounts under “Expense” category or its children.

All other types of transactions can be recorded using the “Transfer” type. For this type there is no restriction on source and destination accounts.

Viewing transactions

Click on "Transactions" icon on the main screen.



Budgets

A Budget is a grouping of accounts. Budgets are of type weekly, bi-weekly, monthly and accounts in the budged are allocated amounts, which is the amount you want to spend on the specified account for the specified time period.

Click on "Budgets" icon on the main screen and then click on "+" icon on top of the screen to create a new budget. Give a name for the budget and select accounts you want to include in the budget by tapping the account in the list and entering the allocated amount for that account.




Cash flow report

Cash flow report shows a normalized view of all transactions for a specified time period. Report can be viewed for a weekly or monthly range.

Backups

You can backup the existing data to the SD card on the device. Click "Backup" icon on the main screen and click on "+" icon on top of the screen to backup the current data. 

The backups screen shows a list of previously saved backups. Each entry in the list is identified as a date-time value, which is the time at which the backup was created. Long click on an item in the list to bring up the context menu for each backup. 

"Use this backup" selection will replace the current data with the backed up version.
"Delete" will remove the backup from the SD card.

Monday, April 19, 2010

Linux packages

Linux packages for debian and rpm based systems are available at:


Debian / ubuntu: http://www.getdeb.net/app/iFreeBudget

RPM : http://packman.links2linux.org/package/iFreeBudget

The available packages sometimes are a few days behind the official releases.

Thanks to the respective packagers/distributors!!!

Wednesday, February 3, 2010

How to run iFreeBudget on a Mac

I do not own a Mac, so I cannot say if this is the best and/or easiest way to do this.
Thanks to user John Jackson for these instructions.  
"It works on Mac OSX Leopard. Apple includes several versions of the VM in their Java releases for OSX 10.5 (Leopard) - 1.5, and 1.6 are still being actively worked on.
You can go here if you don''t have the latest:
http://developer.apple.com/java/
You need to change the JAVA_CMD environmental to use 1.6 instead of 1.5.
First, make sure you have 1.6.
Open a termainal (Applications->Utilities->Terminal).
At the prompt paste the following line and hit file
/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Commands/java.
If you get the message "(No such file or directory)" then you do NOT have java 1.6, otherwise you''ll get a message telling you what kind of file "java" is
( on my architecture it says "Mach-O 64-bit executable x86_64" but yours may be different).
So, we have Java 1.6, but how do we make iFreeBudget use it?
We have to change the "run.sh" script so that it points to the 1.6 VM.
Open "run.sh" with vi, nano, whatever you like.
Skip down to the "export JAVA_CMD" line - near the bottom.
Insert the following line AFTER the "export JAVA_CMD":
export JAVA_CMD=/System/Library/Frameworks/JavaVM.framework/Versions/1.6/Commands/java
I hope this helps.
I am neither a Mac nor Java expert - just an old unix hacker that knew how to make this one work.

Sunday, January 31, 2010

Help translate iFreeBudget

You can help translate iFreeBudget to other languages. You will get a warm feeling for helping out an open-source project and I will include your name in credits. :-)

Use the following procedure if you want to help in translation effort.
Download the file mjrz.po from
http://ifreebudget.svn.sourceforge.net/viewvc/ifreebudget/FinanceManager-Dev/po/

This file will have sections like: 
#: ../net/mjrz/fm/SetupWizard.java:93  
79 msgid "3. Select location"  
80 msgstr "3. Elegir país"
You must translate the  "79 msgid "3. Select location" string to your language.
In this example, this string has been translated into catalan as "80 msgstr "3. Elegir país"  

This translation can be done by manually editing the file or using a graphical front end.
poedit is a good graphical tool and is highly recommented.
You can download poedit from  http://www.poedit.net/download.php 
Please email me the translated file so I can include in the distribution. 
Please email if you have any questions.