ControlWork

English

Problem

Long uninterrupted computer sessions reduce productivity and health; users need reliable break reminders and active-time tracking.

Solution

ControlWork is a desktop work-time tracker with tray controls, idle-aware accounting, and break enforcement modes.

Tech Stack

• Python
• PySide6
• SQLite
• pytest

Architecture

src/controlwork/
tests/
pyproject.toml
scripts/

flowchart TD
  A[Desktop User] --> B[UI + Tray]
  B --> C[Activity tracker]
  C --> D[Break reminder engine]
  D --> E[SQLite + settings.json]

Loading

Features

• Active-time tracking (idle excluded)
• Soft/hard break reminders
• Tray-based control flow
• Local settings + DB persistence
• RU/EN UI support

How to Run

python3 -m venv .venv
source .venv/bin/activate
pip install -e .[dev]
python -m controlwork.main

Русский

Проблема

Долгая непрерывная работа за компьютером снижает продуктивность и вредит здоровью; нужен надежный учет времени и напоминания о перерывах.

Решение

ControlWork — desktop-приложение с треем, учетом только активного времени и мягкими/строгими режимами перерыва.

Стек

• Python
• PySide6
• SQLite
• pytest

Архитектура

src/controlwork/
tests/
pyproject.toml
scripts/

flowchart TD
  A[Пользователь] --> B[UI + трей]
  B --> C[Трекер активности]
  C --> D[Движок напоминаний]
  D --> E[SQLite + settings.json]

Loading

Возможности

• Учет только активного времени
• Мягкие и строгие напоминания о перерыве
• Управление через трей
• Локальное хранение настроек и данных
• Интерфейс RU/EN

Как запустить

python3 -m venv .venv
source .venv/bin/activate
pip install -e .[dev]
python -m controlwork.main