Perfinova β€” Getting Started Guide
Perfinova Getting Started Guide

Your financial journey,
organized.

Set up Perfinova, add accounts, import transactions, update balances, and start understanding your money in about 15 minutes.

πŸ”’ 100% local β€” no cloud 🏦 No bank logins ⚑ Quick Add transactions πŸ“₯ Multi-file spreadsheet imports 🏦 Account & balance import πŸ€– AI budgets, goals & Q&A πŸ“ˆ Investments & live prices 🧾 Debt Planner

What is Perfinova?

Perfinova is a free, local-first personal finance dashboard that lives entirely on your Mac. No bank logins, no cloud account, no subscriptions, and no bank credentials shared with anyone. You import account balances and transaction spreadsheets, and Perfinova helps you organize the rest β€” categorizing transactions, tracking budgets, monitoring goals, finding recurring payments, and visualizing your financial journey 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.

πŸ“₯

Spreadsheet Imports

Import CSV or Excel files from one account or many accounts at once. Perfinova maps columns, routes transactions to accounts, and catches duplicates 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. Under-budget categories use calm blue indicators; over-budget categories turn red so problems stand out immediately.

πŸ“ˆ

Reports

Net worth snapshots, income vs. expenses, monthly spending, category spending, budget variance, and progress reports in clean, printable charts.

πŸ€–

Ask AI

Ask plain-English questions about spending, budgets, goals, subscriptions, recurring transactions, and financial progress β€” answered 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.

βœ‚οΈ

Inline Balance Updates

Update account balances directly from the Accounts page so net worth and goals stay current after statements, payroll, loan payments, or market changes.

πŸ“‹

Custom Reports

Create, name, and save your own reports with live account balances and snapshot history. View, edit, or delete them any time from the Reports tab.

πŸ””

Proactive AI Insights

A background agent monitors your finances and surfaces alerts β€” budget overruns, net worth milestones, savings wins, and goal progress β€” without you having to ask.

πŸ“ˆ

Investments

Track holdings with live delayed market prices. See current value, gain/loss, and how your portfolio fits into your overall net worth β€” updated on demand.

🧾

Debt Planner

Model your path to debt-free. Enter loan details and an optional extra principal β€” Perfinova shows months saved, interest avoided, and a full amortization breakdown.

ℹ️
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 Perfinova from the Mac App Store or from the Perfinova website, then open it from your Applications folder. On first launch, macOS may ask you to confirm that you want to open the app.

2

Choose your security preference

After accepting the disclaimer, Perfinova asks whether you want to protect the app with Touch ID or your Mac password. This is entirely optional β€” you can skip it and go straight to the app. If you enable it, Perfinova will prompt for Touch ID every time you open it.

πŸ”’
Your credentials never leave your Mac. Touch ID and your Mac password are handled entirely by macOS. Perfinova never sees, stores, or transmits them β€” authentication is 100% local with no internet involved.

You can change this preference at any time from the Perfinova menu β†’ Enable Lock Screen or Disable Lock Screen.

3

Explore the demo β€” or jump straight in

Perfinova includes realistic demo data so you can explore the redesigned dashboard, imports, reports, budgets, goals, and Ask AI 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 sample transactions, accounts, budgets, goals, balances, and snapshotsWant 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 and balances

Go to Accounts in the left navigation. You can add accounts one at a time, import them all from a spreadsheet, and update balances inline any time your statements or market values change.

One at a time: Click + Add account, enter the account name, type, and current balance. For debts such as credit cards, mortgages, and loans, use a negative balance.

Bulk import via spreadsheet: Click Import accounts from spreadsheet, 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. Duplicate account names are detected before import, so existing accounts are not accidentally recreated.

πŸ’‘
Add all your accounts up front β€” checking, savings, every credit card, loans, investment accounts, real estate, HSA, 529, and equity compensation. This gives you the most accurate net worth picture from day one.
5

Let AI create starter budgets and goals

After you add accounts and import transactions, Perfinova can help you avoid starting from a blank page. Go to Budgets and use Suggest from history to generate starter budget amounts from your actual spending patterns.

