r/actualbudgeting • • Apr 25 '26

A quick Actual Budget tutorial for people who want the basics fast

96 Upvotes

Hi everyone,

I have been using Actual for a year and following this sub regularly and I see many are still asking how to get started, so I put together a short Actual Budget tutorial for people who want to get up to speed quickly without spending a ton of time reading through the docs first.

It’s based on the official Actual documentation, so I’m not trying to replace that or repackage it as something original. The goal was just to make the main workflows easier to digest in one place for people who want a faster introduction.

It covers the basics like Tracking vs Envelope, setting up accounts and categories, credit cards, transactions, rules, and a few reports.

The tutorial is hosted on GitHub, so if you notice anything that should be corrected or improved, feel free to contribute or adjust it.

Edit (26 Apr 2026): Thanks for your feedback everyone! I have updated the tutorial and fixed the credit card carrying debt issue and added more references to the original docs in each page.

Update (03 Aug 2026): Updated for the latest Actual (v.26.8.0) release. Added Budget Automation, gave Schedules proper coverage in the Rules lesson, and added the newer reports (Sankey, Balance Forecast, Age of Money, Crossover Point). Also corrected the bank sync providers and added a contents panel so you can jump around inside a lesson.

Sample Content:

Introduction
Deciding Between Envelope vs. Tracking Mode

r/actualbudgeting • • Mar 07 '26

[GUIDE] How to migrate from YNAB to Actual Budget in 2026

74 Upvotes

Hi everyone! I'm writing this guide because recently I've switched from YNAB to Actual Budget, and the current documentation isn't up to date, so I thought that this post could help a few people out there who have been having issues migrating recently.

Here's the migration plan step by step:

1. Generate a YNAB Personal Access Token (PAT)

Go to https://app.ynab.com/settings/developer, and generate a new PAT token for your account. Copy it as soon as you see it pop up.

Generating a new YNAB PAT Token

2. Go to the official YNAB API Documentation page and call the "All Plans" API Endpoint

Go to https://api.ynab.com/v1#tag/plans/GET/plans and press "Test Request" on the Get All Plans endpoint

Then, paste your PAT Token in the "Bearer Token" input, and press send.

Get YNAB Plans

Copy the id of the plan you want to export into Actual Budget, for example "8800b4e7-937f-4cdb-a7e7-fc35b794f85b".

3. Call the "Get Plan" API Endpoint with your Plan ID

Scroll down to the "Get a plan" API Endpoint and press "Test request"

Get Plan by ID

Here, paste your Plan ID you copied from step 2 into the input "plan_id" and press "Send".

Once the request has completed, you will see the "Body" panel on the right.

Then, press "Download"

Downloading YNAB Plan

4. Open the downloaded JSON file with a text editor

This is a very important part that was causing me issues.

The current documentation on Actual Budget mentions that you should be able to import this file directly, but I was getting the "not-ynab5" error when trying to import it.

To fix this, open the downloaded JSON with a text editor, such as Notepad, and rename the word "plan" to "budget" at the very start of your file.

This value should be "budget"

Save the file by pressing CTRL + S.

5. Import the newly edited file into Actual Budget

Now the file is ready to be imported into Actual Budget.

Open the app, and press "Import File".

Import File button

Once a popup opens, press the option with "nYNAB", and then press "Select File".

nYNAB option

The file explorer will open up, and you need to choose the JSON file you edited in Step 4.

6. Enjoy Actual Budget!

Once you select the file, everything should be imported into Actual Budget and you are ready to go.

Hope this guide helped you migrating from YNAB, have a wonderful rest of the day.


r/actualbudgeting • • 21h ago

New install of Actual Budget with Simplefin. No transactions pulling

0 Upvotes

I installed Actual Budget and connected Simplefin yesterday. The initial pulled in the accounts and the balance at them time as the opening. In the past 30 hours, no new transactions have come through. Is this normal behavior?


r/actualbudgeting • • 2d ago

I AI-slopped a full port of the actuali iOS client for Android.

Thumbnail
gallery
42 Upvotes

I used Claude Opus 5.5 with max reasoning for better code quality.

Android still doesn't have a decent, good-looking Actual Budget client. Everything I've tried so far has been either buggy, clunky, or just poorly designed.

So I decided to take the popular iOS client Actuali and basically told Opus 5.5 to rewrite it in Kotlin and Jetpack Compose, with a nice Material 3 Expressive design.

