Work-Break Timer Tray App

A simple system tray timer application built with Python and PySide6. The app runs in your system tray and helps you manage work/break cycles with configurable durations.

Features

• System tray integration
• Configurable work and break durations
• Visual indicators for work/break states
• Sound notifications
• Full cycle support (work -> short break -> work -> short break -> work -> long break)
• Configurable through JSON file

Installation

1. Create and activate a virtual environment:

python -m venv venv
source venv/bin/activate  # On Linux/Mac
# or
venv\Scripts\activate  # On Windows

2. Install dependencies:

pip install -r requirements.txt

Configuration

The app will create a config.json file on first run with default values:

• Work time: 25 minutes
• Short break: 5 minutes
• Long break: 15 minutes

You can modify these values by editing the config.json file.

Required Files

• bell.wav: Sound file for notifications
• inactive_icon.png: Icon for inactive state
• work_icon.png: Icon for work state
• break_icon.png: Icon for break state

Place these files in the same directory as the script.

Usage

Run the application:

python pomodoro.py

The app will appear in your system tray. Right-click the icon to:

• Start a full work/break cycle
• Start individual timers
• Stop current timer
• Exit the application