Getting started guide

Your finances,
your Mac.

Everything you need to set up Perfinova, import your data, and start understanding your money — in about 15 minutes.

🔒 100% local — no cloud 📥 CSV import from any bank 🤖 AI Q&A on your data 📊 Net worth, budgets, goals

What is Perfinova?

Perfinova is a personal finance dashboard that lives entirely on your Mac. No bank logins, no subscriptions, no data sent to any server. You download CSV exports from your banks and credit cards, import them into Perfinova, and the app does the rest — categorizing transactions, tracking budgets, monitoring savings goals, and visualizing your net worth over time.

📊

Dashboard

Net worth with month & year-over-year deltas, income vs. expenses, upcoming payments, recent transactions, and account balances — all at a glance.

📥

CSV Import

Import from any bank or credit card. Perfinova auto-maps columns, remembers your mapping, and detects duplicate transactions automatically.

🗂

Categories & Rules

Auto-categorize transactions using smart rules. Set them up once — every future import is categorized automatically.

🎯

Budgets & Goals

Monthly budgets per category with live progress bars. Savings goals linked directly to your accounts — no manual updates needed.

📈

Reports

Net worth history, income vs. expenses trends, and category breakdowns — all visualized in clean, printable charts.

🤖

Ask AI

Ask plain-English questions about your spending, net worth, upcoming bills, and financial runway — answered instantly from your own data.

📆

Upcoming Payments

Perfinova automatically detects recurring charges and shows what's due in the next 30 days — color-coded by urgency.

✂️

Split Transactions

Split a single transaction across multiple categories — useful for grocery runs that include household items, food, and personal care.

ℹ️
Two modes: Perfinova ships with a Demo mode (pre-filled with sample data) and a Personal mode (your real data). The demo is a great way to explore every feature before adding your own accounts.

Getting started in minutes

When you open Perfinova for the first time, you'll be guided through a short setup. Here's what to expect.

1

Download & open Perfinova

Download the Perfinova.dmg file, open it, and drag Perfinova to your Applications folder. Double-click to launch. On first open macOS may ask you to confirm — click Open.

2

Unlock with Touch ID

Every time you open Perfinova, it prompts for Touch ID to keep your financial data private. If Touch ID isn't available, it falls back to your Mac's login password. No separate password is created — Perfinova uses what's already on your Mac.

3

Explore the demo — or jump straight in

Perfinova launches with 12 months of realistic sample data so you can explore every feature before touching your real finances. When you're ready to start fresh, go to Settings → Data and choose what fits:

ActionWhat it doesWhen to use it
Reset to Demo DataWipes your data and reloads the original sample transactions, accounts, budgets & goalsWant to re-explore the demo after making changes
Clear All DataPermanently deletes everything — transactions, accounts, budgets, goals, categories, rulesReady to start with your own real data from a blank slate
⚠️
Both actions are permanent and cannot be undone. Make sure you mean it before confirming.
4

Add your accounts

Go to Accounts in the left navigation. You can add accounts one at a time or import them all at once from a spreadsheet.

One at a time: Click + Add account, enter the account name, type, and current balance.

Bulk import via CSV: Click Import accounts, then download the template Perfinova provides. Fill it in with your accounts — one row per account — using these four columns:

ColumnWhat to enterExample
Account NameAny name you'll recogniseBank of America Checking
TypeAccount type (see accepted values below)Checking
BalanceCurrent balance — use a negative number for debts-2500 (credit card)
NotesOptional — anything usefulEmployer plan

Accepted types: Checking · Savings · Credit Card · Brokerage · IRA · Roth IRA · 401(k) · 403(b) · HSA · 529 Plan · Real Estate · Mortgage · Auto Loan · Personal Loan · Equity Comp · Other Asset · Other Liability

Perfinova accepts .csv, .xlsx, or .xls files. Upload the filled template, review the preview, and confirm.

