cberetta / greenpass

Scriptable green pass verifier.

Green Pass Verifier

Scriptable green pass verifier. With this application you can automatize accesses based on green pass validity.

Installation

You need to have pip and libzbar to install the application.

You can install it using your favorite package manager, for instance in Ubuntu:

$ sudo apt install python3-pip libzbar0

You can just install the application using pip:

$ pip install greenpass

If you want to install it from sources, install the python3 requirements using the following command:

$ pip3 install -r requirements.txt

Usage

You can feed the application with different file formats, for instance:

Green pass official PDFs

$ greenpass --pdf greenpass.pdf

QRCode images in PNG

$ greenpass --qr greenpass.png

Txt files with the content of the qrcode

$ greenpass --txt greenpass.txt

Standard input and pipes

$ zbarimg --raw greenpass.png | greenpass --txt -

On a side note, you can verify camera-acquired images if your scanner prints the raw content of the QRcode on stdout

$ zbarcam --raw -q1 | greenpass --txt -

The application returns an UNIX compatible code, therefore you can concatenate commands that will be executed only if the green pass is verified.

$ greenpass --qr greenpass.png && echo "green pass ok"

You can also get the expiration configuration using --settings without other inputs.

$ greenpass --settings

Pointers

If you want more information on the green pass certification and how to parse or verify it you can refer to the following resources:

Greenpass Encoding documentation

Official Italian Android application

JSON schema and specifications

A very detailed blog post on how decode the pass