medtrackerer 1.0.0

Generate a printable med chart for temporary medication courses

medtrackerer

medtrackerer is an interactive CLI program to manage med tracking for short-term med courses (e.g., after surgeries). Medtrackerer uses a config file to track medication information and chart details and outputs an opinionated med tracking chart design to printable PDF.

"Opinionated" here means that I am the primary user of this program, and I am replicating a spreadsheet [REDACTED] has been maintaining manually for years and that works very well for me personally. The chart design is not customizeable at this time because this is a purely selfish project to let me never touch a spreadsheet for med tracking again.

You can see an example pdf here, based on a sample config file.

Installation

Medtrackerer can be installed as a python package. Instructions for uv are provided.

# install latest release
uv tool install medtrackerer

Usage

Quickstart

Run medtrackerer new to interactively create a config file in your current working directory.

Run medtrackerer generate path/to/config.toml to generate the med chart PDF.

Check out the --help menus for quick reference on the command line.

Creating a New Chart Config

Use medtrackerer new to interactively create a new med chart config. Medtrackerer will confirm your inputs before saving the file. The file name will be an escaped version of the name you specified, so don't worry about making the name filename-friendly.

The config file will be a list of all the medications or tasks you want to track on the chart. It serves as the configuration for the generated tracker chart and as a straightforward list for your reference!

Options:

# set the chart's name (and ask everything else)
medtrackerer new -n "My Cool Chart!"
# set the chart's start date to today
medtrackerer new -s 
# set the chart's start date to a specific date in year-month-day format
medtrackerer new -s 2025-06-17

Adding to an Existing Chart Config

Use medtrackerer add path/to/my_chart.toml to add medications or tasks to an existing chart. This uses the same interactive flow for medications as medtrackerer new.

NB: Medtrackerer supports additive edits only. If you need to edit or remove an existing item, please edit your config file in your favorite text editor.

Generating the Printable Chart

Use medtrackerer generate ./path/to/my_chart.toml to generate a printable PDF with all medication doses to be tracked. This will output to <CHART_FILENAME>.pdf in the same directory.

NB Pagination is not supported (yet). One printout is good for about fourteen days of meds.

Addendum

This was a project for me to learn Python.

No LLMs were or will be used in the making of this project.