Watch

Easy python aplication to measure consumed time on several tasks.

Python 55.2%
Shell 28.4%
Batchfile 16.4%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
Lukáš Ferkl 7efa093110 Issue #5 - Add Linux shell scripts for cross-platform support (#6 ) This PR adds complete Linux shell script equivalents for all Windows batch files: - prepare_venv.sh: Creates virtual environment and installs dependencies - run_timecounter.sh: Runs the TimeCounter application - build_exe.sh: Builds directory-based executable - build_exe_onefile.sh: Builds single-file executable Also updated README.md with usage instructions for Linux users. The scripts include proper error handling, path resolution, and validation for python3-tk package on Linux systems. This PR resolves #5 Reviewed-on: #6		2026-10-22 19:22:05 +00:00
.gitignore	Initial commit	2026-10-20 11:22:06 +00:00
build_exe.bat	#1 - Initial release for testing (#2 )	2026-10-20 11:45:48 +00:00
build_exe.sh	Issue #5 - Add Linux shell scripts for cross-platform support (#6 )	2026-10-22 19:22:05 +00:00
build_exe_onefile.bat	#1 - Initial release for testing (#2 )	2026-10-20 11:45:48 +00:00
build_exe_onefile.sh	Issue #5 - Add Linux shell scripts for cross-platform support (#6 )	2026-10-22 19:22:05 +00:00
LICENSE	Initial commit	2026-10-20 11:22:06 +00:00
prepare_venv.bat	#1 - Initial release for testing (#2 )	2026-10-20 11:45:48 +00:00
prepare_venv.sh	Issue #5 - Add Linux shell scripts for cross-platform support (#6 )	2026-10-22 19:22:05 +00:00
README.md	Issue #5 - Add Linux shell scripts for cross-platform support (#6 )	2026-10-22 19:22:05 +00:00
requirements.txt	#1 - Initial release for testing (#2 )	2026-10-20 11:45:48 +00:00
run_timecounter.bat	#1 - Initial release for testing (#2 )	2026-10-20 11:45:48 +00:00
run_timecounter.sh	Issue #5 - Add Linux shell scripts for cross-platform support (#6 )	2026-10-22 19:22:05 +00:00
time_counter.py	#1 - Initial release for testing (#2 )	2026-10-20 11:45:48 +00:00

README.md

TimeCounter

Easy Python application to measure consumed time on several tasks.

Description

TimeCounter is a simple yet effective time tracking application that allows users to monitor time spent on different tasks. The application features a graphical user interface built with customtkinter, making it easy to use and intuitive.

Features

Track time for multiple tasks simultaneously
Start/stop timer functionality
Reset individual task timers
Automatic saving of progress
Visual indication of active task
Percentage distribution of time among tasks
Cross-platform compatibility (Windows)

Installation

Prerequisites

Python 3.8 or higher
pip package manager

Setup Steps

Clone the repository:

git clone <repository-url>
cd TimeCounter

Create and activate virtual environment:

# On Windows
prepare_venv.bat

# On Linux/macOS
./prepare_venv.sh

Install dependencies:
```
pip install -r requirements.txt
```

Usage

Running the Application

From source:

# On Windows
run_timecounter.bat

# On Linux/macOS
./run_timecounter.sh

From compiled executable:
- Run build_exe.bat or ./build_exe.sh (Linux/macOS) to create a directory-based executable
- Run build_exe_onefile.bat (Windows) or ./build_exe_onefile.sh (Linux/macOS) to create a single-file executable

How to Use

The application displays multiple task categories with their respective time counters
Click "Start" to begin timing the active task
Use buttons to switch between different tasks
Click "Nulovat" (Reset) to reset individual task timers
The application automatically saves progress every 10 seconds

Project Structure

TimeCounter/
├── time_counter.py     # Main application code
├── README.md          # This file
├── requirements.txt   # Dependencies
├── build_exe.bat      # Build directory-based executable
├── build_exe_onefile.bat # Build single-file executable
├── prepare_venv.bat   # Setup virtual environment
├── run_timecounter.bat # Run the application
└── tasks.json         # Data file for saved tasks (auto-generated)

Dependencies

customtkinter - Modern GUI library for Python
pyinstaller - Tool to create standalone executables

License

This project is licensed under the terms of the LICENSE file.

Author

Created by Lukáš Ferkl

Contributing

Contributions are welcome! Please feel free join.