Skip to content

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

License

Notifications You must be signed in to change notification settings

martinohansen/ynabber

Repository files navigation

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 here

Once the environment variables are set, run the binary:

# Read environment variables from file first
set -a; . ./ynabber.env; set +a; ynabber
ynabber

Or run in a container with Docker:

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.

About

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

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Languages