Skip to content

polienko/desktop-checklist-runner

Repository files navigation

Checklist Runner

Checklist Runner is a python desktop app for creating and running checklists with support for grouping, priorities, and notes.

Screenshot_1

Key Features

  • 🌐 HTML Export — generate reports with filtering and statistics
  • ✅ Three Checkbox States — Yes (✔️), No (❌), Skip (❔)
  • 🔔 Priorities — low (default), medium (❗), high (❗❗)
  • 📝 Notes — errors (red), warnings (orange), comments (gray)
  • 🏷️ Headers — structure long checklists with sections
  • 📁 Checklist Groups — organize checklists into folders
  • 📌 Always on Top — pin window above other applications
  • ⌨️ Hotkeys — efficient keyboard-only workflow

HTML-reports for checklist runs with statistics/filters

Screenshot_2

Export creates an interactive HTML report with:

  • Status statistics (Pass/Fail/Skip)
  • Progress bar with percentages
  • Filtering by status and notes (screenshot with filter on FAIL-items below):

Screenshot_3

Hotkeys

Key Action
Enter Add new item
Ctrl+Enter Edit selected item
Delete Delete selected items
Space Toggle status of selected items
↑ / ↓ Move selection
Shift+↑ / ↓ Select range
Ctrl+↑ / ↓ Move items
Alt+↑ Move to top
Alt+↓ Move to bottom
← / → Clear selection

TXT File Format

Checklists are saved as text files with the checklist_ prefix:

  • + Text — completed (Pass)
  • - Text — not completed (Fail)
  • ? Text — skipped (Skip)
  • ### Header ### — section header
  • * Text — error (red note)
  • ** Text — warning (orange note)
  • *** Text — comment (gray note)
  • + ❗ Text — medium priority
  • + ❗❗ Text — high priority

Usage (windows)

  • Download .exe from releases

    or

  • Make sure you have Python 3.7+ installed (Download Python)

  • Open checklistRunner.pyw

License

This project is licensed under the GNU General Public License v3.0.

See the LICENSE file for the full text.

About

✅ Checklists managing, running and reporting tool

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors