MedScript is a medical prescription writing software. It is primarily for medical practitioners for writing prescriptions.
The purpose of the program is to enable medical practitioners to prepare computerized prescriptions. The program has been designed after the commonly used prescription format among the medical practitioners in India. Inclusion of prescription style of other regions will hopefully be implemented in future updates.
Please note that this is a beta version and is meant for testing. Bugs are to be expected. If you find them, report them to the developer.
Mandatory warning: always back up your data. A single copy of data is as good as none.
The program uses a custom file format .mpaz (Medical Prescription Archive - Zipped). It is a zip file in a specific format which includes:
Optionally the mpaz archive may also include an S/MIME signature and certificate for authentication.
MedScript can be used by simply downloading it from the repository and running it with the Python 3 interpreter. The necessary python libraries need to be installed. Alternatively the release versions can be downloaded and used directly.
The git repo can also be cloned by running git clone https://code.agnibho.com/repo/medscript.git.
If you use flatpak, you can install MedScript by running the following commands:
> flatpak remote-add --user --if-not-exists MedScript https://code.agnibho.com/medscript/download/MedScript.flatpakrepo
> flatpak install com.agnibho.MedScript
If you are on Windows, you can download the Windows installation file of MedScript from the sidebar.
By default Medscript creates a MedScript folder in the user's home directory and uses it to save the necessary files.
The common functionalities of the program can be used within the graphical interface. Editing of some configuration files are needed only for the advanced features such as custom presets.
When starting the program, the main window of is shown.The menu bar at the top can be used to access most of the functions. The toolbar below it contains the most commonly used functions for quick access.
A new prescription can be created right from the starting window. Alternatively the "New" menu option can be used to create a new prescription.
There are eight tabs in the tab bar containing important parts of a prescription.
The "Save" or the "Save As" option from the "File" menu can be used to save a file created or edited in the program.
The prescriptions are saved in .mpaz files and can be shared easily. To open a prescription file, the "Open" option from the file menu can be used. Alternatively the file name can be supplied to the program as command line argument when starting from the command line.
The prescriptions can be rendered and subsequently printed from the "Prepare" menu by selecting the "Render" option. Note that the files must be saved before rendering. The rendered prescription is opened in a separate window. It can be saved as PDF or it can be opened in the system browser and printed from there.
The program uses jinja2 template for rendering the prescription. A default template is provided with the program. However, other templates (see default template for reference) can be created and placed in the template folder to be used for rendering the prescriptions. The drop down option in the toolbar can be used to switch between available templates.
Note that the templates are packaged with the .mpaz file which can be used for rendering. However, modifying/saving the file overwrites it.
This program supports markdown formatting. Markdown can be used to format the prescriptions and certificates. It can be turned on from the configuration dialog under the settings menu.
The Certify/Extra area can be used to write a medical prescription. Preset system is available for this as well. Certification requires different templates designed for it. A template named medcert is included with the program.
The program is primarily targeted towards individual practitioners. However, it can be easily adapted for multiple practitioners.
The data of the practitioner is stored in json files in the prescriber directory. The default file to be loaded is configured in the config file. A command line option can be used to specify which alternative prescriber file to load in the program, e.g. <program> --prescriber <prescriber file>.
The data of the currently selected prescriber can be edited using the "Prescriber" option under the "Prepare" menu.
If multiple prescribers have been configured (e.g. by copying the prescriber file and editing them individually), the prescribers can easily by switched by using the switch option in the settings menu and selecting the desired prescriber file.
The program uses a preset system to insert repeatedly used text without the need to type them. To use this feature the text must be entered beforehand to the respective files. These files are in the .csv format and can be edited with any spreadsheet editing software.
The preset files are kept in the preset directory. The files associated with clinical note, report, advice, investigation, medication and additional are note.csv, report.csv, advice.csv, investigation.csv, medication.csv and additional.csv. Each file contains a top row indicating the variables in the columns. The data is entered in two columns with each row containing a KEY and a TEXT. The TEXT can be entered in to the edit area by selecting the KEY from the preset input. Blank files with only the top row are included with the program.
A sample set of preset files can be downloaded from here. To use them, unzip the downloaded file and place the included files into the preset folder of MedScript by replacing/merging the csv files already present there. These are for example only. The users are expected to create their own preset files as per their requirements.
The default configuration file contains sane defaults and the program can be used without editing it. However, the json formatted configuration file can be edited to further tune the program to the users preference.
The default configuration is the config.json located in the config directory. However, a different config file may be provided by using the <program> --config <config file> command line argument.
It is recommended to use the default config file as base while creating another customized config file.
A graphical configuration editor is also included with the program. The options are as follows:
MedScript
Copyright © 2023 Dr. Agnibho Mondal
MedScript is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
MedScript is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with MedScript. If not, see <https://www.gnu.org/licenses/>.
Dr. Agnibho Mondal
mondal@agnibho.com
www.agnibho.com
Copyright © 2023 Dr. Agnibho Mondal
All rights reserved
MedScript is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Agnibho Mondal
mondal@agnibho.com
www.agnibho.com
Softwares of Agnibho
Copyright © 2013-2023 Dr. Agnibho Mondal
www.agnibho.com