Skip to main content

Parse data source (ofx, qif, csv, etc.) and import to Gnucash file.

Project description

GNUCash Magical Importer

Build Status

Set of scripts to manage my personal finance with gnucash. This project have many parsers to gnucash file. The intent is integrate diferents data sources into gnucash data file.

The gnucash's xml file will act as transaction database. All other reports will be born from Parsers.

Source of Information

  • Nubank credit card
  • Itau's checking account
  • CEF's savings
  • Gnucash mobile (untracked expenses: money in wallet, gifts, etc)
  • Bradesco's savings


  • Cronjob to run integrations
  • From any data source, all transactions must be integrate into one file
  • one file with git commits
  • Report of imported files
  • Save gnucash's xml file as regular file instead of binary (compressed) - it can be achived with option file-compression=false in general section of gnucash configuration

Financial Management

Source of transactions

  • Itau Checking Account
  • CEF savings
  • Money in wallet
  • Nubank
  • Bradesco savings


Main goal

  • Single transaction

More Complex Operations

  • A transaction that's is part of another big transaction (a buy with stallments)
  • Monthly (recurrent) payment: HAVAN, RCHLO and utilities bill (gas, water, eletricity)



It can't be used with virtualenv beacause of dependency on python3-gnucash deb package and gnucash itself. So, you'll need install direct in OS with command: ~/universal/projects/gnucash/gnucash-magical-importer/ $ pip3 install -r requirements.txt

Configuration File

This project have a setup.cfg file (ini format) that must be installed to app run. The order of search is:

  1. /etc/gnucash-magical-importer/setup.cfg
  2. /usr/local/etc/gnucash-magical-importer/setup.cfg
  3. /usr/etc/gnucash-magical-importer/setup.cfg
  4. ~/.gnucash-magical-importer/setup.cfg

You can still with make target setup-cfg as: ~/universal/projects/gnucash/gnucash-magical-importer/ $ make setup-cfg

Also, you can remove file with targt remove-cfg and view content of directories with target show-cfg.


For dev machine, you can use docker to development. Build docker with ~/universal/projects/gnucash/gnucash-magical-importer/ $ sudo docker build -t foguinhoperuca/gnucash_magical_importer . --build-arg USE_APT_PROXY=True --build-arg APT_PROXY=

or ~/universal/projects/gnucash/gnucash-magical-importer/ $ make docker_build

Then, run the tests with: ~/universal/projects/gnucash/gnucash-magical-importer/ $ docker run -ti foguinhoperuca/gnucash_magical_importer /bin/sh -c "make test-check"

or ~/universal/projects/gnucash/gnucash-magical-importer/ $ make docker_run

Hacking with bdsit-wheel

  1. manually create egg-info bdsit (bdist_egg) and copy it with expected name as gnucash_magical_importer-0.1.0-py3.6.egg-info in directory build/bdsit.linux-x86_64/wheel;
  2. Comment lines in python3 source code: sudo vim /usr/lib/python3.6/email/ and #559;
  3. Then, run python3 sdist bdist_wheel;
  4. finally, revert step 2;

Similar Projects

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gnucash_magical_importer-0.1.0.tar.gz (12.8 kB view hashes)

Uploaded source

Built Distribution

gnucash_magical_importer-0.1.0-py3.6.egg (30.9 kB view hashes)

Uploaded 3 6

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page