Getting Started

Add an account, import or enter transactions, set up categories, create a budget, and explore the dashboard. Takes about 10 minutes.

The Getting Started Checklist#

The first time you open Budget with nothing in it, the dashboard shows a Get started with Budget checklist in place of the tiles. It has five steps:

  1. Set your base currency, the currency your totals and reports are shown in.
  2. Create the default categories, a ready-made set of income and spending categories you can change later, along with a few import rules that file common purchases into them.
  3. Add an account, a bank account, card or cash wallet to record money in and out of.
  4. Import a statement, or connect your bank when your administrator has turned on Bank Sync.
  5. Set a budget for one category.

Each step has a button that takes you to the right page, and a Guide link to the page on this site that explains it. You do not have to tick anything: a step ticks itself off once it is done, wherever you did it, and the bar at the top shows how many of the five are finished. The sections below walk through the same ground in more detail.

While the checklist is showing, the dashboard tiles are hidden, as they would all be empty. Show the dashboard tiles at the bottom of the checklist brings them back whenever you want a look. Once all five steps are done the checklist goes away and the tiles return. If you would rather not use it at all, Hide this checklist (the cross in its corner) closes it for good.

Anyone who already has accounts or transactions, or has accepted a share from someone else, never sees the checklist, so it does not appear after an update.

Try with sample data#

If you want to see what Budget does before putting your own figures in, click Try with sample data on the checklist. It fills Budget with sample accounts, transactions, bills and budgets, dated over the last few months up to today, so the dashboard, budgets and reports all have something to show. It is only offered while your budget is empty.

A banner at the top of every page says you are looking at sample data. When you are done, click Clear sample data in that banner and confirm. This deletes everything in your budget, the sample data and anything you added while trying it, so do not start entering your real transactions until you have cleared it. Your settings are kept, and the checklist comes back where you left it.

1. Add Your First Account#

Navigate to the Accounts page from the left sidebar and click Add Account.

Fill in the details:

  • Name -- a label you will recognize (e.g. "Main Checking", "Visa Rewards")
  • Type -- choose from checking, savings, credit card, loan, investment, cash, cryptocurrency, money market, mortgage, or line of credit
  • Currency -- pick from 45+ supported currencies including major fiat currencies and crypto
  • Opening Balance -- the account balance at the time you start tracking

Click Save. Repeat for any other accounts you want to track.

Tip: For credit cards and loans, enter the amount you owe as a plain positive number — the app records it as a debt for you. Only tick This account is in credit if you have overpaid the account and the lender owes you. You can also set a credit limit for credit card accounts. See Liability Balance Model.

2. Add Transactions#

You have two options: import from your bank or add transactions by hand.

Import from your bank#

Go to Import in the sidebar and upload a statement file. Budget supports CSV, OFX, and QIF formats. The importer auto-detects delimiters and number formats, and includes duplicate detection so you can safely re-import overlapping date ranges.

If you are moving from Firefly III, YNAB, Actual Budget, Mint, Monarch Money or Toshl Finance, import that app's export instead: your accounts, categories and transfers come across with it. See Switching from Another App.

See Import for the full walkthrough including column mapping and dual-column amount handling.

Add manually#

Go to Transactions, select an account, and click Add Transaction. Enter the date, description, amount, and optionally assign a category. You can also split a single transaction across multiple categories.

3. Set Up Categories#

Go to the Categories page. You have two options:

  • Generate defaults -- click Create Default Categories and Budget will generate a full category tree based on the 50/30/20 budgeting rule (50% needs, 30% wants, 20% savings). If you provide your monthly income, budget amounts are pre-calculated for you. It also adds a few import rules that file common purchases into Groceries, Gas, Utilities, Dining Out and Shopping, at a lower priority than any rule you make yourself. See Default Categories.
  • Create your own -- click Add Category to build a custom hierarchy from scratch.

Categories are organized in a tree structure, so you can have top-level groups (like "Housing" or "Food") with specific sub-categories underneath.

Tip: You can always reorganize categories later. Transactions keep their assignments even if you move categories around.

4. Create a Budget#

Go to the Budget page and set spending limits for each category. Choose a budget period (monthly is most common) and enter the amount you want to allocate to each category.

As transactions come in, Budget tracks your spending against these limits. You will see alerts on the dashboard when you are approaching or exceeding a budget.

5. Explore the Dashboard#

The Dashboard is your financial command center. It shows 28+ customizable tiles organized into sections:

  • Hero tiles at the top -- net worth, monthly income, monthly expenses, net savings, and more
  • Charts -- income vs. expenses trends, spending by category, net worth history
  • Summary cards -- account balances, budget progress, upcoming bills, savings goals, debt payoff status

Click the lock button beside the Dashboard title to unlock it, then show, hide or rearrange tiles to match what matters most to you. See Unlocking the Dashboard.

Note: Some tiles (like budget alerts and savings goals) only appear once you have set up the corresponding features.

Keyboard Shortcuts#

Budget can be driven from the keyboard. Press ? at any time to open a cheat sheet of every shortcut.

Global

KeyAction
/ or Ctrl/Cmd + KFocus the search box
?Show / hide the keyboard shortcuts cheat sheet
EscClose the open dialog (or the cheat sheet)
g then a letterJump to a page

Go to a page -- press g, then the page's letter. Every page in the sidebar has one:

KeyPageKeyPageKeyPage
dDashboardnTransfersfForecast
aAccountsvSavings GoalsrReports
tTransactionsyDebt PayoffmImport
cCategoriespPensionsuRules
gTagseAssetsxExchange Rates
bBudgethShared ExpenseswSharing
iIncomekBank Sync
lBillssSettings

In any dialog -- Esc closes it, Tab cycles through its fields, and Enter saves (in a text field). When a dialog opens, the first field is focused automatically.

On the Transactions list -- j / k move a row cursor down / up, e (or Enter) edits the highlighted row, and x selects or deselects it. See Transactions for more.

Reordering -- lists you would otherwise rearrange by dragging can be rearranged from the keyboard too:

KeyAction
Alt + ↑ / ↓Move the focused category, or the focused column in the Accounts page's display settings, up or down
Alt + →Make the focused category a subcategory of the one above it
Alt + ←Move the focused subcategory out one level

See Categories for how category moves work.

Shortcuts are ignored while you are typing in a text field, so they never get in the way of entering data.

What's Next#

Now that the basics are in place, explore these features to get more out of Budget:

  • Rules -- Set up auto-categorization rules so imported transactions are categorized automatically
  • Bills -- Track recurring bills and get Nextcloud notifications before they are due
  • Income -- Monitor expected income sources and flag missed payments
  • Forecast -- See predicted future balances based on your spending history
  • Savings Goals -- Set financial targets and track your progress
  • Reports -- Generate year-over-year comparisons and spending breakdowns
  • Shared Expenses -- Split costs with housemates, partners, or friends
  • Settings -- Customize currency, date formats, and other preferences