Metadata-Version: 2.1
Name: celestialtk
Version: 0.1.0
Summary: A Tkinter animation library for celestial-like floating points
Home-page: https://github.com/ricardious
Download-URL: https://github.com/ricardious/celestialtk.git
Author: Alex Ricardo Castañeda Rodríguez
Author-email: castaneda.systems@gmail.com
Keywords: tkinter animation visualization
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# CelestialTK

A Tkinter animation library for creating celestial-like floating points with customizable behavior.

## Installation

```bash
pip install celestialtk
```

## Quick Start

```python
import tkinter as tk
from celestialtk import FloatingPointsAnimator

# Create a tkinter window
root = tk.Tk()
canvas = tk.Canvas(root, width=400, height=300, bg='black')
canvas.pack()

# Create floating points animator
animator = FloatingPointsAnimator(
    canvas, 
    num_points=50, 
    base_color='#00ffff',  # Cyan points
    fall_direction='down',
    blink_enabled=True
)

root.mainloop()
```

## Features

- Customizable number of points
- Adjustable point sizes
- Multiple falling directions
- Optional blinking effect
- Color and opacity control

## Parameters

- `num_points`: Total number of points (default: 50)
- `sizes`: List of possible circle radii (default: [2, 5])
- `speed_range`: Tuple of (min_speed, max_speed) (default: (1, 5))
- `blink_enabled`: Whether points blink (default: True)
- `fall_direction`: Direction of points ("down", "up", "left", "right", or "random")
- `base_color`: Hex color of points
- `bg_color`: Background color
- `opacity`: Opacity of points (0-1)
- `update_interval`: Animation update interval in ms

## License

MIT License