💡
Add all your accounts up front — checking, savings, every credit card, loans, investment accounts, and real estate. This gives you the most accurate net worth picture from day one.
Account typeExamplesCounts toward
Checking / SavingsBank of America, Chase, Navy FederalAssets (positive)
Credit CardChase Sapphire, Apple Card, AmexLiabilities (negative balance)
BrokerageRobinhood, Fidelity, SchwabAssets
Retirement401(k), IRA, Roth IRAAssets
HSA / 529WEX HSA, Fidelity 529Assets
Mortgage / LoanHome loan, auto loan, student loanLiabilities (negative)
Real EstatePrimary residence, investment propertyAssets

Bringing in your transactions

Perfinova works with CSV exports from any bank or credit card. There's no direct bank connection — you download the file from your bank's website and import it. This is intentional: your credentials never touch Perfinova.

1

Download your CSV from your bank

Log into your bank or credit card website, go to the transaction history page, and look for an Export or Download option. Choose CSV format. Most banks let you pick a date range — start with the past 12 months for a good baseline.

💡
Common locations by bank: Chase → Accounts → Download; Bank of America → Accounts → Download transactions; Robinhood → Account → Statements & History → Export.
2

Import the file

In Perfinova, go to Accounts, select the account you want to import into, and click Import CSV. Choose your downloaded file. Perfinova opens a column-mapping screen.

3

Map your columns

Tell Perfinova which CSV column is the date, which is the description, and which is the amount. If your bank uses separate debit/credit columns, map both. Perfinova shows a live preview so you can verify before importing.

Once you save a mapping, Perfinova remembers it — the next import from the same institution skips straight to the review step.

4

Review and confirm

Perfinova shows how many rows it found, how many are duplicates (already in the database), and a preview of the transactions. Click Import to bring them in. Duplicate detection runs automatically — re-importing the same file is safe.

5

Repeat for each account

Import CSVs for all your accounts. It's fine to import them out of order or to overlap date ranges — duplicates are filtered automatically. Once all your accounts are populated, your Dashboard will reflect your complete financial picture.

⚠️
Credit card sign convention: Some banks export credit card charges as positive numbers, others as negative. During column mapping, tick the "Negate amounts" checkbox if your expenses appear as positive numbers — Perfinova needs expenses as negatives.
ℹ️
Revert an import: Every import is tracked in Accounts → Import history. If something looks wrong, click Revert next to the import batch to undo it — all imported transactions from that batch are deleted instantly.

Your financial snapshot

The Dashboard is your home base. It updates automatically as you import transactions and update account balances. Everything is live — no refresh needed.

💰

Net Worth

Total assets minus total liabilities. Shows ▲ $X this month and ▲ $X this year pills based on daily snapshots. Includes a 7-bar mini spark chart.

📈

Monthly Income

All income transactions for the current month, with a comparison to last month so you can spot changes quickly.

📉

Monthly Expenses

All non-transfer expenses for the current month. Transfers (like credit card payments) are excluded so they don't inflate your expense total.

📆

Upcoming Payments

Recurring charges detected automatically from your transaction history. Color-coded: Expected now Due today Due in X days.

🧾

Recent Transactions

Your 6 most recent transactions across all accounts, with category and account shown inline. Click All → to open the full Transactions page.

🏦

Account Balances

All active accounts grouped by type — investments, cash, loans — with color-coded dots. Negative balances (credit cards, mortgages) appear in red.

🎯

Budget Status

Progress bars showing planned vs. actual for your top budget categories this month. Over-budget categories turn red.

🚀

Goal Progress

Each savings goal with a progress bar, target amount, and projected completion date based on your current trajectory.

🏆

Top Spending

The categories where you spent the most this month, with a color-coded progress bar for each. A quick visual of where your money went.

💡
Net worth delta pills: On your very first day, both "this month" and "this year" will show ▲ $0 — that's correct. As soon as you update an account balance or import new transactions, the delta reflects the real change. The pills use your earliest available snapshot as the baseline until a full year of data exists.

Managing your transactions

The Transactions page is where you review, edit, and categorize every imported transaction. It's the core of Perfinova's data model — every chart and report draws from it.

1

Filter and search

Use the Search box to find any transaction by description or merchant name. Filter by Account or Category using the colorful dropdowns. Both dropdowns use a custom selector with color-coded account types and category groups (Income, Expenses, Transfers).

2

Assign or change a category

