Windows
========
Windows does not ship with the perl programming language by default.
You can install perl for Windows from http://www.activestate.com/activeperl
After you've installed ActivePerl you need to install additional perl modules.
Start the ActivePerl Perl Package Manager and install the following modules:
- Text-CSV_XS
- File-HomeDir
- JSON
- Term-ReadKey
- Business-PayPal-API

Then extract the csv2iif zip archive. You should be able to run the programs
csv2iif.pl and paypal2iif.pl directly if ActivePerl was installed correctly.
It is recommended to run the program from a command line shell, so you can see
the output or error messages.

You will need to configure the programs by editing the configuration file
configuration.pm You need a "text editor" to edit the program, do not use a word
processor like Microsoft Word or Open Office. The Windows program Notepad can
be used, an alternative is http://notepad-plus-plus.org or any other text
editor which can be used for developing source code.

The README.txt file explains how to configure and run the programs.

Mac OsX, Linux, FreeBSD
========================
you have to install two perl modules:
- File::HomeDir
- Text::CSV_XS
- JSON
- Business::PayPal::API
- Term::ReadKey
To do so, run the following commands:

$ sudo cpan

If you execute the cpan program for the first time, answer all the questions
for its auto configuration. The default values should be fine.
In the CPAN shell run the following commands to install the perl modules:

> install File::HomeDir
> install Text::CSV_XS
> install JSON
> install Business::PayPal::API
> install Term::ReadKey
> exit

It is recommended to run the program from a command line shell, so you
can see the output or error messages.

You will need to configure the programs by editing the configuration file
configuration.pm You need a "text editor" to edit the program, do not use a word
processor like Apple Pages or Microsoft Word. The OsX default program
TextEdit can be used.

The README.txt file explains how to configure and run the programs.

Gentoo Linux
-------------

On Gentoo Linux you can use the emerge: target in the Makefile to
install the perl dependencies. As the root user execute:

# make emerge

Mac OsX
--------

The default perl version on recent OsX releases (up to 10.14) is
rather old, typically perl 5.18. This version does not support HTTPS
with TLS 1.2 or later, which is required by PayPal. You can install a
more recent version of perl with Homebrew https://brew.sh/