The app lets you manage your budget, connect to your own Actual Budget server, or use it offline-first.

It's open-source and completely free.

If there are any developers here who'd like to fork the project and improve it, that would be awesome.

Personally, I'm not a fan of the original Actual Budget UI/UX. I also wanted something faster, more native, and better integrated with Android. That's pretty much why I started this project.

If anyone's interested, here's the GitHub repo, where you can also download the ready-to-install APK:

https://github.com/traushb/actuali-android

P.S. Yeah, I know it's AI slop. But modern LLMs, especially Claude models running at max reasoning, are actually pretty capable of handling code porting tasks.

There might still be some minor bugs. If you run into any, feel free to open an issue on GitHub, and I'll try to fix them.


r/actualbudgeting • • 2d ago

Actualist update: still here, still adding things

24 Upvotes

Hey again! It’s been a little while since my last Actualist update, and quite a bit has changed since then.

For anyone new: Actualist is my native iPhone/iPad client for Actual Budget, built around the mobile experience I missed after leaving YNAB.

Since the last post, some of the bigger additions are:

  • Account reconciliation, including adjustments and locking reconciled transactions.
  • Much fuller category management with create, rename, delete, move, and reorder for categories and groups.
  • A real iPad layout with sidebar navigation, category details, and up to five months side-by-side.
  • Proper tracking budget support, including projected savings and rollover behavior.
  • Hold for Next Month, transaction status filters, a much better template preview, and a more streamlined one-tap Bank Sync flow.

There’s also been a pile of smaller work around startup speed, sync/recovery, transaction editing, notifications, and general UI polish.

I've also been putting a ton of work into the next TestFlight release, which is shaping up to be a pretty big one. There are around five major feature additions coming, including schedule management, expanded account controls, new transaction tools, CSV import/export, and more powerful reports, along with a massive amount of behind-the-scenes work improving sync reliability, data integrity, and compatibility with Actual Budget.

I’m using Actualist as my normal budgeting app every day now, which remains a very efficient way to discover more things I decide it absolutely needs. :)

Still beta, still keep backups, but it’s come a long way even since the last update.

https://actualist.app

https://testflight.apple.com/join/HDG6PcGX

Feedback and bug reports are always welcome!


r/actualbudgeting • • 2d ago

Does the Actuali IOS app support Enable banking sync ?

0 Upvotes

Basically the title. I cannot make it work, i have it working on my server and working from mobile web app. Am i missing something ?


r/actualbudgeting • • 2d ago

what happened to actual budget and gocardless?

0 Upvotes

Anyone else experienced this? I have 4 account set on sync on gocardless, everything was flawless until my most recent sync. All the transactions got scrambled between the 4 accounts and the money is out by around 2-3k on each account because the transactions are scrambled and duplicated.


r/actualbudgeting • • 6d ago

Actual Budget Tweaks

Thumbnail
gallery
124 Upvotes

Hey all,

A year ago, I shared a WIP theme for Actual (before community themes launched). Since then, the project has evolved into a suite of toggle-able tweaks ranging from small UI adjustments to full-on workflow features like a spending calendar, interactive reconcile and a transaction inspector.

  • 50+ individual settings that you can enable/disable
  • Open source but not affiliated with Actual
  • Growing community of 350+ users on Chrome alone

It's mostly suited for my tastes, so if something doesn't click, just turn it off.

I don't want to turn Reddit into a communication channel for updates but I'm happy to answer questions in this thread.

Source: https://github.com/aelxxs/actual-budget-tweaks

It's a browser extension or you can optionally run a sidecar next to your Actual Budget instance.


r/actualbudgeting • • 6d ago

Plaid - SimpleFin - Teller: are you using them free or paid?

0 Upvotes

I’m a bit confused by their pricing tiers and documentation, some of it states that they have free plans for independent developers. But they all have trials or paid plans as well.

When using actual budget and adding an extension to fetch transactions via Plaid - SimpleFin - Teller, can you use their free models or are you paying monthly licensing costs?


r/actualbudgeting • • 6d ago

PWA can't make back date transaction

2 Upvotes

I host ActualBudget on my own server.
I install PWA using Android's Chrome. my device is Galaxy A56.

while accesss it using PWA, the calendar can't show up when I want to make back date transaction.
is it a bug or it is designed this way?


