Timeblocks Desktop App

A Python desktop meeting timer and agenda runner designed to help users manage meetings, tasks, and timed workflows more effectively.

Overview

Timeblocks is a desktop productivity application built in Python. It supports timer-based task management, CSV workflows, reusable templates, and automated testing to improve reliability and usability.

Features

• Timer and agenda control
• CSV import and export
• Reusable templates
• Documentation and screenshots
• Automated testing with pytest
• Modular Python project structure

Tech Stack

• Python
• Pytest
• CSV handling
• Git
• GitHub

What I Practised

• Building a Python desktop application
• Organising a multi-file Python project
• Writing and running automated tests
• Debugging and improving reliability
• Presenting a project cleanly on GitHub

Project Files

• main.py - application entry point
• timer.py - timer logic
• controls.py - control behaviour
• csv_handler.py - CSV import/export support
• enhancement.py - extra functionality
• test_*.py - automated test files
• doc/ - screenshots and documentation

How to Run

1. Make sure Python is installed
2. Open the project folder in your preferred editor or terminal
3. Run the application from main.py
4. Run tests with pytest if required

Notes

This project is shared for portfolio and learning purposes.