Metadata-Version: 2.4
Name: gnuhealth-client
Version: 5.0.1
Summary: GTK client for the GNU Health Hospital Management System
License-Expression: GPL-3.0-or-later
License-File: COPYING
License-File: LICENSE
License-File: LICENSES/CC-BY-SA-4.0.txt
License-File: LICENSES/CC0-1.0.txt
License-File: LICENSES/GPL-3.0-or-later.txt
Keywords: health,hospital,HIS,eHealth,gnuhealth
Author: GNU Solidario
Author-email: health@gnusolidario.org
Maintainer: Luis Falcon
Maintainer-email: falcon@gnuhealth.org
Requires-Python: >=3.10,<3.15
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: X11 Applications :: GTK
Classifier: Framework :: Tryton
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Healthcare Industry
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Provides-Extra: calendar
Provides-Extra: sound
Requires-Dist: GooCalendar (>=0.7) ; extra == "calendar"
Requires-Dist: PyGObject (>=3.19)
Requires-Dist: playsound ; extra == "sound"
Requires-Dist: pycairo
Requires-Dist: python-dateutil
Project-URL: Bug Tracker, https://codeberg.org/gnuhealth/his-client/issues
Project-URL: Documentation, https://docs.gnuhealth.org
Project-URL: Homepage, https://www.gnuhealth.org
Project-URL: Repository, https://codeberg.org/gnuhealth/his-client
Description-Content-Type: text/x-rst

.. SPDX-FileCopyrightText: 2017-2025 Luis Falcón <falcon@gnuhealth.org>
.. SPDX-FileCopyrightText: 2017-2025 GNU Solidario <health@gnusolidario.org>
..
.. SPDX-License-Identifier: CC-BY-SA-4.0 

The GNU Health GTK Client
=======================================================================

The GTK client allows to connect to the GNU Health HMIS component server from the
desktop.


Installation
------------
You can install the GNU Health HMIS client using your distro package or via pip::

 $ pip install --upgrade gnuhealth-client



Technology
----------
The GNU Health HMIS client is a Python application that derives from 
the Tryton GTK client, with specific features of GNU Health and healthcare sector.

The default profile
-------------------
The GNU Health client comes with a pre-defined profile, which points to
the GNU Health community demo server::

 Server : federation.gnuhealth.org
 Port : 8000
 User : admin
 Passwd : gnusolidario


GNU Health Plugins
------------------
You can download GNU Health plugins for specific functionality.

For example:

* The GNU Health **Crypto** plugin to digitally sign documents using GNUPG
* The GNU Health **Camera** to use cameras and store them directly 
  on the system (person registration, histological samples, etc..)
* The **Federation Record Locator**, that communicates with **thalamus**
  and interacts with the GNU Health Information System and Person Master Index.

More information about the GNU Health plugins at :

https://docs.gnuhealth.org/his/plugins

  
The GNU Health client configuration file
----------------------------------------
The default configuration file resides in::

 $HOME/.config/gnuhealth/<version>/gnuhealth-client.conf

Using a custom greeter / banner
-------------------------------
You can customize the login greeter banner to fit your institution.

In the section [client] include the banner param with the absolute path
of the png file.

Something like::

 [client]
 banner = /home/yourlogin/myhospitalbanner.png

The default resolution of the banner is 500 x 128 pixels. Adjust yours
to approximately this size.

Development
-----------
The development of the GNU Health client will be done at Codeberg.

The development mailing list is at health-dev@gnu.org 
General questions can be done on health@gnu.org mailing list.

Note: You need to subscribe before posting or the messages will be automatically
discarded. More at: https://docs.gnuhealth.org/his/support.html

Homepage
--------
https://www.gnuhealth.org


Documentation
-------------
The GNU Health GTK documentation will be at the corresponding
chapter in the GNU Health official documentation portal

https://docs.gnuhealth.org

