rainbow-clock 0.1.0

Amazing terminal analog clock with rainbow gradients and dynamic effects

🌈 Rainbow Analog Clock

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

✨ 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:

uvx rainbow-clock

Install with uv:

uv tool install rainbow-clock
rainbow-clock

Install with pip:

pip install rainbow-clock
rainbow-clock

Run from source:

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! ⏰✨