Metadata-Version: 2.4
Name: zenify
Version: 1.0.2
Summary: 🧘 A beautiful terminal meditation app with ASCII art, multi-language support, and breathing exercises
Home-page: https://github.com/kawarox/zenify
Author: Zenify Team
Author-email: Zenify Team <zenify.meditation@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/kawarox/zenify
Project-URL: Bug Reports, https://github.com/kawarox/zenify/issues
Project-URL: Source, https://github.com/kawarox/zenify
Project-URL: Documentation, https://github.com/kawarox/zenify/blob/main/README.md
Keywords: meditation,mindfulness,terminal,ascii,wellness,health,breathing,zen,relaxation
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Other/Nonlisted Topic
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Natural Language :: English
Classifier: Natural Language :: Japanese
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# 🧘 Zenify Meditation CLI

[![PyPI version](https://badge.fury.io/py/zenify.svg)](https://badge.fury.io/py/zenify)
[![Python 3.6+](https://img.shields.io/badge/python-3.6+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A beautiful terminal-based meditation app with ASCII art, multi-language support, and guided breathing exercises.

## ✨ Features

- 🎨 **Beautiful ASCII Art**: 6 meditation shapes (Lotus, Mandala, Sun, Heart, Flower, Zen Circle)
- 🌍 **Multi-language Support**: Chinese (中文), English, Japanese (日本語)
- 🫁 **Breathing Techniques**: 4-7-8 breathing, Box breathing, Equal breathing, Custom patterns
- 📊 **Progress Tracking**: Session statistics, streaks, and detailed analytics
- 🎮 **Two Modes**: Interactive graphical mode and simple progress bar mode
- ⚡ **Zero Dependencies**: Uses only Python standard library

## 🚀 Quick Install

```bash
pip install zenify
```

## 🎯 Quick Start

```bash
# Start interactive menu
zen

# Quick 5-minute lotus meditation
zen -s lotus -d 5

# Progress bar mode with 4-7-8 breathing
zen -m progress -p 4-7-8 -d 10

# Show your meditation statistics
zen --stats
```

## 📖 Usage Examples

### Command Line Options

```bash
# Meditation modes
zen -m guided         # Visual shapes with breathing animation
zen -m progress       # Simple progress bar mode

# Choose shapes (for guided mode)
zen -s lotus          # 🪷 Lotus flower
zen -s mandala        # 🔮 Mandala pattern  
zen -s sun            # ☀️ Sun shape
zen -s heart          # ❤️ Heart pattern
zen -s flower         # 🌸 Flower design
zen -s zen_circle     # ⭕ Zen circle

# Breathing patterns
zen -p 4-7-8          # 4-7-8 breathing (relaxation)
zen -p box            # Box breathing (focus)
zen -p equal          # Equal breathing
zen -p custom         # Custom timing

# Duration and language
zen -d 15             # 15 minute session
zen --lang zh         # 中文界面
zen --lang en         # English interface  
zen --lang ja         # 日本語インターフェース
```

### Combination Examples

```bash
# 10-minute lotus meditation with 4-7-8 breathing in English
zen -s lotus -p 4-7-8 -d 10 --lang en

# Quick 3-minute mandala session
zen -s mandala -d 3

# Progress mode for focus work
zen -m progress -p box -d 25
```

## 🎮 Interactive Mode

Simply run `zen` to enter the interactive menu where you can:

- Select meditation mode and breathing pattern
- Choose from beautiful ASCII art shapes  
- Set custom session duration
- View detailed statistics and progress
- Switch between languages

## 📊 Statistics & Tracking

Zenify automatically tracks your meditation sessions:

```bash
zen --stats    # View your meditation statistics
```

Track your:
- Total meditation time
- Session count and streaks
- Favorite techniques and times
- Progress over time
- Completion rates

## 🛠 System Requirements

- Python 3.6 or higher
- Terminal/Command line interface
- Works on Windows, macOS, and Linux

## 🌍 Multi-language Support

Zenify supports three languages with full interface translation:

- **中文** - Complete Chinese interface
- **English** - Full English interface  
- **日本語** - Complete Japanese interface

Language preference is automatically saved for future sessions.

## 🧘‍♀️ Breathing Techniques

### 4-7-8 Breathing (Relaxation)
Perfect for stress relief and falling asleep
- Inhale for 4 seconds
- Hold for 7 seconds  
- Exhale for 8 seconds

### Box Breathing (Focus)
Used by military and athletes for concentration
- Inhale for 4 seconds
- Hold for 4 seconds
- Exhale for 4 seconds
- Hold for 4 seconds

### Equal Breathing
Simple and balanced breathing
- Inhale for 4 seconds
- Exhale for 4 seconds

### Custom Breathing
Create your own breathing pattern with custom timing

## 🎨 ASCII Art Shapes

Each shape is mathematically designed with smooth animations:

- **Lotus** 🪷 - Symbol of purity and enlightenment
- **Mandala** 🔮 - Sacred geometry for focus
- **Sun** ☀️ - Energy and vitality  
- **Heart** ❤️ - Love and compassion
- **Flower** 🌸 - Growth and beauty
- **Zen Circle** ⭕ - Completeness and unity

## 🚀 Advanced Usage

### Session Controls

During meditation:
- **[P]** - Pause/Resume
- **[M]** - Return to menu
- **[Q]** - Quit session

### Command Line Flags

```bash
zen --help           # Show all available options
zen --version        # Show version information
zen --stats          # Display meditation statistics
```

## 💡 Tips for Best Experience

1. **Find a quiet space** - Minimize distractions
2. **Use headphones** - Better focus with audio isolation
3. **Consistent practice** - Try to meditate at the same time daily
4. **Start small** - Begin with 3-5 minute sessions
5. **Track progress** - Use `zen --stats` to see your improvement

## 🤝 Contributing

Zenify is open source! Contributions are welcome:

- Report bugs and request features
- Submit pull requests  
- Improve documentation
- Add new languages or breathing techniques

## 📝 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

Built with love for the meditation and mindfulness community. 

---

**Start your mindfulness journey today with `pip install zenify`** ✨
