Skip to content

About

Chrome + Firefox extension that syncs Actual Budget account balances into ProjectionLab via its Plugin API

Resources

Stars

6 stars

Watchers

0 watching

Forks

Repository files navigation

Actual Budget → ProjectionLab Sync

A Chrome + Firefox extension that syncs account balances from a self-hosted Actual Budget instance into ProjectionLab via its Plugin API.

Chrome Web Store Firefox Add-ons

How it works

Actual has no browser-callable API, so a small server-side bridge (jhonderson/actual-http-api) re-exposes it over HTTP. See deploy/ for setup.

Actual -> actual-http-api bridge -> extension -> ProjectionLab

Account mapping

Map each Actual account to a ProjectionLab account on the options page; the extension sums the Actual balances mapped to each PL account and writes that one total. Map by behavior, not one-to-one: group accounts the projection treats alike (e.g. all current accounts into one cash account) and split only where growth or tax treatment differs. Unmapped accounts still count toward historical net worth (bucketed coarsely by balance sign) but aren't pushed to Current Finances.

Credit cards you pay off monthly: map them to your cash account, not a debt account. ProjectionLab treats a paid-monthly card as an expense, so netting its negative balance into cash keeps net worth exact with no debt line that never pays down. Use a PL debt account only for debt you actually carry (mortgage, loan).

ProjectionLab API limitation

PL stores net-worth history as eight fixed buckets, but the Plugin API exposes an account's type, not the bucket it resolves to. So backfilled history is bucketed only by PL account category (savings, investment, asset, debt). The net-worth total stays exact and Current Finances shows the full tax split (PL computes it live); only the historical tax-composition is coarsened. A Plugin API method to classify accounts would let the extension rebuild the full split.

Develop

Built with WXT + TypeScript.

pnpm install    # deps + generated types
pnpm dev        # Chrome, hot-reload (Firefox: load .output/firefox-mv3 via about:debugging)
pnpm build      # package for the stores (build:firefox for the Firefox MV3 build)

Release

Releases are tag-driven. Bump version in package.json, commit, then tag it:

git tag v1.0.0 && git push origin v1.0.0

The tag runs release.yml: it rejects a tag that disagrees with package.json, builds both zips, attests their provenance, creates the GitHub Release, and submits to both stores. Neither store accepts a version it already lists, so the version bump is what makes a release possible; the tag only triggers it.

Disclaimer

Independent, unofficial project. Not affiliated with, endorsed by, or sponsored by Actual Budget or ProjectionLab; both names are the property of their respective owners.

About

Chrome + Firefox extension that syncs Actual Budget account balances into ProjectionLab via its Plugin API

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages