HomeBank User manual


This section is intended to give you a brief introduction to the basic concepts and terminology you will need to understand in order to make sense to the rest of the documentation.

bank transfer {payment}
cash {payment}
check {payment}
credit card {payment}
cleared {status}
debit card {payment}
deposit {payment}
direct debit {payment}
electronic payment {payment}
expense {type}
fi fee {payment}
financial institution
forecast (cashflow)
income {type}
reconciled {status}
remind {status}
standing order {payment}
transfer (internal)
void {status}


Wallet is the 1st level of data's. It represent a HomeBank file (.xhb)
Managing the few wallet properties is done in the Properties dialog.

↑ Back to Top


Account is the 2nd level of the data's. An account is a division of the wallet, that will contains your financial transactions.
Managing the accounts is done in the Accounts dialog.

↑ Back to Top


Transaction is the last level of data's. A transaction is a financial transaction, attached to its own account.

In addition to the usual fields you can find in most accounting application, HomeBank offers the following:

Managing transactions is done in the main window or the account window.

↑ Back to Top

Type of transaction


An expense is an amount with a negative sign, also called a debit.


An income is an amount with a positive sign, also called a credit.


A transfer (more precisely internal transfer) is a money movement between 2 of your accounts, in one or several Financial institution, as so, like you emit and receive the money there is no payee.

This is a special transfer for HomeBank, as it will link the source and destination transaction for further changes of most data to be synced.
In exception of the Status and Date (and Amount the opposite sign), all the fields will be synced, whatever you make some changes from src or dst account.
The reason is that the money may arrive on the dst account a few days later, and when you reconcile you will do account separately.
Since v5.7 there is a preference to sync also the status by default.

When you change the type of a transaction to this one, HomeBank may propose some potential target transaction for you to select within this dialog.

 transfer have some usage limitation:

↑ Back to Top

Status of transaction


a transaction is cleared when the bank has recorded it,
those transaction are not taken into account in the bank balance.


a transaction is checked when you have controlled it with your bank statement,
those transaction are part of the bank balance.


Remind is a special status for the transaction. Its usage is described here.
The purpose is to keep the transaction into the list for later uses to remind you about a bill to pay, a bill to be paid for, or money you lent or wait refund on.
Remind transaction are excluded from any computing: balance, reports, etc. except if you change some preference.


Void is a special status to set transaction to be ignored everywhere.
The visibility can be controlled from preference or filter.

↑ Back to Top

Financial institution

A financial institution can be a bank or a credit card company or any other institution.

<no institution> will be displayed when the item has no institution set.

↑ Back to Top

Forecast (cashflow)

A forecast of cash flow is available for some report. It is based on the scheduled transaction. In the graph it will display with future style, so with a shaded color and dashed lines. The forecast will only display when there is a date junction within the date range you selected: if we are in july and you select first quarter (which end on march) it will not display. If you select this month, this year, it will.

↑ Back to Top


A currency is a money that is used in a particular country at a particular time, or it can be a crypto currency as well, or even something that do not exists at all.

↑ Back to Top

Payment mode


When payment do not applied or is unknown.

credit card

A credit card is a payment card issued to users (cardholders) as a method of payment. It allows the card-holder to pay for goods and services based on the holder's promise to pay for them. The issuer of the card (usually a bank) creates a revolving account and grants a line of credit to the card-holder, from which the card-holder can borrow money for payment to a merchant or as a cash advance.


A check (or cheque in English) is a document that orders a bank to pay a specific amount of money from a person's account to the person in whose name the cheque has been issued.


Cash refers to money in the physical form of currency, such as banknotes and coins.

bank transfer

A bank transfer is a method of electronic funds transfer from one person or entity to another. It can be made from one bank account from or to a bank account you don't own.

debit card

A debit card (also known as a bank card or check card) is a plastic payment card that provides the card-holder electronic access to their bank account(s) at a financial institution. Some cards may bear a stored value with which a payment is made, while most relay a message to the card-holder's bank to withdraw funds from a payer's designated bank account.

standing order

A standing order (or a standing instruction) is an instruction a bank account holder ("the payer") gives to his or her bank to pay a set amount at regular intervals to another's ("the payee's") account. The instruction is sometimes known as a banker's order.

electronic payment

