Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sschuberth/stan

A bank account statement analyzer
https://github.com/sschuberth/stan

account analyzer bank convert csv excel export json mt940 ofx pdf postbank qif statement

Last synced: 3 months ago
JSON representation

A bank account statement analyzer

Awesome Lists containing this project

README 

        
# Stan - The *St*atement *An*alyzer



## What's this?



Stan is both a library and command line tool to convert and analyze bank account statements. It works completely offline by parsing the statement files you specify and does *not* require any online or [HBCI](http://www.hbci-zka.de/spec/spezifikation.htm) connection.



## What statement files are supported?



- [Postbank PDF](https://www.postbank.de/privatkunden/docs/Kontoauszug_A4_Privatkunden.pdf)



  The Postbank has changed the format for PDF account statements multiple times. The supported formats are the ones introduced in July 2014 and in June 2017, respectively.



- [FYRST PDF](https://www.fyrst.de/faq/#expendable_faq_erste_schritte_1-1)



  This is a variant of the Postbank PDF account statements.



- [Postbank DB PDF](https://www.postbank.de/privatkunden/services/kundenservice/gut-zu-wissen.html)



  The new (monochrome) PDF format after the Postbank's IT migration to the Deutsche Bank infrastructure in 2023.



- [ING(-DiBa)](https://www.ing.de/girokonto/)



- [PSD Bank PDF](https://www.psd-bb.de/privatkunden/girokonto-und-karte/konten-im-ueberblick.html)



## What file formats can be exported to?



- [CSV](https://en.wikipedia.org/wiki/Comma-separated_values)



  CSV files offer a simple generic way to further process the statement data, e.g. in online tools like [Priotecs MoneyControl](https://primoco.me/).



- [Excel](https://en.wikipedia.org/wiki/Microsoft_Excel)



  Excel 2007 XLSX files are supported.



- [JSON](https://www.json.org/)



  JSON files offer a powerful generic way to further process the statement data.



- [MT940](https://de.wikipedia.org/wiki/MT940) (support is experimental)



  MT940 files can be imported to many (professional) finance applications, e.g. [AckiSoft Finanzmanager](https://www.ackisoft.de/).



- [OFX](https://financialdataexchange.org/FDX/About/OFX-Work-Group.aspx?a315d1c24e44=2#a315d1c24e44) (version 1)



  OXF files can be imported into finance applications like [GnuCash](https://www.gnucash.org/), [HomeBank](http://homebank.free.fr/en/index.php) or [jGnash](https://ccavanaugh.github.io/jgnash/).



- [QIF](https://en.wikipedia.org/wiki/Quicken_Interchange_Format)



  QIF files can be imported into finance applications like [GnuCash](https://www.gnucash.org/), [HomeBank](http://homebank.free.fr/en/index.php), [jGnash](https://ccavanaugh.github.io/jgnash/) or [Money Manager Ex](https://www.moneymanagerex.org/).



- [SUPA](https://www.subsembly.com/download/SUPA.pdf)



  Subsembly's SUPA format is used by the [Banking4](https://www.subsembly.com/banking4.html) application.



## How to run the command line tool?



As there are no binary releases yet, the easiest way to run Stan currently is by cloning the source code repository and

leveraging Gradle's [run task](https://docs.gradle.org/current/userguide/application_plugin.html#sec:application_tasks):



    $ ./gradlew :cli:run --args="--help"



This will both build (if required) and run Stan. Then follow the usage instructions and replace `--help` in the above

run with the desired options.



Alternatively, you can first create / install OS-specific run scripts via



    $ ./gradlew installDist



and then run Stan by executing a script like



    $ ./cli/build/install/stan/bin/stan --help