Metadata-Version: 2.4
Name: chronosx
Version: 1.0.1
Summary: Minimal macOS menubar chronometer with lap history
Author: albou
License-Expression: MIT
Project-URL: Homepage, https://github.com/lpalbou/chronosx
Project-URL: Repository, https://github.com/lpalbou/chronosx
Keywords: macos,menubar,chronometer,stopwatch,timer,productivity
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: MacOS X
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyobjc-framework-Cocoa>=9.0
Provides-Extra: dev
Requires-Dist: py2app>=0.28; extra == "dev"
Requires-Dist: Pillow>=9.0; extra == "dev"
Dynamic: license-file

# ChronosX

Minimal macOS menubar chronometer with lap history.

![macOS](https://img.shields.io/badge/platform-macOS-lightgrey) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-MIT-green)

## Install

### Via pip

```bash
pip install chronosx
chronosx
```

### As macOS App (clickable icon)

```bash
git clone https://github.com/lpalbou/chronosx.git
cd chronosx
./scripts/build_app.sh
cp -r dist/ChronosX.app /Applications/
open /Applications/ChronosX.app
```

## Usage

| Action | Result |
|--------|--------|
| **Click** | Start/stop timer |
| **Right-click** | Open laps popup |
| **Double-click title** | Edit lap title |
| **Clear** | Delete all laps |
| **Exit** | Quit app |

### Display

- `◉` — Idle
- `MM:SS.m` — Running (minutes:seconds.tenths)

## Data

Laps stored in `~/.chronosx_laps.json`

## Requirements

- macOS 10.14+
- Python 3.9+

## License

MIT
