Metadata-Version: 2.4
Name: aib2ofx
Version: 0.76.0
Summary: Download data from aib.ie in OFX format
Author: Jakub Turski
Author-email: Jakub Turski <yacoob@gmail.com>
License-Expression: MIT
Requires-Dist: mechanicalsoup~=1.4
Requires-Dist: python-dateutil>=3.0.0,<4
Requires-Python: >=3.13
Project-URL: Repository, https://github.com/yacoob/aib2ofx
Description-Content-Type: text/markdown

# aib2ofx

...or how to grab transaction data out of AIB's online interface, and format it
into `OFX` file.

**NOTE:** This project is in maintenance mode as of October 2026. I still use
it monthly, but last login sequence update (Feb 2021) made me realise how
brittle this machinery here is. The code that works around Web Storage API
use is ugly and likely to break. The next login update will most likely spell
the end of this script.

Time will tell.

## Usage

Create a `~/.aib2ofx.json` file, with AIB login details.
Set the permission bits to 0600 to prevent other system users from reading it.

    touch ~/.aib2ofx.json
    chmod 0600 ~/.aib2ofx.json

It has a JSON format, single object with one key per AIB login you want to use.

    {
        "bradmajors": {
            "regNumber": "12345678",
            "pin": "12345"
        }
    }

The fields are as follows:

* regNumber
    > Your AIB registered number.

* pin
    > Your five digit PIN.

You can put more than one set of credentials in the file; the script
will download data for all accounts for all logins.

    {
        "bradmajors": {
            "regNumber": "12345678",
            "pin": "12345"
        },
        "janetweiss": {
            "regNumber": "87654321",
            "pin": "54321"
        }
    }

Note that there's no comma after the last account details.

Once you've prepared that config file, run:

    aib2ofx -d /output/directory

The script should connect to AIB, log in using provided credentials,
iterate through all accounts, and save each of those to a separate
file located in `/output/directory`.

## Guarantee

There is none.

I've written that script with my best intentions, it's not malicious,
it's not sending the data anywhere, it's not doing anything nasty. I'm
using it day to day to get data about my AIB accounts into a financial
program that I use. It should work for you as good as it works for
me. See the `LICENSE` file for more details.