Then go to Goals and use the AI goal suggestions to create a first set of practical targets, such as an emergency fund, retirement boost, education savings, debt payoff, or cash reserve. You can edit every suggestion before using it.

✨
Best starting flow: import accounts, import transactions, update balances, then let Perfinova suggest budgets and goals. The more complete your data is, the better the suggestions will be.
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 and Excel exports from banks, credit cards, brokerages, and other financial institutions. There is 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 transactions from your bank

Log into your bank, credit card, or brokerage website, go to the transaction history page, and look for an Export or Download option. Choose CSV or Excel 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 one file or several files at once

In Perfinova, go to Transactions and click Import Transactions, or go to Imports from the sidebar. Choose one or more CSV/Excel files. Perfinova will preview the rows, detect the date range, and ask you to confirm the details before import.

✨
Import tip: Import multiple spreadsheets in one flow, or import a single spreadsheet containing transactions from many accounts.
3

Map your columns

Tell Perfinova which column is the date, which is the description, which is the amount, and, when available, which column contains the account. 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 moves faster.

4

Route transactions to the right account

If your spreadsheet includes an Account column, Perfinova matches each row to the right account automatically. If an account name in the file does not match an account you have created, Perfinova pauses and asks you to choose the matching account or skip those rows before continuing.

If the spreadsheet has no account column, Perfinova asks which account the file belongs to. If you upload several single-account files at once, Perfinova can ask for each file so every transaction lands in the correct place.

πŸ’‘
For the cleanest import, make sure your account names in the spreadsheet match the names on the Accounts page. Perfinova also shows sample transaction details when it needs your help resolving a missing account.
5

Review and confirm

Perfinova shows how many rows it found, whether all rows are valid, and whether any account choices still need your attention. Click Import to bring them in. Duplicate detection runs automatically, so re-importing the same file is safe.

⚠️
Amount sign convention: Some banks export expenses as positive numbers, others as negative. During column mapping, tick the "Negate amounts" checkbox if your expenses appear with the wrong sign. Perfinova treats expenses as negative and income as positive.
ℹ️
Revert an import: Every import is tracked in Settings β†’ Import history. If something looks wrong, click Revert next to the import batch to undo it β€” all imported transactions from that batch are removed.

Your financial snapshot

The redesigned Dashboard is your home base. It updates as you import transactions and update account balances, giving you a fast read on net worth, monthly income, expenses, upcoming payments, recent activity, and account balances.

πŸ’°

Net Worth

Total assets minus total liabilities. Shows month and year change pills based on daily snapshots, plus a small chart so you can see momentum at a glance.

πŸ“ˆ

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, real estate, HSA, and 529 plans β€” with color-coded dots. Negative balances appear in red.

🎯

Budget Status

Progress bars showing planned vs. actual for your top budget categories this month. Under-budget categories use calm blue indicators; 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 snapshots: Perfinova takes historical snapshots so the Dashboard and Reports can show progress over time. Updating account balances is what keeps net worth accurate; importing transactions explains the activity behind the numbers.

Managing your transactions

The Transactions page is where you import, add, review, edit, filter, and categorize transactions. It is the core of Perfinova's cash-flow model β€” income, expenses, budgets, recurring transactions, and reports all draw from it.

1

Import or add transactions

Click Import Transactions to bring in CSV or Excel files from your financial institutions. Use the Quick Add box when you need to enter daily activity fast β€” for example, coffee 5 chase, salary 3980 robinhood checking, or transfer 1500 from checking to chase united.

2

Filter and search

Use the Search box to find any transaction by description or merchant name. Filter by Account, Category, or date range. You can also show uncategorized transactions when you want to clean up your data.

3

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.

4

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.
5

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.

6

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: Use transfers for credit card payments, account transfers, and inter-account moves. Perfinova creates the debit and credit sides together, updates eligible cash and credit card balances, and excludes transfers from income and expense totals.

Auto-categorizing transactions

Categories describe what a transaction is. Rules are optional automations that tell Perfinova how to categorize future transactions based on merchant name, description, or amount. Imported transactions can be categorized even if you have no rules; rules simply reduce the repetitive cleanup over time.

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, future imports are categorized using your saved rules. You can still change any category manually afterward, and you can keep the Rules page empty if imported categories already look right.

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 can link directly to your account balances so they stay current as you update accounts.

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. Blue means you are within plan; red means you are over budget.

