A simple schedule plotter

The csv/xlsx file needs to have columns "begin", "end", "days", and whatever text you want in the schedule boxes:

	begin	end	days	Label1	Label2	Label3
0	08:00 AM	08:50 AM	MW	One	Two	Three
1	10:00 AM	11:50 AM	TRF	Yes	No	Maybe
2	03:00 PM	03:50 PM	MWF	Foo	Bar	Baz

For this CSV you could use this command line:

plotschedule --output bar.png --title "My Schedule" example/foo.csv --labels Label1 Label2 Label3

And you'd get this output:

Result

You can also add a color column and use matplotlib colors.

You can add a hatch column to shade individual blocks with a matplotlib hatch pattern ('///', 'xx', '..', and so on). Hatching is drawn on top of the block's fill, so it marks a block without spending the colour channel — useful when colour already means something else. Leave the cell blank for no hatch.

Changes: 0.11 now works with excel too!

Changes: 0.12 allow for times that are already converted into 'float' hours (e.g. 8:30 AM -> 8.5, etc.)

Changes: 0.14 (yeah, skip 0.13!) reorganize init.py to put the function an module scope.

Changes: 0.15 Added --sheet argument to pull a particular sheet from an excel file.

Labels are drawn in the centre of their block, so a dense hatch can end up striping the text. Pass label_bbox=True to plotSchedule to put a translucent white background behind each block's label, which keeps it readable:

plotSchedule(scheds, label_bbox=True)

The option is off by default. For full control, pass a dict instead of True and it is handed straight to matplotlib's text bbox:

plotSchedule(scheds, label_bbox={'facecolor': 'yellow', 'alpha': 0.5})

This applies to the per-block labels only, never the plot title.

From the command line, use --label-bbox to turn it on and --label-fontsize to set the text size. Unlike color and hatch, which are spreadsheet columns, these two are per-plot settings and so need flags:

plotschedule --output bar.png example/foo.csv --labels Label1 Label2 --label-bbox --label-fontsize 9

Changes: 0.17 Added per-block hatch support. Packaging moved to pyproject.toml/uv and the first tests were added.

Changes: 0.18 Added the opt-in label_bbox option for a background behind block labels, plus --label-bbox and --label-fontsize on the command line.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

plotschedule-0.18.tar.gz (4.5 kB view details)

Uploaded Jul 28, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

plotschedule-0.18-py3-none-any.whl (5.4 kB view details)

Uploaded Jul 28, 2026 Python 3

File details

Details for the file plotschedule-0.18.tar.gz.

File metadata

Download URL: plotschedule-0.18.tar.gz
Upload date: Jul 28, 2026
Size: 4.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for plotschedule-0.18.tar.gz
Algorithm	Hash digest
SHA256	`77a6708ec352cafe049321129ae75c758311f8d3b928edd5265c6ef7ce2b407a`
MD5	`4593ffe59350d3d8aa58f151667900af`
BLAKE2b-256	`0a8eaa0bc1891d085f38b589355b82c055df18bc0d74a818ab8d1f51fc7ba749`

See more details on using hashes here.

Provenance

The following attestation bundles were made for plotschedule-0.18.tar.gz:

Publisher: release.yml on sspickle/plotschedule

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: plotschedule-0.18.tar.gz
- Subject digest: 77a6708ec352cafe049321129ae75c758311f8d3b928edd5265c6ef7ce2b407a
- Sigstore transparency entry: 2271302511
- Sigstore integration time: Jul 28, 2026
Source repository:
- Permalink: sspickle/plotschedule@625f3af3a379078029f2e165c70ef8cb840dde22
- Branch / Tag: refs/tags/v0.18
- Owner: https://github.com/sspickle
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@625f3af3a379078029f2e165c70ef8cb840dde22
- Trigger Event: push