https://github.com/lpalbou/chronosx

Just a basic chronometer with one-click access in the OSX navbar
https://github.com/lpalbou/chronosx

app apple chronometer chronometer-app navbar osx

Last synced: 5 months ago
JSON representation

Just a basic chronometer with one-click access in the OSX navbar

• Host: GitHub
• URL: https://github.com/lpalbou/chronosx
• Owner: lpalbou
• License: mit
• Created: 2026-01-25T09:20:09.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2026-01-25T09:22:05.000Z (5 months ago)
• Last Synced: 2026-01-26T00:21:09.210Z (5 months ago)
• Topics: app, apple, chronometer, chronometer-app, navbar, osx
• Language: Python
• Homepage:
• Size: 69.3 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 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