Metadata-Version: 2.4
Name: jingle-shells
Version: 0.1.2
Summary: A singing Christmas Tree in your terminal 🎄
Author-email: EurusDevSec <zeno11275@gmail.com>
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pygame>=2.6.1
Dynamic: license-file

# Jingle Shells 🎄

[![PyPI version](https://badge.fury.io/py/jingle-shells.svg)](https://badge.fury.io/py/jingle-shells)
[![Python](https://img.shields.io/pypi/pyversions/jingle-shells.svg)](https://pypi.org/project/jingle-shells/)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

**A singing Christmas Tree in your terminal.** Built with Python & Pygame. Perfect for bringing holiday spirit to your dev environment.

![Demo](https://github-production-user-asset-6210df.s3.amazonaws.com/129585402/518720585-ea062e80-e04e-433b-a638-6db7149bd88c.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAVCODYLSA53PQK4ZA%2F20251125%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251125T152711Z&X-Amz-Expires=300&X-Amz-Signature=b8ad0591130d7ff521b4f15c7885170c68a79a185a5d2dcc41b15ab43827862f&X-Amz-SignedHeaders=host)

## ✨ Features

- 🎄 **Animated Tree:** Sparkling decorations and dynamic lighting.
- ❄️ **Snow Engine:** Realistic falling snow effect using queue logic.
- 🎵 **Music:** Plays background Christmas songs (Jingle Bells).
- 📜 **Scrolling Lyrics:** Karaoke-style lyrics display.
- 🚀 **Lightweight:** Runs smoothly on any terminal.

## 📦 Installation

Install via pip (PyPI):

```bash
pip install jingle-shells
```

## 🚀 Usage

Run the following command in your terminal:

```bash
jingle-shells
```

_To stop the application, press `Ctrl + C`._

## 🛠 Requirements

- Python 3.12+
- Terminal/Console with ANSI color support (Windows CMD, PowerShell, Bash, Zsh).

## 👨‍💻 Author

**EurusDevSec**

- GitHub: [@EurusDevSec](https://www.google.com/search?q=https://github.com/EurusDevSec)

---

_Merry Christmas & Happy Coding\!_ 🎁