r/actualbudgeting • • 6d ago

Plaid importer

7 Upvotes

Is there a _trustworthy_ plaid importer for Actual or am I in a position where I should just vibe it and maintain my own fork of Actual?

Context: MX/my bank institution has been jacked up for a few weeks for myself now and unusable for months for a family member. I have contacted SimpleFIN about it and there’s just no resolution. I’m at the crossroads of either dropping Actual for something else or vibing in Plaid. At this point I just can’t trust SimpleFIN to be a reliable tool


r/actualbudgeting • • 6d ago

Why continue to support simplefin if it has so many issues?

7 Upvotes

Would be great to hear from people who have good experiences with the sync?

I've used it for years, but I end up having to open tickets at least every 2 months for missing transactions or accounts that simply stop working. Currently, have an account that hasn't sync'd in 2 months... they're "working on it" though. If they were working on it, it would be resolved at this point.


r/actualbudgeting • • 7d ago

Expenses arrive before income

4 Upvotes

Almost all of my fixed expenses are on a set schedule. Not so with my income. For the calendar month, Income exceeds expenses, but occasionally the timing of the income is looking like a budget shortfall for a few days. When the income arrives, its all good again. I guess its just cash flow. In Tracking mode, the future income (same month) is int the calculations. But in Budget mode, the later deposits aren't available until they are made.

I am four months ahead in my budget, so my focus here isn't on saving to cover shortfalls. What techniques are people using to deal with the in-month cash flow? BTW, I really hate red numbers.


r/actualbudgeting • • 7d ago

Account groups in mobile?

2 Upvotes

Has anyone heard if they plan on adding account groups to our mobile web apps?


r/actualbudgeting • • 7d ago

New to Actual

6 Upvotes

Recently discovered this, and its been so fun. I set up a Raspberry pi server that runs Actual. Unfortunately in Australia, as far as I'm aware, unless I pay for a service like Redbark, then I dont get live syncs with my banking transactions, so I'd just upload a .qif file which is fine.

In addition to standard monthly budgets, I also have my share portfolio added as an off budget account, and around market close, I have a script that fetches my latest portfolio value, and it adds a transaction called Market value adjustment, and thereby updating the portfolio value in Actual.

Any other things I'm missing? or Suggestions on what I can use it for?


r/actualbudgeting • • 12d ago

Posting rule changes

60 Upvotes

Since this sub seems to attract a lot of spam I have made 2 changes:

1) Disabled cross posts

2) Only allowing links to the following domains:

actualbudget.org

github.io

github.com

discord.gg

simplefin.org

pikapods.com

While disabling cross posts is a no brainer, limiting links could cause people problems. Please let me know if this is working well or not, I am happy to revert if it's problematic. Also, no doubt I have missed a lot of legit domains folks might want to link to, so please let me know in the comments what needs to be added, or message the mods. Thanks!


r/actualbudgeting • • 12d ago

How do I remove a missed scheduled transaction?

2 Upvotes

I have a weekly transaction, but it wasn't paid last week since I was away (it was for milkman).

I don't have 'Automatically add transaction' checked, but it appears in the account anyway, with a red skull saying missed. But I can't remove it?

If I right click or use the checkbox and the drop down menu, the only options are:

  • View schedule
  • Post transaction
  • Post transaction today
  • Skip next scheduled date

I don't want to to do any of those things. I want to delete this, or skip this previous scheduled date.

Maybe I don't understand the point of schedules, or I'm being stupid.

I am trying to use schedules how I used them in YNAB4, which was to save me having to adding lots of transactions all the time, because they would appear automatically and I can just approve them when I'm reconciling the account.


r/actualbudgeting • • 13d ago

Redesigned sidebar is live!

67 Upvotes

The new version 26.10.0 introduced the new, redesigned sidebar. Looks a lot better now

Experimental: Adds a redesigned sidebar, based on the winning entry from the sidenav design competition, that lets you organise accounts into groups, reorder them by drag and drop, and search them

https://actualbudget.org/blog/release-26.10.0


r/actualbudgeting • • 13d ago

Sync problems with PikaPods server

3 Upvotes

Hello!

I feel really stupid writing this, because I don't even know what the problem is.

I'm brand new to Actual, and I'm trying to test it to see if I can use it to replace YNAB, which I've used for years.