Click the category pill on any row to open a quick edit dropdown. Select any category — or type to search. Changes save instantly. Color-coded categories make it easy to scan at a glance.

3

Split a transaction

Click the menu on any transaction and choose Split. Enter the amounts and categories for each portion — they must sum to the original total. The original transaction is marked as split and excluded from budgets; the child transactions carry the categories.

💡
Splitting is useful for big-box store runs (Target, Costco) where one purchase covers groceries, clothing, and household items across different budget categories.
4

Edit transaction details

Click the ✏️ Edit button to open the full edit form. You can change the description, amount, date, account, category, notes, and whether the transaction is excluded from budget reports.

5

Exclude from budget

Tick Exclude from budget in the edit form for one-time large purchases (a car, a medical bill) that you don't want skewing your monthly budget progress bars. The transaction still appears in your transaction history and net worth.

ℹ️
Transfers: Mark credit card payments, account transfers, and inter-account moves as the Transfers category type. Perfinova automatically excludes transfer-type transactions from income and expense totals so your cash flow numbers stay accurate.

Auto-categorizing transactions

Rules let Perfinova automatically assign categories to imported transactions based on merchant name, description, or amount. Set them up once and every future import is categorized automatically — no manual work.

1

Browse and create categories

Go to Settings → Categories. Categories come with a name, a type (income, expense, or transfer), and a color used in charts and dropdowns. Click + Add category to create your own.

💡
Keep category types accurate: mark credit card payments as transfer, salary deposits as income, and all spending as expense. This ensures income/expense charts don't double-count money moving between your own accounts.
2

Create a rule

Go to Settings → Rules → New rule. Set a condition — for example, "Description contains Starbucks" — and choose the category to assign (e.g. Dining). Rules can match on description, merchant name, or amount range. Click Save rule.

3

Apply rules to existing transactions

Click Apply rules to categorize all uncategorized transactions. Use Apply (overwrite) to re-run rules across all transactions, even those already categorized — useful after reorganizing your category list.

4

Rules run automatically on every import

After the first setup, all future imports are categorized instantly using your rules. You shouldn't need to touch the rules page again unless you add a new merchant or subscription.

Built-in categories

Perfinova ships with a full set of categories. You can rename, recolor, or delete any of them.

Expenses

GroceriesDining
GasAutomotive
HealthcareHome
SubscriptionsEntertainment
ShoppingTravel
EducationKids Activities
MortgageRent
InsuranceUtilities

Income & Transfers

SalaryFreelance
Investment IncomeRental Income
RefundsOther Income
Transfers (for account-to-account moves)

Tracking budgets and savings goals

Budgets give you a monthly spending plan per category. Goals track progress toward specific targets — and live-link directly to your account balances so they're always up to date.

Monthly budgets

1

Create a budget

Go to Budgets, select the month, and click + New budget. Choose a category and enter your planned monthly amount. A progress bar appears under each category showing Planned → Actual → Remaining.

2

Suggest from history

Click Suggest from history to auto-fill planned amounts based on your recent average spending per category. It's a great starting point — you can adjust any amount by clicking the number in the Planned column and typing a new value.

3

Copy last month

Click Copy last month to duplicate the previous month's planned amounts into the current month. Useful when your budget is stable from month to month.

ℹ️
How Remaining is calculated: Remaining = Planned − Actual. The Planned column shows your editable target; Actual is the sum of all transactions in that category this month. Both update in real time as you import new data.

Savings goals

1

Create a goal

Go to Goals → New goal. Enter a name, target amount, and target date. You can optionally write a description to remind yourself what the goal is for.

2

Link to an account

Select one or more accounts to link to the goal. Perfinova will sum the balances of those accounts as the current amount — updating live whenever you update account balances. Goals with linked accounts show a ⚡ live badge.

3

Track progress

Each goal shows a progress bar, the current vs. target amount, time remaining, and a suggested monthly contribution to hit the target on time. The Dashboard also shows your top goals at a glance.

💡
Suggest Goals: Click ✨ Suggest Goals to let Perfinova analyse your accounts and propose a starter set — typically an emergency fund, retirement boost, and education savings goal — based on your financial situation.

Insights and answers from your data

