Mom's Canning Timer

Customizable stove top timers, created for preserving fruits and veggies for the winter.

Key Features • Download • How To Use • Support • Contributing • Changelog • Credits & Contributors

Key Features

• Four canning timers laid out in a 2x2 grid, like a stove top.
• Circular progress ring around each timer.
• Set each timer's length (in minutes) right in the GUI.
• Start, Pause/Resume, and Reset controls per burner.
• Bell + popup alert when a timer finishes.
• Cross platform, no third-party dependencies (pure standard-library tkinter).

Download

You can download the source code to run the scripts from the command line on Windows, macOS and Linux. This will require Python.

You can download the latest executable version of Mom's Canning Timer for Windows. This does not require Python.

How To Use

To run the application, you can use Git and the Python Interpreter, which allows you to clone and run the application, or pip to create a command line application.

Git

To clone and run this application, you'll need Git and Python installed on your computer. If you would rather not use Git, you can just download the script from GitHub above. From your command line:

# Clone this repository
$ git clone https://github.com/willtheorangeguy/Moms-Canning-Timer

# Go into the repository
$ cd Moms-Canning-Timer

# Run straight from the folder (no install needed)
$ python main.py

# ...or install the package and use the command / module
$ pip install -e .
$ canning-timer
$ python -m moms_canning_timer

pip

You can install the program from the Python Package Index through pip.

# Install via pip
$ pip install moms-canning-timer

# Run the CLI
$ canning-timer

Support

Customization for Mom's Canning Timer can be found in the CUSTOMIZATION doc. More documentation is available in the Documentation and on the Wiki. If more support is required, please open a GitHub Discussion or join our Discord.

Contributing

Please contribute using GitHub Flow. Create a branch, add commits, and open a pull request.

Please read CONTRIBUTING for details on our CODE OF CONDUCT, and the process for submitting pull requests to us.

Changelog

See the CHANGELOG file for details.

Credits

This software uses the following open source packages, projects, services or websites:

GitHub	Python Software Foundation	PyInstaller	Open Iconic
Web - Plans	Web - Donate	Web - Donate	Web

Contributors

• @willtheorangeguy - Sponsor on PayPal

You may also like...

• ProgramVer - An open-source, Python GUI version window to show copyright info and licenses.
• PyWorkout - A minimal CLI to keep you inspired during your workout!
• PyAvatar - Easily display all of your creative avatars to keep them consistent across websites.

License

This project is licensed under the MIT License - see the LICENSE file for details.