2

Suggest from history

Click Suggest from history to auto-fill planned amounts based on your recent average spending per category. You can adjust any amount inline 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.

πŸ’‘
AI suggestions: Perfinova can suggest starter budgets and goals based on your history and account balances. Treat them as a first draft, then adjust the numbers to match your priorities.

Tracking your portfolio

The Investments section lets you track individual holdings with live delayed market prices. Add a position once and Perfinova keeps the value current β€” no manual updates needed.

✨
New in Perfinova: Brokerage, retirement, HSA, and 529 accounts can be valued from holdings. Enter symbol, shares, and cost basis; Perfinova refreshes delayed prices and updates linked account values.
1

Add a holding

Go to Investments in the left navigation. Click + Add holding and enter the ticker symbol (e.g. AAPL, VOO), number of shares, and your purchase price per share. Perfinova calculates your cost basis immediately.

2

Refresh prices

Click Refresh Prices to fetch the latest delayed market quotes for all your holdings at once. Perfinova updates current value and gain/loss in dollars and percentage for each position.

πŸ’‘
Prices are delayed quotes from public market data β€” not real-time. For assets without a public ticker (real estate, private equity), update the balance manually via the Accounts page.
3

See portfolio impact on net worth

Investment holdings feed directly into the balance of the linked brokerage or retirement account. When you refresh prices, your net worth on the Dashboard updates to reflect the new market value automatically.

ColumnWhat it shows
TickerStock, ETF, or fund symbol
SharesNumber of units held
Purchase PriceYour average cost per share
Cost BasisShares Γ— purchase price β€” what you paid in total
Current PriceLatest delayed market quote
Current ValueShares Γ— current price
Gain / LossCurrent value minus cost basis, in dollars and percent

Modeling your path to debt-free

The Debt Planner lets you model any loan β€” mortgage, auto, student, personal β€” and see exactly what paying a little extra each month buys you in time saved and interest avoided.

πŸ’‘
Debt Planner: Enter your loan details and an optional extra principal amount. Perfinova shows a side-by-side scenario comparison and full amortization breakdown.
1

Enter your loan details

Go to Debt Planner in the left navigation. Enter your loan balance, annual interest rate, and loan term in years. Perfinova calculates your standard monthly payment and total interest paid over the life of the loan.

2

Add extra principal (optional)

Enter an amount you could add to each monthly payment. Perfinova immediately shows how many months earlier you'd pay off the loan and how much interest you'd save β€” side by side with the baseline scenario.

πŸ’‘
Even a small extra payment makes a significant difference on long loans. Try $100/month on a 30-year mortgage β€” the results are often surprising.
3

Review the amortization breakdown

Scroll down to see a full breakdown showing how each payment splits between principal and interest over time, and exactly when the loan is paid off under each scenario.

OutputWhat it means
Monthly PaymentStandard payment required by the loan terms
Payoff DateMonth and year the loan reaches zero balance
Total InterestTotal interest paid over the life of the loan
Months SavedHow much sooner you pay off by adding extra principal
Interest SavedTotal interest avoided by paying extra each month

Insights and answers from your data

Reports give you a visual history of your financial journey with calm blue/red status language across Dashboard and Budgets. Ask AI lets you skip the charts and ask questions in plain English.

Reports

πŸ“Š

Net Worth Snapshots

Daily, monthly, and yearly snapshot views showing how your net worth has changed over time. Current account balances feed the latest snapshot.

πŸ’Έ

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.

πŸ—‚

Monthly & Category Spending

See spending by month or by category so you can quickly spot what changed, what grew, and what deserves attention.

πŸ“‰

Budget Variance

Compare planned vs. actual spending per category across any month. Spot where you over- or under-spent at a glance with blue and red variance indicators.

πŸš€

Progress Report

A dedicated view showing net worth trajectory, asset and liability trends, and income vs. expense history over time β€” with KPI cards for key milestones and growth percentages.

πŸ“‹

Custom Reports

Create and save your own reports with live account balances and snapshot history. Name them anything, edit them any time, and delete ones you no longer need.

