Quick Start

Install Python 3, pip, and programme itself, if they’re not already present. The commands will differ by OS; this example is for Mint, Ubuntu, and other Debian-based systems:

sudo apt install python3-pip
pip3 install ajv.programme

Now generate a blank performer file, as follows:

programme --init > performers.tsv

Open performers.tsv in your spreadsheet program of choice. It may prompt you for import settings; the only relevant one is the delimiter, which should be a tab.

Fill in the columns on the spreadsheet. Anything left blank will be ignored. Save when done. Then:

programme performers.tsv output.html

That’s it. Open output.html and you should get something usable. If you specified images in the tsv file, and if those files are present in the same directory, they’ll be included in the output as portraits.

You can run programme --help to see additional options.