Electronic payment is a feature of on-line, mobile and telephone banking, similar in its effect to a giro, allowing a customer of a financial institution to transfer money from their transaction or credit card account to a creditor or vendor such as a public utility, department store or an individual to be credited against a specific account.


A deposit is money placed with some other entity. It is a credit for the party who placed it, and it may be taken back (withdrawn), transferred to some other party, or used for a purchase. It is often used with respect to banks, where deposits are usually their main source of funding.

financial institution fee

Bank fees are assessed to customers for various services and as penalties. There are unauthorized overdraft fees, ATM usage fees, and fees for having an account balance under a required amount.

direct debit

A direct debit or direct withdrawal is a financial transaction in which one person withdraws funds from another person's bank account. Formally, the person who directly draws the funds ("the payee") instructs his or her bank to collect (i.e., debit) an amount directly from another's ("the payer's") bank account designated by the payer and pay those funds into a bank account designated by the payee.

↑ Back to Top


Split is the ability to cut out the amount of a transaction to multiple categories.

Managing split is done in the Split dialog from the Transaction dialog.

↑ Back to Top


Scheduled is a transaction you can configure to be automatically inserted.
Typical such transactions are the one's occurring very often, for example: Wage, Rent, Phone, Taxes, etc...

Managing scheduled is done in the Scheduled/Template dialog.
Please have a look at Using the Scheduled transaction feature for more details.

↑ Back to Top


Template will enable to fast add manually some transactions without too much seizure, most of the fields already populated with correct data

Managing templates is done in the Scheduled/Template dialog.

Templates can also be created from existing transactions from the Account window.
Every template is available as a bookmark for fill purpose in the Transaction dialog.

↑ Back to Top


A payee can optionally be set for each transaction to later perform sorting, filtering and analysis. The payee identify people you give money to, as like as those you receive money from.
Managing payees is done on the Payee dialog. Payees are global to the wallet and are shared between all the accounts.

<no payee> will be displayed when the item has no payee set.

↑ Back to Top


A category can optionally set for each transaction to later perform sorting, filtering and analysis. The categories are another classification model of your financial transactions.
Managing categories is done on the Categories dialog. Categories are global to the wallet and are shared between all the accounts.

Please also note well that categories and subcategories are the same from a HomeBank point of view, the subcategories are only to create a hierarchy in category tree. This is especially important for the budget dialog

<no category> will be displayed when the item has no category set.

↑ Back to Top


Some tags can optionally be set for each transaction to later perform sorting, and analysis. The tags are most common to those yo can find in the web, so it is words separated by space. Which mean for composed word you must use a dash to separate the words within the tags like my-card.

↑ Back to Top


Assignments are some rule to fast set payee and/or category to the transactions

Please refer to the Using the Automatic assignment feature for details on how using this feature.

↑ Back to Top


The budget is aimed towards reporting comparing actual values to predefined budget values allocated to each expense/income category. The budget report shows the difference (decay) between the budget and the actual expense/income for each categories. You can select which accounts are included in the budget report.

Using the Budget feature provides a quick overview to get you started. For more in-depth details see the Budget dialog and the Budget report.

The budget is global to the wallet, so if you need to manage a different budget each year, you can use CSV import/export capabilities.

↑ Back to Top


There is 2 mechanism that ensure you can get back to a several previous version of your .xhb file.

1) the last backup file
Every-time you save your file, the previous version will be saved with .xhb~ (tilde at the end), into the wallet folder.
To get back to this file, you can use the File > Revert menu. If there is no .xhb~ file, this menu will be disabled.

2) the backup file once a day
Each day you save your file for the first time, a .bak file will be created into the backup folder. Which means if you save it 3 times during the same day, only the first save will be saved as the day backup.
To get back to one of this backup, you can use the File > Restore backup menu. If there is no .bak file, this menu will be disabled.

With this mechanism, you have a good compromise between safety backup and data storage.

↑ Back to Top


A key point of your accounts are balances. HomeBank offers 4 balances covering the entire life cycle of your accounts. You can show/hide the balances you need for your usage, for example hide the reconciled and future for a simple management.

Reconciled : includes reconciled transaction, so this should be the same balance as the last reconciled statement you checked

Cleared : includes reconciled + cleared transaction

Today : balance of transactions until today, ignoring the state

Future : balance of all the transaction : include all transaction currently into the account

n.b.: remind transaction are never taken into consideration into balances, except if you have forced to

↑ Back to Top