Beancount N26 Importer
beancount-n26 provides a Beancount Importer for converting CSV exports of
N26 account summaries to the Beancount format.
Installation
$ pip install beancount-n26
In case you prefer installing from the Github repository, please note that main is the
development branch so stable is what you should be installing from.
Usage
Beancount 3.x
Beancount 3.x has replaced the config.py file based workflow in favor of having a
script based workflow, as per the changes documented here. The beangulp examples
suggest using a Python script based on beangulp.Ingest. Here's an example of how that
might work:
Add an import.py script in your project root with the following contents:
from beancount_n26 import N26Importer
from beangulp import Ingest
importers = (
N26Importer(
IBAN_NUMBER,
'Assets:N26',
language='en',
file_encoding='utf-8',
),
)
if __name__ == "__main__":
ingest = Ingest(importer)
ingest()
... and run it directly using python import.py extract.
Beancount 2.x
Add the following to your config.py.
from beancount_n26 import N26Importer
CONFIG = [
N26Importer(
IBAN_NUMBER,
'Assets:N26',
language='en',
file_encoding='utf-8',
),
]
Classification
To classify specific recurring transactions automatically, you can specify an
account_patterns parameter. The key should be the account name and the items in the
list are regular expressions that should match a payee.
A few helper functions have been provided in
beancount_n26/utils/patterns_generation.py to help you generate this dictionnary.
Beancount 3.x
from beancount_n26 import N26Importer
from beangulp import Ingest
importers = (
N26Importer(
IBAN_NUMBER,
'Assets:N26',
account_patterns={"Expenses:Supermarket": ["REWE", "ALDI"]}
),
)
if __name__ == "__main__":
ingest = Ingest(importer)
ingest()
Beancount 2.x
from beancount_n26 import N26Importer
CONFIG = [
N26Importer(
...
account_patterns={"Expenses:Supermarket": ["REWE", "ALDI"]}
),
]
Contributing
Please make sure you have Python 3.9+ and Poetry installed.
-
Git clone the repository -
git clone https://github.com/siddhantgoel/beancount-n26 -
Install the packages required for development -
poetry install -
That's basically it. You should now be able to run the test suite -
poetry run task test.
1 maintainer
Metadata
1 maintainer
Release files for beancount-n26 1.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| beancount_n26-1.6.0.tar.gz | 6.1 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| beancount_n26-1.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.3 kB
Release files / beancount_n26-1.6.0.tar.gz
| Download URL | beancount_n26-1.6.0.tar.gz |
|---|---|
| Size | 6.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1092f7a831beb9ede915b1c1f62d2d6dc2beed7bfe81943755bccf04fbe1086e
|
|
BLAKE2b-256 checksum How to use checksums |
e5047dba8102dcc3667d00b4892eced455bc1cf196708271c05dada8597956bf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.14.5 Darwin/25.3.0
|
Release files / beancount_n26-1.6.0-py3-none-any.whl
| Download URL | beancount_n26-1.6.0-py3-none-any.whl |
|---|---|
| Size | 7.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f7cb7bcc6243ca654f03271cbad4fdafe0ee1bc3195ac55ba9b5f3a7478892f8
|
|
BLAKE2b-256 checksum How to use checksums |
a6829173b3ba5e6b72c0dd8b8f0ee6d89016f9e968735be9ecbf5b0b235d8c68
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.14.5 Darwin/25.3.0
|
Security for beancount-n26 1.6.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
