PomodoroTimerByAnton

Русский
PomodoroTimerByAnton v1.0.0
Первая стабильная версия профессионального таймера Pomodoro на Python и PySide6.

🆕 Что нового
Полностью переписанный интерфейс на PySide6 Qt Widgets (вместо Tkinter).

Единый таймер с ручным учётом переработки и двух видов отдыха сверх нормы.

11 языков интерфейса (русский, английский, испанский, немецкий, французский, португальский, китайский, хинди, арабский, японский, корейский) с мгновенным переключением.

Три встроенные темы (Comet, Aurora, Warm) + возможность создать пользовательскую тему с редактором палитры и предпросмотром.

Семь видов плавающего виджета: Минималистичный, Компактный, Расширенный, Микро, Строка, Кольцо, Табло.

Настраиваемая индикация превышения: пульсация, масштаб, маячки, рамка, волна.

Системный трей, автозапуск, единый экземпляр приложения (Windows mutex).

Полная статистика за сегодня и всё время (работа, отдых, переработка, сверхнормативный отдых).

Адаптивный интерфейс под узкие экраны и высокий DPI.

📥 Установка и запуск
Скачайте архив PomodoroTimerByAnton.GitHub.windows10.git64.rar.

Распакуйте в любую папку.

Запустите PomodoroTimerByAnton.exe.

При первом запуске данные (настройки, статистика, профили) создаются рядом с exe; если прав недостаточно — в %USERPROFILE%.pomodoro_timer_by_anton.

Требования: Windows 10 / 11 (x64).
Для работы не требуется установка Python или дополнительных библиотек — всё уже упаковано.

📚 Документация
Подробная документация находится в папке docs/ внутри архива:

PROJECT_MAP.md — структура проекта.

TIMER_STATE_MACHINE.md — логика работы таймера.

THEMING.md — оформление и темы.

WIDGETS.md — все виды плавающего виджета.

UI_ARCHITECTURE.md и UI_FEATURE_PARITY.md — архитектура Qt и соответствие функциям.

LOCALIZATION.md — локализация.

STARTUP.md — запуск и единственный экземпляр.

🛠 Для разработчиков
Исходный код открыт, сборка описана в README.md. Для сборки из исходников потребуется Python 3.10–3.14 и зависимости из requirements-dev.txt.

🙏 Благодарности
Приложение использует:

PySide6 (Qt for Python) — LGPL.

Иконки из стандартной библиотеки Qt и собственные SVG/PNG.

Переводы Qt для встроенных диалогов.

Спасибо за использование!
Если вам понравился проект, поставьте звезду на GitHub.

English
PomodoroTimerByAnton v1.0.0
First stable release of a professional Pomodoro timer for Windows, built with Python and PySide6.

🆕 What's New
Completely rewritten UI using PySide6 Qt Widgets (replaces Tkinter).

Single timer with manual tracking of overtime and two types of extra rest.

11 interface languages (English, Russian, Spanish, German, French, Portuguese, Chinese, Hindi, Arabic, Japanese, Korean) with instant switching.

Three built‑in themes (Comet, Aurora, Warm) plus a fully customizable User theme with palette editor and live preview.

Seven floating widget layouts: Minimal, Compact, Expanded, Micro, Row, Ring, Scoreboard.

Customizable overrun indicators: pulse, scale, beacons, border, wave.

System tray, auto‑start, single instance (Windows mutex).

Complete statistics for today and all time (work, rest, overtime, extra rest).

Responsive layout for narrow screens and high DPI.

📥 Installation & Launch
Download the archive PomodoroTimerByAnton.GitHub.windows10.git64.rar.

Extract to any folder.

Run PomodoroTimerByAnton.exe.

On first start, settings, statistics, and profiles are created next to the exe; if permissions are insufficient, they are stored in %USERPROFILE%.pomodoro_timer_by_anton.

Requirements: Windows 10 / 11 (x64).
No Python or extra libraries needed — everything is bundled.

📚 Documentation
Full documentation is inside the archive in the docs/ folder:

PROJECT_MAP.md — project structure.

TIMER_STATE_MACHINE.md — timer logic.

THEMING.md — theming and styling.

WIDGETS.md — all floating widget types.

UI_ARCHITECTURE.md and UI_FEATURE_PARITY.md — Qt architecture and feature parity.

LOCALIZATION.md — localization details.

STARTUP.md — startup and single instance.

🛠 For Developers
Source code is open; build instructions are in README.md. To build from source, you need Python 3.10–3.14 and dependencies from requirements-dev.txt.

🙏 Credits
This app uses:

PySide6 (Qt for Python) — LGPL.

Icons from Qt's standard library and custom SVG/PNG assets.

Qt translations for built‑in dialogs.

Thank you for using PomodoroTimerByAnton!
If you like it, please star the repository on GitHub.