aboutsummaryrefslogtreecommitdiff

jali

About

This is a small python3 program to import transactions from your bank via aqbanking and insert it automagically in your ledger files.

Requirements

  • python3
  • jinja, pendulum for members extension
  • ledger http://ledger-cli.org/
  • aqbanking http://www2.aquamaniac.de/sites/aqbanking/index.php

Shorcut with nix:

Create the following file as shell.nix in your accounting repository and run nix-shell. (Bump jali version to HEAD commit hash of this repo to be up-to-date.)

with import <nixpkgs> {};
let
  andir = import (builtins.fetchTarball {
    url = "https://github.com/andir/nixpkgs/archive/aqbanking.tar.gz";
    sha256 = "06m7risi68jfqgv001ip77lzz6bylvvdn5j8sn845c54zpm6qp36";
  }) {};
  jali = with python36Packages; buildPythonApplication rec {
    name = "${pname}-${version}";
    pname = "jali";
    doCheck = false;
    version = "b47d3b9f";
    src = fetchgit {
      url = "https://git.darmstadt.ccc.de/jali/jali.git";
      rev = version;
      sha256 = "0l5h9hjri77zifx3x4khw7ncmmc9l9ppisdjilsfllzkabz4xjf4";
    };
    propagatedBuildInputs = [ jinja2 pendulum GitPython andir.aqbanking ];
  };
in stdenv.mkDerivation {
  name = "buchhaltung";
  buildInputs = [
    hledger
    haskellPackages.hledger-ui
    ledger
    jali
  ];
}

Get started

  • Install python3, ledger and aqbanking
  • Install jinja and pendulum via pip or your package manager.
  • Run pip install (--user) .
  • Configure aqbanking, you can try it with the commandline, actually gnucash has a nice wizard for this on board, you can try it, if you can’t find another way.
  • Run jali

Configuration

  • Run jali --help for options.
  • Copy example-config.py to ~/.config/jali/config.py to configure.
  • jali will put your files in ~/ledger if you don’t configure it.
  • jali will use your configured locale to determine the formatting of currencies. You can change that in the settings.

Contribution

We are always happy about bug reports, enhancement suggestions or pull requests.

Feel free to talk to us on matrix (#jali:darmstadt.ccc.de) or irc (ircs://irc.hackint.org/jali).

Or contact @maralorn:

malte.brandy@maralorn.de
@maralorn:maralorn.de
maralorn @ irc.hackint.eu

License

MIT License see LICENSE file