Skip to content

cimm/codav

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CODAv

An "XML message for Credit Transfer Initiation" (ISO 20022 XML) file encodes European credit transfers (SEPA) in a standard way. It's often refered to as a "CODA (Coded Statement of Account) file". It requests the movement of funds from the debtor account to a creditor.

CODAv is a desktop application that understands these electronic messages and serves as a viewer to verify the contents of these files. CODAv follows the Belgian implementation guidelines as defined by the Belgian sector federation Febelfin.

Screenshot

The current itteration shows all fields from the CODA XML in a table view like one would expect on a spreadsheet. A sperate panel shows the header fields and the sum of all transactions per currency.

Install

CODAv is tested on Ubuntu 16.04, 17.10, 18.04, and macOS Sierra. It's written in Vala and depends on GTK 3 and libxml 2. Download or clone the repository and run the following from within its root directory.

Linux

Install the dpendencies first, we use the Vala repository for a more recent Vala version.

sudo add-apt-repository -yu ppa:vala-team
sudo apt install valac libgtk-3-dev libxml2-dev cmake

Now build and install CODAv:

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr ..
make
sudo make install

macOS

Make sure you have Homebrew to install the dependencies:

brew install gtk+3 adwaita-icon-theme vala cmake

Now build and install CODAv:

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr ..
make
sudo make install

Development

Some useful notes for the development of this application, not needed to actually run it.

Snapcraft

You'll need snapcraft to build the snap yourself, the snapcraft.yaml file contains the snap build instructions and can be found in the /snap directory. Run snapcraft cleanbuild from the project's root directory of the project, not from within the /snap directory, it will download the necessary dependencies and spit out the snap package. You'll need LXD to build the snap with cleanbuild (it uses a container).

You can try out the local snap with:

snap install codav_0.1_*.snap --dangerous