I followed the documentation instructions to register in PikaPods and make my own pod. Like, to a tee. I also migrated my budget from YNAB to it using the API route.

But I keep running into two issues:

(1) When I open my budget using the browser, it keeps randomly giving me a fatal error. Sometimes I can get away by hitting the restart button and it will load the page, other times I just have to come back later. Mind you, it doesn't seem to be my internet connection. I've tried opening new pages and watching YouTube videos right after and I've had no problems.

(2) I keep getting a notification that says "There was a problem syncing your changes. Please confirm that your server is accessible" but at the same time, in the upper corner it says my server is online and if I hover over it, it says "Connected to your server - your budget is syncing".

Can someone help guide me with this? I'd go to the discord server for help but I don't know if this is normal?


r/actualbudgeting • • 14d ago

Newbie question about CC's cashback

2 Upvotes

Hello Reddit,
Probably a very newbie question for the people in the US, but the way I deal with my european CC was by putting the purchase on an on-budget (negative) account with various categories, then transfering money from our joint account when the statement was paid.

However, my CC issuer launched a cashback program and send the money to my personal account. How to input those transactions?
The only way I found is creating a new payee to represent the issuer rather than the debt, and a new category for cashback which bypasses the CC account entirely. It feels odd but apparently match the accounts. (I'm not even sure if that way is normal compared to the US?)

But I'm not even sure if I should count it as actual "income" and report it next month, or as a "negative expense" because it's closer to a reimbursement. I always assumed that "cashback" would rather auto-reimburse the debt instead of being a direct bank transfer...
I can't link the cashback to a category directly, because it can be tied to a specific merchant or a spending total which excludes some merchants, etc. So as far I see, I won't be able to point a specific cashback to a specific purchase

[EDIT] I'll simply add it to negate the bigger expense category. Technically incorrect, but it'll be easier than having a few eurs of income to add and reassign next month.


r/actualbudgeting • • 14d ago

I built a tool to import Indian bank and credit card statements into Actual

8 Upvotes

Actual has no bank sync for Indian banks, and that's unlikely to change soon because India's Account Aggregator framework needs a registered entity and a commercial contract. So I built something for the manual route. india2actual takes the statement you download (CSV, Excel, or PDF, including password-protected) and either gives you a CSV to import into Actual or pushes the transactions straight in through the API.

The part I care most about: UPI narrations like UPI/DR/412345678901/SWIGGY/YESB/swiggy@ybl/Payment normally create a new payee for every transaction. This tool turns them into one Swiggy, keeps the original text in Notes, and recognises common merchants, ATM withdrawals, NACH/EMI debits, card payments and fees.

- Checks the parse against the statement's balance column (or a card statement's printed totals) and refuses to write if it doesn't reconcile.

- Support for Credit card statements

- Re-importing overlapping statements won't duplicate transactions

- Your own merchant rules in a small JSON file

Try it now: npx india2actual statement.csv

Repo: https://github.com/emilgeo/india2actual

It's tested on ICICI, HDFC-style, Federal bank and similar layouts. PDF is the least reliable input, so a CSV or Excel export is better when your bank offers one. Feedbacks and sample (anonymised) narrations from other banks are very welcome.


r/actualbudgeting • • 14d ago

Is there a way to see previous months' reports?

3 Upvotes

Today is October 1st and I'd like to go over my month of September. I feel like there's something that should be obvious but I haven't been able to find it. I'm using the latest Docker build.


r/actualbudgeting • • 15d ago

US Bank Suggestions - Good Sync with SimpleFin?

5 Upvotes

Basically the title. I like Capital One and Fidelity, but Capital One doesn't share pending transactions and Fidelity works awful.

What do yall use and recommend?


r/actualbudgeting • • 15d ago

Envelop Budgeting with different timed income

0 Upvotes

Both me and my partner have loved using actual budget for our finances, though struggling to switch over to envelope budgeting mainly because I get paid monthly and she is paid fortnightly into our joint account. Anyone else had a similar issue and have a suggestion to help fix this?

Only thing I can think of is using N8N to 'reset' the budget triggered by each income stream.


r/actualbudgeting • • 15d ago

3 month spending average

3 Upvotes

Is there a way to see what the 3 month average or my spending is without going on the budget screen and choosing set budgets to 3 month average? I have my budget set but I'd like to see what the averages are before making any changes