Metadata-Version: 2.4
Name: hglass
Version: 0.1.0
Summary: A terminal-based pomodoro timer with animated ASCII hourglass
Author: Manish Pushkar
License-Expression: MIT
Project-URL: Homepage, https://github.com/mpushkar/hglass
Keywords: timer,pomodoro,hourglass,terminal,tui
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Topic :: Utilities
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=13.0
Dynamic: license-file

# hglass

A terminal-based pomodoro timer with an animated ASCII hourglass.

## Install

```bash
pip install hglass
```

## Usage

```bash
hglass 25      # 25-minute pomodoro
hglass 5       # 5-minute break
hglass 0.1     # 6-second test run
```

Press `Ctrl+C` to cancel the timer early.

## Features

- Large animated hourglass with falling sand
- Smooth grain-drop neck animation at 8 fps
- Big-digit countdown timer (MM:SS)
- Warm amber/blue color scheme optimized for dark terminals
- Bell notification and flashing "TIME'S UP!" on completion
- Automatic fallback for small terminal windows

## Requirements

- Python 3.9+
- [Rich](https://github.com/Textualize/rich)

## License

MIT
