This tool allows you to import transactions from your FinTS enabled bank into Firefly III.
It comes with a web GUI that guides you through the process.
To start the app, choose one of the three methods below:
Start the app by executing the following commands.
git clone https://github.com/bnw/firefly-iii-fints-importer.git
cd firefly-iii-fints-importer
composer install
php -S 0.0.0.0:8080 app/index.php
Alternatively, you can use docker-compose. The following commands will download and start the pre-built image from docker-hub.
git clone https://github.com/bnw/firefly-iii-fints-importer.git
cd firefly-iii-fints-importer
docker-compose up
To update the docker image stored on your machine to the latest version, run docker-compose pull && docker-compose up
.
You can also build the docker image locally. To do so, simply follow the above steps for docker-compose, but replace the line image: benkl/firefly-iii-fints-importer
by build: .
in the docker-compose.yml
. The build usually takes a few minutes.
After completing one of the above steps, browse to http://localhost:8080 and follow the instructions 🙂
Instead of entering all necessary account information every time, you can load it from a JSON-file.
Simply create such a JSON-file in the data/configurations
folder by adapting the provieded data/configurations/example.json
. When starting the app in your browser, you can then choose the JSON-file as a configuration source.
Please note that the bank_2fa
-value in the JSON file corresponds to the number of the 2-factor authentication as listed in app/public/html/collecting-data.twig
.
Thanks to joBr99 for this feature!
This importer can be used without a browser (e.g. by using curl
or wget
). For this you have to specify two GET
parameters:
automate=true
config=example.json
where example.json is a config located in the "data/configurations" folder.curl -X GET 'http://localhost:8080/?automate=true&config=example.json'
wget -O - -q 'http://localhost:8080/?automate=true&config=example.json'
to run the importer.Additionally make sure that you filled out the choose_account_automation
part in the config.
Thanks to Bur0k for this feature!
So far, I could only test this with my personal bank. If you find that it does not work with your bank, please open an issue.