Reports give you a visual history of your finances. Ask AI lets you skip the charts and just ask a question — answered in plain English from your own data, with no data leaving your Mac.

Reports

📊

Net Worth History

A daily snapshot chart showing how your net worth has grown over the past 12 months. Snapshots are taken automatically in the background.

💸

Income vs. Expenses

Monthly bar chart comparing income and expenses side by side for the past year. Spot high-spend months and income gaps instantly.

🗂

Category Breakdown

A period-by-period breakdown of spending by category. Drill into any month to see exactly where the money went.

🖨

Print-ready

Every report page is print-optimized. Use ⌘P to export a clean PDF of your current report — sidebar and nav are automatically hidden.

Ask AI

Go to Ask AI in the navigation and type any question about your finances. Perfinova sends only your anonymized summary data to the AI — never your full transaction history — and displays the answer inline.

💬

Spending questions

"How much did I spend on dining last month?" or "What's my average monthly grocery bill?"

📆

Upcoming bills

"What recurring payments do I have this week?" or "How much will I spend on subscriptions this month?"

🏁

Goal & runway

"Am I on track for my emergency fund?" or "How many months of runway do I have at my current burn rate?"

📈

Net worth & trends

"How much has my net worth grown this year?" or "Which category drove the most expense growth?"

ℹ️
Privacy note: Ask AI sends aggregated summary statistics to the AI model (totals, averages, category names). Individual transaction descriptions and account numbers are never transmitted.

Your data, entirely on your Mac

Perfinova is built around a single principle: your financial data belongs to you. It is stored in a SQLite database on your local drive — nothing is synced to a cloud server, and no analytics or telemetry is ever sent.

1

Where your database lives

Your data is stored at ~/Library/Application Support/Perfinova/finance.db. This is a standard SQLite file — you can open it with any SQLite browser if you ever want to inspect or export the raw data.

2

Automatic backups

Every time Perfinova launches it automatically creates a dated backup of your database in ~/Library/Application Support/Perfinova/backups/. The last 7 backups are kept. You can also enable iCloud backup — a copy is saved to iCloud Drive → PerfinovaBackups on each launch.

3

No subscription required

Perfinova is a one-time purchase. There are no monthly fees, no premium tiers, and no features locked behind a paywall. You buy it once and own it.

What Perfinova never does

Bank credentials
Never requested
Cloud sync
Never happens
Analytics / telemetry
Zero
Subscription
One-time purchase
Data sold / shared
Never
Internet required
Fully offline

Frequently asked questions

Can I use Perfinova without importing anything first?
Yes — launch the Demo mode to explore every feature with pre-filled sample data. When you're ready, switch to your personal instance and start importing your own CSVs.
My bank's CSV has a weird format — will it work?
Almost certainly. The column-mapping screen lets you manually match any column to the date, description, and amount fields. Perfinova handles different date formats, comma-separated vs. tab-separated files, and separate debit/credit columns.
I imported the same file twice — did I create duplicates?
No. Duplicate detection compares date, account, amount, and description. Re-importing an identical file is safe — duplicates are skipped automatically.
How does the "this month" and "this year" net worth delta work?
Perfinova takes a daily snapshot of your net worth. The "this month" pill compares today's net worth to the snapshot from the first of the current month. "This year" compares to December 31 of the previous year. If you're new to Perfinova and don't have a full year of snapshots yet, both pills fall back to your earliest available snapshot as the baseline.
Can I move my data to a new Mac?
Yes. Copy the finance.db file from ~/Library/Application Support/Perfinova/ to the same folder on your new Mac after installing Perfinova. All your accounts, transactions, budgets, rules, and goals will be exactly as you left them.
Will Perfinova come to iPhone or iPad?
We're focused on making the Mac experience exceptional first. An iOS companion app is on our roadmap — sign up for launch notifications to hear first.
How do I track investments like stocks and ETFs?
Add a Brokerage or Retirement account and keep the balance updated to reflect current market value. For detailed holdings tracking (cost basis, unrealized gains), go to Accounts → Holdings and add your individual positions.
What if I have a question not covered here?
Email us at hello@perfinova.com — we read and respond to every message.