https://github.com/janw/cleanab
Clean up FinTS bank transaction data before importing it to YNAB or Firefly III
https://github.com/janw/cleanab
fints firefly-iii python yaml ynab ynab-api
Last synced: 2 months ago
JSON representation
Clean up FinTS bank transaction data before importing it to YNAB or Firefly III
- Host: GitHub
- URL: https://github.com/janw/cleanab
- Owner: janw
- License: apache-2.0
- Created: 2019-06-23T10:01:49.000Z (almost 6 years ago)
- Default Branch: main
- Last Pushed: 2023-05-26T08:37:28.000Z (about 2 years ago)
- Last Synced: 2025-02-12T14:59:00.651Z (4 months ago)
- Topics: fints, firefly-iii, python, yaml, ynab, ynab-api
- Language: Python
- Homepage:
- Size: 107 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CleanAB — Clean A Budget for YNAB
[](https://codeclimate.com/github/janw/cleanab/maintainability)
[](https://codeclimate.com/github/janw/cleanab/test_coverage)
This is re-[inventing](https://github.com/schurig/ynab-bank-importer) [the](https://bitbucket.org/ctheune/ynab-bank-imports/src/default/) [wheel](https://github.com/bank2ynab/bank2ynab). 💁♀️
Import FinTS/HBCI transactions (🇩🇪 👋) into [YNAB](https://ynab.com/referral/?ref=DP9o_rOK4sNtCxhD&utm_source=customer_referral) (Affiliate Link) using its API. My rationale for creating this (instead of using an existing solution), was the poor parsing/processing/cleanup of transaction data like payee and memo in other tools. Configuratin is done in YAML and can include an arbitrary amount of replacement definitions that should be applied to the transaction data. See [config.yaml.sample](config.yaml.sample) for example use.
## Running with Docker
Cleanab is now hosted in GitHub Container Registry:
```
ghcr.io/janw/cleanab
```
Copy [config.yaml.sample](config.yaml.sample) to a location of your chosing, adjust to your setup, and mount it to `/app/config.yaml` in a container:
```bash
docker run \
--rm
-v /path/to/your/config.yaml:/app/config.yaml \
ghcr.io/janw/cleanab
```