Python library for drawing simple monthly calendar images with events.
Install from PyPI:
$ pip install -U drawcal
Generate a calendar image for a given events file:
$ drawcal --events events.json --month 3 --year 2025
Python:
>>> from drawcal import draw_calendar >>> draw_calendar(month, year, events=events, outfile=outfile)
drawcal uses a structured event object format:
[
{
"start_date": "3/1/2025",
"end_date": "3/3/2025",
"color": "#ee2233",
"style": "rounded",
"markers": ["3/3/2025"]
},
{
"start_date": "3/14/2025",
"end_date": "3/15/2025",
"style": "filled",
"markers": ["3/14/2025", "3/15/2025"]
}
]Supported style values are filled, rounded, and diagonal. Use
markers to draw green marker indicators on specific dates within the event
range, or use marker-only events when you only want calendar annotations.
Legacy list-based events are still supported for backward compatibility and are documented in docs/events.md.
Additional docs: