This repository is archived.
New location for the package: https://github.com/actualbudget/actual/tree/master/packages/import-ynab5
This is a beta importer for YNAB5 (nYNAB) data.
To run:
npx @actual-app/import-ynab5 <path-to-ynab5-file>
Read below for how to get your YNAB5 file.
Almost everything should be working now.
To use the importer, you will first need to export your budget, then have the correct software installed, and then run the importer.
Note: currently this does not work under WSL in Windows. Run this directly in Windows.
In order to export your budget from YNAB, you will need an API key.
If you haven't already got an API key, you'll need to:
The API key is only shown once, so make sure you copy it down somewhere! More information on how to access the YNAB API can be found at https://api.youneedabudget.com/
Now open a terminal window / command prompt, and enter:
curl -H "Authorization: Bearer <ACCESS_TOKEN>" https://api.youneedabudget.com/v1/budgets
This will get the list of all the budgets you have. You'll need to find the id
of the budget you want to export and use it to perform the following API request:
curl -H "Authorization: Bearer <ACCESS_TOKEN>" https://api.youneedabudget.com/v1/budgets/<BUDGET ID> --output budget.json
For the importer to run, you will need nodejs
installed. Details on doing that are too long for this README, but you can find details at https://nodejs.org/.
Once you have nodejs
installed, you'll need to get download this importer. If you're familiar with GitHub and Git then you probably have everything setup to easily clone this repository. If not, the easiest way to get this importer is to use the Code
button and then use the Download ZIP
file.
Once you have downloaded the zip file, unzip it on your computer to extract the files. Then in a terminal / command prompt, navigate into the directory and type the command:
npm i
This will install the required libraries for the importer.
/path/to
with where ever you saved the budget.json
file:npx @actual-app/import-ynab5 /path/to/budget.json
If you have checked out this code and running it locally, do node index.js
instead of the npx
command.
Once the import is complete, it may not show all the up-to-date information correctly. In order to refresh the view:
If you would like to contribute, check out the documentation for the API, specifically about importers. All of the available methods can be found here.