Metadata-Version: 2.4
Name: gradienttk
Version: 0.1.2
Summary: Modern Gradient Widgets for CustomTkinter
Author: Mohammad Amin
License-Expression: MIT
Keywords: python,tkinter,customtkinter,gradient,gui,widgets
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: customtkinter>=5.2.0
Requires-Dist: Pillow>=10.0.0
Dynamic: license-file

# 🌈 GradientTk

<p align="center">
  <b>Modern Gradient Widgets for CustomTkinter</b>
</p>

<p align="center">
Create beautiful desktop applications with modern gradient widgets, smooth effects, and a familiar CustomTkinter API.
</p>

![GradientTk Screenshot](images/screenshot.JPG)

---

## ✨ About

GradientTk is an open-source Python library built on top of **CustomTkinter** that brings beautiful gradient-powered widgets to your desktop applications.

It is designed to feel familiar to CustomTkinter users while providing a modern appearance, lightweight implementation, and an easy-to-use API.

Whether you're building a simple utility or a complex desktop application, GradientTk helps you create beautiful interfaces with just a few lines of code.

---

## ✨ Features

- 🎨 Beautiful gradient widgets
- 🚀 Lightweight and fast
- 🖱️ Hover effects
- 👆 Press animation
- 📐 Automatic resize support
- 🧩 Familiar CustomTkinter-style API
- 🐍 Pure Python implementation
- ❤️ Open Source

---

## 📦 Installation

```bash
pip install gradienttk
```

---

## 🚀 Quick Start

```python
import customtkinter as ctk

from gradienttk import GradientButton


def hello():
    print("Hello GradientTk!")


app = ctk.CTk()

button = GradientButton(
    app,
    text="GradientTk",
    gradient=("#6C63FF", "#00C9FF"),
    command=hello,
)

button.pack(padx=20, pady=20)

app.mainloop()
```

---

## 📚 Available Widgets

| Widget | Status |
|---------|:------:|
| GradientButton | ✅ Available |

More widgets are planned for future releases.

---

## 💡 Why GradientTk?

GradientTk combines the simplicity of CustomTkinter with a modern gradient-based design.

✔ Easy to learn

✔ Easy to customize

✔ Beautiful user interfaces

✔ Lightweight

✔ Open Source

---

## 🗺️ Roadmap

### Version 0.2.0

- Better animations
- GradientLabel
- GradientEntry
- More customization options

### Version 0.3.0

- GradientProgressBar
- GradientSwitch
- Additional widgets
- Performance improvements

### Version 1.0.0

- Stable API
- Complete widget collection
- Full documentation
- More examples

---

## 🤝 Contributing

Contributions are always welcome!

If you find a bug, have an idea, or want to improve GradientTk, feel free to:

- Open an Issue
- Submit a Pull Request
- Share your suggestions

Every contribution helps make GradientTk better.

---

## 📄 License

GradientTk is licensed under the MIT License.

See the **LICENSE** file for more information.

---

<p align="center">
Made with ❤️ for the Python community.
</p>
