Skip to content

Commit

Permalink
Merge branch 'master' into CommunityProjects-Ieuan-ICS-and-Aamazon-ex…
Browse files Browse the repository at this point in the history
…porter
  • Loading branch information
RubenOlsen authored Jan 6, 2025
2 parents 1fbf917 + 56ab443 commit aa90505
Show file tree
Hide file tree
Showing 5 changed files with 32 additions and 16 deletions.
1 change: 1 addition & 0 deletions .github/actions/spelling/allow/keywords.txt
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ clsx
codemirror
Coinbase
commandlet
Coverflex
Crd
crdt
creditcards
Expand Down
14 changes: 12 additions & 2 deletions docs/community-repos.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,18 @@ The following are implementations of bank syncing using the Actual API. For inst
* **Plaid bank sync** - https://github.com/youngcw/actualplaid



## Other Importers

Actual is used by some people to track money not necessarily found in bank accounts. This can be crypto currency
tracking, loyalty card paybacks, prepaid cards, etc.

* **Coinbase data puller** - https://github.com/SwadeDotExe/Coinbase-To-ActualBudget
- *This script pulls data from a USD and BTC wallet in Coinbase and keeps a wallet in Actual Budget synchronized with this balance.*
* **Portuguese meal cards from My Edenred and Coverflex** - https://github.com/rodriguestiago0/actual-mealcards
- *This script will track Portuguese prepaid meal cards from My Edenred and Coverflex providers*


## Budget Migration

Actual currently has official support for migrating budgets from YNAB4 and nYNAB. The following are available for migrating from other budget apps.
Expand All @@ -43,8 +55,6 @@ Actual currently has official support for migrating budgets from YNAB4 and nYNAB
- *Collection of helper scripts to track home prices and car values, add loan interest transactions, track investment accounts, etc.*
* **Actual Tasks** - https://github.com/rodriguestiago0/actual_task
- *Two utilities to help fix payees and calculate mortgages.*
* **Coinbase data puller** - https://github.com/SwadeDotExe/Coinbase-To-ActualBudget
- *This script pulls data from a USD and BTC wallet in Coinbase and keeps a wallet in Actual Budget synchronized with this balance.*
* **Easy category archive function** - https://github.com/rvisharma/actual-archive-category
- *This tool moves transactions over to an _archive_ category, and then deletes the category.*
* **Actual Budget Backup** - https://github.com/rodriguestiago0/actualbudget-backup
Expand Down
5 changes: 3 additions & 2 deletions docs/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,10 @@
it is much easier to not pull in historical data. First, set up your account(s) with a correct opening balance on a recent date, then set up bank sync. Only
transactions after the opening balance date will be synced, making reconciliation easy.

- **Q.** _Can I import my Actual Budget from the hosted instance of Actual to my Self Hosted version_

**A.** Yes, this has been added to the web version recently, see [our documentation on migrating from the subscription service](./migration/actual-import.md).
- **Q.** _Can I import my Actual Budget from the hosted instance of Actual to my Self Hosted version_.

**A.** The hosted subscription service was shut down in 2024, but if you are still using he old Actual Budget Desktop App, we have a [migration guide in place for this](/docs/migration/#migration-from-the-old-actual-budget-desktop-app).

- **Q.** _How do I update my version of Actual after it has been updated?_

Expand Down
4 changes: 2 additions & 2 deletions docs/install/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,9 @@ The standard way of using Actual is to set up a personal server and use a web br

If you are okay with not having sync, auto-save, or backups then the easiest and fastest way to get started is by using the Actual [web app](https://app.actualbudget.org). This solution requires less setup but more maintenance.

All data is saved to your local browser. The Actual web app never has access to any of your personal data. It is recommended that you save your data (from the [settings](../backup-restore/backup) menu) after every session. If your browser memory is cleared, your data will be lost, so a backup is crucial.
All data is saved to your local browser. The Actual web app never has access to any of your personal data. It is recommended that you save your data (from the [settings](/docs/backup-restore/backup) menu) after every session. If your browser memory is cleared, your data will be lost, so a backup is crucial.

Using a new device or browser requires you to [import](../migration/actual-import#import-backup-file) the saved file for each new device or browser. Remember that these new devices and browsers will not sync without a server set up, so anything you modify on one browser will not appear on others.
Using a new device or browser requires you to [restore](/docs/backup-restore/restore) the saved file for each new device or browser. Remember that these new devices and browsers will not sync without a server set up, so anything you modify on one browser will not appear on others.

:::caution

Expand Down
24 changes: 14 additions & 10 deletions docs/migration/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,22 @@

Keeping your existing transaction history is important. If you already use a different app, you probably want to migrate it over into Actual.

Right now, only YNAB4 is officially supported. However, the [API](../api/index.md) allows anyone to write a custom importer. We will work with the community to help write other importers soon.
Right now, only YNAB4 is officially supported. However, the [API](/docs/api/index.md) allows anyone to write a custom
importer. We will work with the community to help write other importers soon.

## Migration from the old Desktop App

:::note
Are you coming from the original, managed Actual subscription service? That used an older version of the desktop app which doesn't have the export button, but you can log in to the Web version at app.actualbudget.com to export your data in a format suitable for importing in your new instance. See [Backups](../backup-restore/backup.md) and [Restoring](../backup-restore/restore.md).
## Migration from YNAB

Instead of creating an export from the Web app, you can also create a zip archive of your budget folder, which is equivalent. The folder is located at `~/Documents/Actual/My-Budget-abc123` by default on macOS and Linux. The resulting zip file can be imported into Actual via the Web app.
:::note
* [Migration from YNAB4](/docs/migration/ynab4)
* [Migration from nYNAB](/docs/migration/nynab)

## Migration from other apps

:::note
There are guides [here](../advanced/index.md) for some advanced migration tasks.
:::

## Migration from the old Actual Budget Desktop App

Are you coming from the original, managed Actual subscription service? That used an older desktop app version,
which doesn't have the export button. You can also create an equivalent zip archive of your budget folder.
The folder is at `~/Documents/Actual/My-Budget-abc123` by default on macOS and Linux. The the resulting zip file
can be imported into Actual via the Web app.

See [Restoring](/docs/backup-restore/restore.md) how to restore that data in the new open source version.

0 comments on commit aa90505

Please sign in to comment.