Skip to content

README.md

Latest commit

 

History

History
78 lines (76 loc) · 2.24 KB

README.md

File metadata and controls

78 lines (76 loc) · 2.24 KB

ControlWork

CI

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