hoejmann / ynabber

Ynabber reads bank transactions from GoCardless (formerly Nordigen) and writes them into YNAB

Ynabber

Ynabber sets out to read and write bank transactions from one or more sources (known as readers) to one or more destinations (known as writers).

For a list of supported see the readers and writers subsections.

Installation

Install Go and run go install to install binary

go install github.com/martinohansen/ynabber/cmd/ynabber@latest

Usage

Ynabber is configured with environment variables. To read from Nordigen (now known as GoCardless) and write to YNAB use these values:

cat <<EOT >> ynabber.env
# YNAB
YNAB_BUDGETID=<budget_id>
YNAB_TOKEN=<account token>
YNAB_ACCOUNTMAP={"<IBAN>": "<YNAB account ID>"}

# Nordigen
NORDIGEN_BANKID=<nordigen bank ID>
NORDIGEN_SECRET_ID=<nordigen secret ID>
NORDIGEN_SECRET_KEY=<nordigen secret key>
EOT

All valid config options can be found in the config.go file.

To read the environment variables from a file and run the binary one can use the declare command:

# Read environment variables from file and run ynabber
declare $(cat ynabber.env); ynabber

Or run the container and parse in the variables with Docker

docker run --env-file=ynabber.env ghcr.io/martinohansen/ynabber:latest

# To keep data persistent
docker run \
    --volume ${PWD}:/data \
    --env 'YNABBER_DATADIR=/data' \
    --env-file=ynabber.env \
    ghcr.io/martinohansen/ynabber:latest

Readers

Currently tested readers and verified banks, but any bank supported by Nordigen should work.

Reader	Bank
Nordigen1	ALANDSBANKEN_AABAFI22	✅
	NORDEA_NDEADKKK	✅
	NORDEA_NDEAFIHH	✅
	NORWEGIAN_FI_NORWNOK1	✅
	S_PANKKI_SBANFIHH	✅

Writers

The default writer is YNAB (that's really what this tool is set out to handle) but we also have a JSON writer that can be used for testing purposes.

Writer	Description
YNAB	Pushes transactions to YNAB
JSON	Writes transactions to stdout in JSON format

Contributing

Pull requests are welcome.

Footnotes

1. Please open an issue if you have problems with a specific bank. ↩