πŸ’‘
Custom Reports: Build a saved view around the accounts and time periods that matter most to you β€” useful for tracking a specific goal, a subset of accounts, or a recurring review you do each month.

Ask AI

Go to Ask AI in the navigation and type any question about your finances. You can ask about spending, budgets, goals, subscriptions, recurring payments, recent activity, or progress over time.

πŸ’¬

Spending questions

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

πŸ“†

Recurring transactions

"What recurring payments do I have this week?" or "Which subscriptions are active right now?"

🏁

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 is designed to work from summarized financial context rather than requiring you to link bank accounts. Do not paste bank credentials or private account numbers into AI prompts.

Proactive AI Insights

In addition to Ask AI β€” where you ask and Perfinova answers β€” a background agent monitors your finances continuously and surfaces observations on its own. You don't need to ask anything; Perfinova will flag things worth your attention.

⚠️

Budget alerts

Notified when a category is trending over budget mid-month, giving you time to adjust before the month ends.

πŸ“ˆ

Net worth milestones

The agent flags meaningful net worth changes β€” significant month-over-month growth or a notable drop β€” so you never miss a turning point.

πŸ†

Savings wins

When you come in under budget for the month or make strong progress on a goal, Perfinova surfaces it as a positive signal.

🎯

Goal progress alerts

Notified when a goal is nearly complete or when you're falling behind your projected pace, so you can decide whether to increase contributions.

πŸ’‘
Ask AI vs. Proactive Insights: Ask AI answers questions on demand β€” you ask, it responds. Proactive Insights run in the background and push observations to you. Both draw from the same local data and neither requires a network connection.

Your data, entirely on your Mac

Perfinova is built around a single principle: your financial data belongs to you. Your accounts, balances, transactions, budgets, goals, rules, imports, and snapshots are stored locally on your Mac.

1

Where your database lives

Your data is stored in your Mac's Application Support folder as a local SQLite database. Perfinova keeps demo data and personal/production data separate so you can explore without mixing sample data into your real finances.

2

Automatic backups

Perfinova can create local backups of your database and includes reset tools for demo data and personal data. If you use iCloud Drive for your own files, you can also keep copies of backups there.

3

No recurring subscription required

Perfinova does not require bank-link subscriptions or monthly financial-data aggregation services. You control the files you import and the data you keep.

What Perfinova never does

Bank credentials
Never requested
Cloud sync
Never happens
Analytics / telemetry
Zero
Subscription
No recurring fees
Data sold / shared
Never
Internet use
Only for market prices

Frequently asked questions

Can I use Perfinova without importing anything first?
Yes. Use demo data to explore every feature with pre-filled accounts, balances, transactions, budgets, goals, and reports. When you're ready, clear the data and start importing your own files.
My bank's spreadsheet has a weird format β€” will it work?
Almost certainly. The column-mapping screen lets you manually match columns for date, description, amount, category, and account. Perfinova handles CSV and Excel files, different date formats, 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 transaction file is safe β€” duplicates are skipped automatically. Account imports also check for duplicate account names before creating anything new.
Can one transaction spreadsheet contain multiple accounts?
Yes. If the file has an Account column, Perfinova routes each row to the matching account. If it cannot match an account name, it asks you to choose the right account or skip those rows before importing.
What if the spreadsheet has no Account column?
Perfinova asks which account the file belongs to. If you upload multiple single-account files, it can ask for each file so transactions still land in the right accounts.
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 the roadmap.
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.
Is it safe to use Touch ID or my Mac password with Perfinova?
Yes, completely. Touch ID and your Mac password are handled entirely by macOS β€” Perfinova never sees, stores, or has access to your fingerprint or password. Authentication is 100% local and no data is transmitted anywhere. It works exactly like unlocking any other Mac app with Touch ID.
What if I skipped Touch ID setup and want to enable it later?
Open Perfinova and go to the Perfinova menu in the menu bar. Click Enable Lock Screen. From that point on, Perfinova will prompt for Touch ID or your Mac password every time you open it. You can disable it the same way.
What if I have a question not covered here?
Email us at hello@perfinova.com β€” we read and respond to every message.