TempoFlow is a sequential, clock-based lesson timer designed for structured teaching sessions such as classroom lessons, workshops, and presentations.
The application allows teachers to define lesson sections, run them sequentially with timers, receive notifications, and track total lesson duration.
- Sequential section timers (deterministic order)
- Global lesson timer (1 hour 30 minutes)
- Manual section start with confirmation
- Editable sections (title + duration)
- Visual completion indicators (✔ completed sections)
- Audio alerts
- Fullscreen mode
- Works offline
- Cross-platform (Web, Windows, Linux)
TempoFlow follows a strict sequential execution model:
- Sections are defined before starting
- Each section runs independently
- When a section finishes:
- The user is asked to confirm the next section
- Completed sections remain marked
- The global lesson timer runs continuously
TempoFlow/
│
├── web/
│ └── index.html # Main web application (HTML/CSS/JS)
│
├── desktop/
│ └── app.py # Python desktop wrapper (PyWebView)
│
├── README.md
└── requirements.txt- Open the
web/folder - Double-click
index.html - The app runs instantly in your browser
✔ No server
✔ No dependencies
✔ Works on Windows & Linux
The desktop version reuses the exact same web UI and logic.
- Python: Application launcher
- PyWebView: Native window rendering
- HTML/CSS/JS: Core application logic
This ensures:
- Zero duplication of logic
- Same behavior as web version
- Native desktop experience
pip install -r requirements.txt- Run the app
python desktop/app.py- 📦 Build Windows Executable (Optional) Using PyInstaller:
pip install pyinstaller
pyinstaller --noconsole --onefile \
--add-data "web/index.html:web" \
desktop/app.py