ChronosX

Minimal macOS menubar chronometer with lap history.

macOS Python License

Install

Via pip

pip install chronosx
chronosx

As macOS App (clickable icon)

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

Development Status
- 4 - Beta
Environment
- MacOS X
Intended Audience
- End Users/Desktop
Operating System
- MacOS :: MacOS X
Programming Language
Topic
- Utilities

Metadata

Development Status
- 4 - Beta
Environment
- MacOS X
Intended Audience
- End Users/Desktop
Operating System
- MacOS :: MacOS X
Programming Language
Topic
- Utilities

Release files for chronosx 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chronosx 1.0.1
File	Size	Uploaded
chronosx-1.0.1.tar.gz	118.9 kB	Jan 25, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for chronosx 1.0.1
File	Interpreter	ABI	Platform	Reset
chronosx-1.0.1-py3-none-any.whl 130.0 kB Jan 25, 2026	Python 3	none	any	Details

Total release size: 249.0 kB

Release files / chronosx-1.0.1.tar.gz

Download URL	chronosx-1.0.1.tar.gz
Size	118.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`72751121f9c97e650d4931327884e0133164ce3596a63fcad919caacc82fcf1d`
BLAKE2b-256 checksum How to use checksums	`678df965bc9a625062ad86dbf4a0615e7d55b95bfd1174a64f924a7613ea2da5`
Upload date	Jan 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.11`

Release files / chronosx-1.0.1-py3-none-any.whl

Download URL	chronosx-1.0.1-py3-none-any.whl
Size	130.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`26f59ac9e4c025c77727af48caca94dab237a4a03e656a150c861e393c72ed28`
BLAKE2b-256 checksum How to use checksums	`5850146ebf67335c57be0ac1247a9635adad2ce9b5e5330e29944ab2b182eec2`
Upload date	Jan 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.12.11`

Release history Release notifications | RSS feed

This release

1.0.1 This release

Jan 25, 2026 2 release files

1.0.0