Scroll to navigation

GNUmed(1) General Commands Manual GNUmed(1)


GNUmed - an electronic MEDICAL record software for GP offices

This is not fully featured yet. Use at your own risk. You have been warned.


gnumed [--quiet|debug] [--slave] [--text-domain=TEXTDOMAIN] [--log-file=FILE] [--conf-file=FILE] [--lang-gettext=LANGUAGE] [--ui=UI-TYPE] [--wxp=VERSION] [--tool=TOOL] [--override-schema-check] [--local-import] [--help] [--version] [-V] [-h|?]


GNUmed is a solution for keeping safe and medically sound electronic records on a patient's health. It primarily focuses on GP offices. It is released under the GPL.

GNUmed is written in Python with wxPython/wxWindows. Data is stored in a PostgreSQL database. Multiple clients can work with the same database at the same time.


Be extra quiet and show only _real_ errors in the log.
Pre-set the [debug mode] checkbox in the login dialog which controls increased verbosity in the log file.

Useful for, well, debugging :-) Slower, too.

Pre-set the [enable remote control] checkbox in the login dialog to enable the XML-RPC remote control feature.
Enable HIPAA features with user workflow impact.

Those features which do not affect the workflow of the user are permanently enabled.

Set this to change the name of the language file to be loaded. Note, this does not change the directory the file is searched in, only the name of the file where messages are loaded from. The standard textdomain is, of course, "". You need only specify the base name of the file without the .mo extension.
Use this to change the name of the log file. The default log file would be <~/.gnumed/gnumed.log>.
Use configuration file FILE instead of searching for it in standard locations.
Explicitly set the language to use in gettext translation. The very same effect can be achieved by setting the environment variable $LANG from a launcher script.
Explicitly set the user interface type. Omitting this argument will default the interface to wxPython.

Valid values are:

wxp: wxPython Python client (default)

Explicitly request a wxPython major version. Omitting the argument will default to trying wxPython 3 first, then attempting to fall back to wxPython 2.

Valid values are:

2: request wxPython 2

3: request wxPython 3

Run the named TOOL instead of a GUI.

Currently implemented tools:

check_enc_epi_xref: Cross-check that foreign keys values in any given row of any table carrying both of fk_episode and fk_encounter do point to episodes and encounters, respectively, of the very same patient.

export_pat_emr_structure: Export the EMR structure (issues and episodes) of a patient into a text file.

check_mimetypes_in_archive: Show mimetypes and related information of all document parts in the archive.

read_all_rows_of_table: Check readability of all rows of a given table.

Continue loading the client even if the database schema version and the client software version cannot be verified to be compatible.
Skip checking for client updates. This is useful during development or when the update check URL is unavailable.
At startup adjust the PYTHONPATH such that the GNUmed client is run from a local copy of the source tree rather than from a proper system-wide installation.
Show version information about the GNUmed client and the database it needs.
Well, show this help.


> 0: some error occurred while the GUI client was run

0: normal termination of the client

< 0: some error occurred while trying to run a console tool

-1: an unknown console tool was requested
< -1: an error occurred while a console tool was run
-999: hard abort of the client


See gettext(1) for how the various locale related environment variables work.


The system-wide configuration file.
The user-specific configuration file.
The default log file.

Detailed Wiki-style documentation
Users' website
German website
Mailing list home
Source code repository (Git)
Local documentation
List man pages on gm-* commands.


A lot of functionality is still missing. To make up for that, there's bugs here and there for you to report :-)

Use at your own risk. You have been warned. Take proper backups !

2020 Mar 11th Manual for GNUmed