GNUmed(1)

📦 version 1.8.24, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 GNUmed(1) 💖

okay bestie, welcome to the General Commands Manual page for GNUmed — yes that GNUmed, the medical record one. grab a strawberry 🍓 and let's get you all the way together on this. no cap, every single flag is in here.

🌸 NAME 🌸

GNUmed — an electronic MEDICAL record software for GP offices.

🚨 real talk, and I'm not being cute about it: this is not fully featured yet. Use at your own risk. You have been warned.

✨ SYNOPSIS ✨

gnummed [--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|?]

🩺 DESCRIPTION 🩺

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. 👑 (yes, multiple, simultaneously, iconic behaviour)

💅 OPTIONS 💅

  • --quiet — be extra quiet and show only _real_ errors in the log. that's it, that's the vibe. silence, but make it medical. 🤫
  • --debug — pre-set the [debug mode] checkbox in the login dialog, which controls increased verbosity in the log file.

Useful for, well, debugging :-) Slower, too. (you're trading speed for ✨information✨, that's the deal)

  • --slave — pre-set the [enable remote control] checkbox in the login dialog to enable the XML-RPC remote control feature.
  • --hipaa — enable HIPAA features with user workflow impact.

Those features which do not affect the workflow of the user are permanently enabled. (so this flag is only about the ones that get in your way 🫶)

  • --text-domain=TEXTDOMAIN — 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, "gnumed.mo". You need only specify the base name of the file without the .mo extension.
  • --log-file=FILE — use this to change the name of the log file. The default log file would be <~/.gnumed/gnumed.log>.
  • --conf-file=FILE — use configuration file FILE instead of searching for it in standard locations.
  • --lang-gettext=LANGUAGE — 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. two roads, same destination 🦋
  • --ui=UI-TYPE — explicitly set the user interface type. Omitting this argument will default the interface to wxPython.

Valid values are:

  • wxp: wxPython Python client (default)
  • --wxp=VERSION — 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
  • --tool=TOOL — run the named TOOL instead of a GUI. no window, just vibes and output.

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.
  • --override-schema-check — continue loading the client even if the database schema version and the client software version cannot be verified to be compatible. 😭 proceed at your own peril, bestie.
  • --skip-update-check — skip checking for client updates. This is useful during development or when the update check URL is unavailable.
  • --local-import — 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.
  • --version, -V — show version information about the GNUmed client and the database it needs.
  • --help, -h, or -? — well, show this help.

🔥 EXIT STATUS 🔥

  • > 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 💀

🌈 ENVIRONMENT 🌈

  • LANG, LC_MESSAGES, etc. — see gettext(1) for how the various locale related environment variables work.

🎀 FILES 🎀

  • ~/etc/gnumed/gnumed-client.conf — the system-wide configuration file.
  • ~/.gnumed/gnumed.conf — the user-specific configuration file.
  • ~/.gnumed/gnumed.log — the default log file.

🧚 SEE ALSO 🧚

💀 BUGS 💀

A lot of functionality is still missing. To make up for that, there's bugs here and there for you to report :-) (they're basically gifts, if you squint)

Use at your own risk. You have been warned. Take proper backups ! ⚠️ genuinely, back it up.

okay that's the whole page, you ate it. 💖 signing off with the cute deets: this is the Manual for GNUmed, dated 2020 Mar 11th, and yeah it's still GNUmed(1) at the end of the day. mwah. 🫶✨

📦 where this page comes from