HomeBank User manual

# CSV file format

With HomeBank you can import/export some of the internal data's in the most common file format that is CSV.

Notice: meanwhile CSV should uses comma as separator, HomeBank uses semi-colon as separator (this is most common than comma)

The format used for the different files is specific to HomeBank, so don't expect to import files your bank should offers you directly, you will need to arrange it a little in a spreadsheet like Gnumeric before.

Below is a description with example of the CSV format that HomeBank uses.

## Transaction import

date

the date format can be:

- y-m-d
- m-d-y
- d-m-y

year can be 2 or 4 digits
separators can be / . or -

payment | You cannot import transaction with payment type=5 (internal xfer) from 0=none to 10=FI fee (in the same order of the list)
info | a string
payee | a payee name
memo | a string
amount | a number with a '.' or ',' as decimal separator, ex: -24.12 or 36,75
category | a full category name (category, or category:subcategory)
tags | tags separated by space

Starting
v5.2.5 : you can change the separator for transaction import into preferences.
v4.5 : tag column is mandatory

Example:

          15-02-04;0;;;Some cash;-40,00;Bill:Withdrawal of cash;tag1 tag2
          15-02-04;1;;;Internet DSL;-45,00;Inline service/Internet;tag2 my-tag3
          ...

## Transaction export

The format exported is by default the same as for the import (described above).
But depending if you export from All transaction or choose some options, it can have more columns:

from All transaction | a first column is added and named: 'account'
option: Add Status column | a 'c' column after the amount, and before category column
option: Detail split lines | transaction with split are exported as extra lines with every split details

c | is the status of the transaction: R = Reconciled C = Cleared

Starting
v5.4.3 : you can optionally export every split line
v5.4 : the c column was added to the export

Example:

          15-02-04;0;;;Some cash;-40,00;R;Bill:Withdrawal of cash;tag1 tag2
          15-02-04;1;;;Internet DSL;-45,00;C;Inline service/Internet;tag2 my-tag3
          ...

↑ Back to Top

## Budget

level | 1 = category 2 = subcategory
type | * = monthly blank = month value
category | if < 5.4 the category name if >= 5.4 the FULL category name
value(s) | 1 amount : if the type is monthly 12 amounts, separated by ';' : if type month value

Example:

    1;*;Fuel;45.00
    2; ;Domestic animals;1.00;2.00;3.00;4.00;...
    1:*;Food;17.00
    2:*;Phone:Bill;25.00
    2:*;Water:Bill;50.00
    ...

↑ Back to Top

## Category

level | 1 = category 2 = subcategory
type | - = expense + = income
category name | the category name

Example:

    1;-;Food
    2; ;Grocer
    2; ;Restaurant
    1;+;Wage
    ...

↑ Back to Top

## Payee

payee name | the name of the payee
full category name | optional: since 5.1.3 the full name of the category

Example:

    payee_name1;cat1:subcat1
    payee_name2;
    ...

↑ Back to Top