A local-first personal finance app
:pencil: removing some outdated information (#259)
Matiss Janis Aboltins03f4f00547f3
diff --git a/docs/contributing/project-details/index.md b/docs/contributing/project-details/index.mdindex 0b1d53255b..5e5ef9b4e7 100644--- a/docs/contributing/project-details/index.md+++ b/docs/contributing/project-details/index.md@@ -6,8 +6,6 @@ All of the repositories can be found in the [Actual Budget](https://github.com/a- [Actual](https://github.com/actualbudget/actual)- [Actual Server](https://github.com/actualbudget/actual-server)-- [Releases](https://github.com/actualbudget/releases)-- [node-api](https://github.com/actualbudget/node-api)- [docs](https://github.com/actualbudget/docs)## Actual@@ -18,10 +16,9 @@ This repository holds all of the front end code for the Actual Budget applicatio├── actual└── Packages└── api+ └── crdt└── desktop-client└── desktop-electron- └── import-ynab4- └── import-ynab5└── loot-core└── node-libofx...@@ -36,14 +33,6 @@ While this is called Desktop Client, this actually has nothing to do with the deThis is the source code for the Desktop application, in it's current state it is not configured to work with the self hosted version of Actual Budget, however the source code is available for this to be completed.-### Import ynab4--The importer for YNAB4 into Actual.--### Import ynab5--The development version of the importer for nYNAB into Actual.-### Loot CoreThe shared underlying functionality component used by both the web/desktop frontend and the in-browser database server.@@ -75,9 +64,3 @@ You can see this in the [package.json](https://github.com/actualbudget/actual-seSo, you might see some changes being made in the Actual repository but them changes are not reflected in your deployment despite you having the latest version pulled, why? Because Actual hasn't been updated in [npm](https://www.npmjs.com/package/@actual-app/web).Actual is only updated in npm when a release is created.--## Actual Releases--This repository holds all of the official releases of Actual Budget, each release gets tagged and each element of the Actual Budget project can be downloaded.--As of right now 0.0.148 is the latest official release.diff --git a/docs/migration/index.md b/docs/migration/index.mdindex 83d0e86a08..4124adb168 100644--- a/docs/migration/index.md+++ b/docs/migration/index.md@@ -18,8 +18,6 @@ Instead of creating an export from the Web app, you can also create a zip archiv## Migration from other apps-[YNAB4](ynab4) is the only built-in importer right now. We're hoping the community can help build other importers on top of the [API](../api/index.md).-:::noteThere are guides [here](../advanced/index.md) for some advanced migration tasks.:::diff --git a/docs/migration/nynab.md b/docs/migration/nynab.mdindex c4585af5ab..4f07d1971e 100644--- a/docs/migration/nynab.md+++ b/docs/migration/nynab.md@@ -1,6 +1,6 @@# Migrating from nYNAB-## Method 1: 3rd Party nYnab exporter+## 3rd Party nYnab exporterWhile we don't maintain this tool, you can also use https://json-exporter-for-ynab.netlify.app to export your budget from nYNAB into jSON.@@ -17,106 +17,3 @@ While we don't maintain this tool, you can also use https://json-exporter-for-yn- Choose the exported json file--## Method 2: Beta export and import tools--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.-- There might be a way to set carryover using internal categories from YNAB (Deferred Income Subcategory and Immediate Income Subcategory)- Docs of how credit cards translate from Actual to YNAB- Maybe something else I'm missing- Remove ynab transfer payees not used by actual -->--### How to use the importer--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.-:::--### Exporting from YNAB--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:-- Sign in to the YNAB web app- Go to the "Account Settings" page, then to the "Developer Settings" page- Under the "Personal Access Tokens" section, click "New Token"- Enter your password and click "Generate" to get a new access token--:::caution-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:--:::note--If you receive an error message like: `Invoke-WebRequest : Cannot bind parameter 'Headers'`, this is because curl is probably aliased to the "Invoke-WebRequest" Powershell commandlet. Use `curl.exe` instead of just `curl` in the commands below to fix this.--:::--```-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-```--### Getting the right tools installed--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 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.--#### Running the importer--- Have Actual running locally on your computer-- Open a terminal / command prompt in the unzipped directory from the previous steps-- Run the following command, substituting the /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.-Refresh the cache.--Once the import is complete, it may not show all the up-to-date information correctly. In order to refresh the view:--- Click the gear icon next to the budget name-- Click Advanced -> Reset budget cache-- Restart Actual--### Contributions--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.