GNU Health/Plugins

From Wikibooks, open books for an open world
Jump to navigation Jump to search

Introduction[edit | edit source]

The GNU Health Plugins are client-side programs that provide extra functionality. They are installed locally.

Initialize the plugin directory[edit | edit source]

The GNU Health plugins are installed in your $HOME directory, under "gnuhealth_plugins".

mkdir $HOME/gnuhealth_plugins

In order to keep the GNU Health plugins compatible with the latest client, you need to create a link to the GNU Health plugins directory

ln -si $HOME/gnuhealth_plugins $HOME/.config/gnuhealth/4.0/plugins

The GNU Health Camera[edit | edit source]

The GNU Health camera plugin allows to visualize, transfer and store media from a webcam device ( camera, microscope, ... ).

There are many contexts where the camera is useful, some of them :

  • Person or patient registration
  • Domiciliary units surveys
  • Histological studies
  • EKG strips
  • Telemedicine
  • Dx Imaging
  • ...

The information captured by the device will be transferred and stored in the GNU Health server.

Installing OpenCV[edit | edit source]

The GNU Health camera uses the excellent Open Computer Vision library ("OpenCV"). You need to install the opencv package for your operating system.

Install the Python bindings for OpenCV of your distribution. In openSUSE, the package is python3-opencv . In Archlinux, python-opencv

How to check the correct installation of OpenCV: import the module CV2 in the python interpreter

$ python3
Python 3.10.5 (main, Jun  6 2022, 18:49:26) [GCC 12.1.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import cv2

If no errors, the installation is successful!

Installing the GNU Health Camera[edit | edit source]

Download and uncompress the latest version from GNU into your home directory

cd $HOME
tar -xzvf gnuhealth-camera-plugin-latest.tar.gz

Restart the client

Invoking the GNU Health Camera[edit | edit source]

Invoking the GNU Health camera from the client

From the client, click on the Launch action icon, and select "GNU Health Camera"

Gnuhealth camera plugin

Using the Camera[edit | edit source]

"a" : attach any media taken from the camera device into the current model.

[SPACE] : store the media as a binary field, for instance, as the person / patient picture. To store the media as a picture, press the SPACE bar. Currently GNU Health has the party model person picture predefined.

"h" : Show the help menu

"q" : Quit the camera

After you transfer the media, you need to refresh the current view [CONTROL + R]

GNU Health Crypto plugin[edit | edit source]

GNU Health allows signing and encrypting documents with the GNU Privacy Guard plugin.

The Crypto plugin works along with the GNU Health Crypto Module .

In order to use it, you need the following in your client:

  • The GNU Health crypto plugin for the Tryton client, shipped with the main tarball (under the backend/plugins directory). Since 2.8.0, the GNU Health Tryton crypto plugin will be a separate package.
  • The GPG package (comes with most modern operating systems).
  • The python-gnupg library (

Installation of the Crypto plugin[edit | edit source]

We assume you have installed the GNU Health client using the sources.

Place the "crypto" directory containing the plugin under the "gnuhealth_plugins" of your client.

cp -a gnuhealth_crypto_plugin_dir $HOME/gnuhealth_plugins