Metadata-Version: 2.4
Name: rainbow-clock
Version: 0.1.0
Summary: Amazing terminal analog clock with rainbow gradients and dynamic effects
Project-URL: Homepage, https://github.com/derluke/rainbow-clock
Project-URL: Repository, https://github.com/derluke/rainbow-clock
Project-URL: Issues, https://github.com/derluke/rainbow-clock/issues
Author: Lukas
License: MIT
License-File: LICENSE
Keywords: analog-clock,cli,clock,effects,rainbow,terminal
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# 🌈 Rainbow Analog Clock

An amazing terminal-based analog clock with dynamic visual effects, rainbow gradients, and smooth animations.

[![Python Version](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![PyPI](https://img.shields.io/badge/PyPI-coming%20soon-orange.svg)](https://pypi.org/project/rainbow-clock/)

## ✨ Features

✨ **Beautiful Analog Clock**
- Perfect circular design with aspect ratio compensation
- Rainbow gradient border with continuous color rotation
- Numbered hour markers (1-12) with special markers at 3, 6, 9, 12
- Three distinct hands: hour (red), minute (green), second (cyan)
- Glowing effects on hands and markers
- Pulsing current hour indicator

🎆 **7 Dynamic Visual Effects**
1. **Classic** - Clean clock without particle effects
2. **Fireworks** - Random colorful firework bursts
3. **Rain** - Continuous rainbow raindrops
4. **Stars** - Twinkling stars across the screen
5. **Matrix** - Matrix-style falling characters
6. **Sparkle** - Sparkles orbiting the clock face
7. **Snow** - Gentle falling snowflakes

🎮 **Interactive Controls**
- **SPACE** - Cycle through effects
- **R** - Toggle random mode (auto-switches every 10 seconds)
- **Ctrl+C** - Exit gracefully

⚡ **Performance**
- Smooth 20 FPS animation
- No flickering with proper double-buffering
- Efficient particle system with automatic cleanup

## Requirements

- Python 3.10+
- A terminal with true color (RGB) support
- Unix-like system (Linux, macOS)

## 🚀 Quick Start

### Run with uvx (recommended):
No installation needed! Run directly:
```bash
uvx rainbow-clock
```

### Install with uv:
```bash
uv tool install rainbow-clock
rainbow-clock
```

### Install with pip:
```bash
pip install rainbow-clock
rainbow-clock
```

### Run from source:
```bash
git clone https://github.com/derluke/rainbow-clock.git
cd rainbow-clock
python3 -m rainbow_clock
```

## 📦 Project Structure

- `rainbow_clock/` - Main package directory
  - `__init__.py` - Clock application with particle effects
- `analog_clock.py` - Basic clock version without effects
- `pyproject.toml` - Project configuration
- `README.md` - This file
- `LICENSE` - MIT License

## How It Works

The clock uses:
- **Bresenham's line algorithm** for smooth clock hands
- **Midpoint circle/ellipse algorithm** for the clock face
- **Custom particle system** with physics simulation
- **ANSI escape codes** for RGB colors and cursor positioning
- **Aspect ratio compensation** for perfect circles in terminal
- **Non-blocking input** for interactive controls

Enjoy your colorful time! ⏰✨
