Mom's Canning Timer

Four stove-top timers in a 2x2 grid, built for preserving fruit and vegetables for the winter.

Key Features • Installation • Usage • Documentation • Support • Contributing • Credits • License

Key Features

• Four timers in a 2x2 grid, laid out like a stove top.
• A circular progress ring around each one.
• Set each timer's length in minutes, in the GUI.
• Start, pause, resume, and reset per burner, independently.
• A bell and a popup when a timer finishes.
• Cross-platform, with no third-party dependencies — pure standard-library tkinter.

Installation

pip install moms-canning-timer
canning-timer

Requires Python. See docs/installation.md for running from source or the Windows executable.

Usage

Set a length on each burner you need, press start, and the ring fills as it counts down. Each timer runs independently.

Documentation

Full documentation lives in docs/: Quickstart · Installation · Usage · Configuration · Architecture · Development · Testing · FAQ · Troubleshooting · Roadmap

Support

Open a GitHub Discussion or file an issue.

Contributing

Contributions welcome. See the org-wide Contributing Guide and Code of Conduct.

Credits

Built with Python and its standard-library tkinter. Published to the Python Package Index.

License

MIT — see LICENSE.md.

A kitchen timer, not a food-safety authority. Processing times come from your recipe or your canning guide, not from this program.