# ๐ง Zenify Meditation CLI
[](https://badge.fury.io/py/zenify)
[](https://www.python.org/downloads/)
[](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`** โจ
Raw data
{
"_id": null,
"home_page": "https://github.com/kawarox/zenify",
"name": "zenify",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "meditation, mindfulness, terminal, ascii, wellness, health, breathing, zen, relaxation",
"author": "Zenify Team",
"author_email": "Zenify Team <zenify.meditation@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/01/e1/3708d05fa1dc986ef1321610de657d1d1fa6b85ebd167fe1744f995b9d8a/zenify-1.0.2.tar.gz",
"platform": null,
"description": "# \ud83e\uddd8 Zenify Meditation CLI\n\n[](https://badge.fury.io/py/zenify)\n[](https://www.python.org/downloads/)\n[](https://opensource.org/licenses/MIT)\n\nA beautiful terminal-based meditation app with ASCII art, multi-language support, and guided breathing exercises.\n\n## \u2728 Features\n\n- \ud83c\udfa8 **Beautiful ASCII Art**: 6 meditation shapes (Lotus, Mandala, Sun, Heart, Flower, Zen Circle)\n- \ud83c\udf0d **Multi-language Support**: Chinese (\u4e2d\u6587), English, Japanese (\u65e5\u672c\u8a9e)\n- \ud83e\udec1 **Breathing Techniques**: 4-7-8 breathing, Box breathing, Equal breathing, Custom patterns\n- \ud83d\udcca **Progress Tracking**: Session statistics, streaks, and detailed analytics\n- \ud83c\udfae **Two Modes**: Interactive graphical mode and simple progress bar mode\n- \u26a1 **Zero Dependencies**: Uses only Python standard library\n\n## \ud83d\ude80 Quick Install\n\n```bash\npip install zenify\n```\n\n## \ud83c\udfaf Quick Start\n\n```bash\n# Start interactive menu\nzen\n\n# Quick 5-minute lotus meditation\nzen -s lotus -d 5\n\n# Progress bar mode with 4-7-8 breathing\nzen -m progress -p 4-7-8 -d 10\n\n# Show your meditation statistics\nzen --stats\n```\n\n## \ud83d\udcd6 Usage Examples\n\n### Command Line Options\n\n```bash\n# Meditation modes\nzen -m guided # Visual shapes with breathing animation\nzen -m progress # Simple progress bar mode\n\n# Choose shapes (for guided mode)\nzen -s lotus # \ud83e\udeb7 Lotus flower\nzen -s mandala # \ud83d\udd2e Mandala pattern \nzen -s sun # \u2600\ufe0f Sun shape\nzen -s heart # \u2764\ufe0f Heart pattern\nzen -s flower # \ud83c\udf38 Flower design\nzen -s zen_circle # \u2b55 Zen circle\n\n# Breathing patterns\nzen -p 4-7-8 # 4-7-8 breathing (relaxation)\nzen -p box # Box breathing (focus)\nzen -p equal # Equal breathing\nzen -p custom # Custom timing\n\n# Duration and language\nzen -d 15 # 15 minute session\nzen --lang zh # \u4e2d\u6587\u754c\u9762\nzen --lang en # English interface \nzen --lang ja # \u65e5\u672c\u8a9e\u30a4\u30f3\u30bf\u30fc\u30d5\u30a7\u30fc\u30b9\n```\n\n### Combination Examples\n\n```bash\n# 10-minute lotus meditation with 4-7-8 breathing in English\nzen -s lotus -p 4-7-8 -d 10 --lang en\n\n# Quick 3-minute mandala session\nzen -s mandala -d 3\n\n# Progress mode for focus work\nzen -m progress -p box -d 25\n```\n\n## \ud83c\udfae Interactive Mode\n\nSimply run `zen` to enter the interactive menu where you can:\n\n- Select meditation mode and breathing pattern\n- Choose from beautiful ASCII art shapes \n- Set custom session duration\n- View detailed statistics and progress\n- Switch between languages\n\n## \ud83d\udcca Statistics & Tracking\n\nZenify automatically tracks your meditation sessions:\n\n```bash\nzen --stats # View your meditation statistics\n```\n\nTrack your:\n- Total meditation time\n- Session count and streaks\n- Favorite techniques and times\n- Progress over time\n- Completion rates\n\n## \ud83d\udee0 System Requirements\n\n- Python 3.6 or higher\n- Terminal/Command line interface\n- Works on Windows, macOS, and Linux\n\n## \ud83c\udf0d Multi-language Support\n\nZenify supports three languages with full interface translation:\n\n- **\u4e2d\u6587** - Complete Chinese interface\n- **English** - Full English interface \n- **\u65e5\u672c\u8a9e** - Complete Japanese interface\n\nLanguage preference is automatically saved for future sessions.\n\n## \ud83e\uddd8\u200d\u2640\ufe0f Breathing Techniques\n\n### 4-7-8 Breathing (Relaxation)\nPerfect for stress relief and falling asleep\n- Inhale for 4 seconds\n- Hold for 7 seconds \n- Exhale for 8 seconds\n\n### Box Breathing (Focus)\nUsed by military and athletes for concentration\n- Inhale for 4 seconds\n- Hold for 4 seconds\n- Exhale for 4 seconds\n- Hold for 4 seconds\n\n### Equal Breathing\nSimple and balanced breathing\n- Inhale for 4 seconds\n- Exhale for 4 seconds\n\n### Custom Breathing\nCreate your own breathing pattern with custom timing\n\n## \ud83c\udfa8 ASCII Art Shapes\n\nEach shape is mathematically designed with smooth animations:\n\n- **Lotus** \ud83e\udeb7 - Symbol of purity and enlightenment\n- **Mandala** \ud83d\udd2e - Sacred geometry for focus\n- **Sun** \u2600\ufe0f - Energy and vitality \n- **Heart** \u2764\ufe0f - Love and compassion\n- **Flower** \ud83c\udf38 - Growth and beauty\n- **Zen Circle** \u2b55 - Completeness and unity\n\n## \ud83d\ude80 Advanced Usage\n\n### Session Controls\n\nDuring meditation:\n- **[P]** - Pause/Resume\n- **[M]** - Return to menu\n- **[Q]** - Quit session\n\n### Command Line Flags\n\n```bash\nzen --help # Show all available options\nzen --version # Show version information\nzen --stats # Display meditation statistics\n```\n\n## \ud83d\udca1 Tips for Best Experience\n\n1. **Find a quiet space** - Minimize distractions\n2. **Use headphones** - Better focus with audio isolation\n3. **Consistent practice** - Try to meditate at the same time daily\n4. **Start small** - Begin with 3-5 minute sessions\n5. **Track progress** - Use `zen --stats` to see your improvement\n\n## \ud83e\udd1d Contributing\n\nZenify is open source! Contributions are welcome:\n\n- Report bugs and request features\n- Submit pull requests \n- Improve documentation\n- Add new languages or breathing techniques\n\n## \ud83d\udcdd License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83d\ude4f Acknowledgments\n\nBuilt with love for the meditation and mindfulness community. \n\n---\n\n**Start your mindfulness journey today with `pip install zenify`** \u2728\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "\ud83e\uddd8 A beautiful terminal meditation app with ASCII art, multi-language support, and breathing exercises",
"version": "1.0.2",
"project_urls": {
"Bug Reports": "https://github.com/kawarox/zenify/issues",
"Documentation": "https://github.com/kawarox/zenify/blob/main/README.md",
"Homepage": "https://github.com/kawarox/zenify",
"Source": "https://github.com/kawarox/zenify"
},
"split_keywords": [
"meditation",
" mindfulness",
" terminal",
" ascii",
" wellness",
" health",
" breathing",
" zen",
" relaxation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "f53946f5ffa2bb74b9469e50dc94cc907d9a9f638d4ed630a4e0ec48fdb4d8e8",
"md5": "ba57480f5e75e36adb374aa9f04da22f",
"sha256": "e1e1a552bc32f75d7f55069e2612df18da71233ecd3b769174a7caf55c713428"
},
"downloads": -1,
"filename": "zenify-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ba57480f5e75e36adb374aa9f04da22f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 37452,
"upload_time": "2025-08-25T05:22:19",
"upload_time_iso_8601": "2025-08-25T05:22:19.378770Z",
"url": "https://files.pythonhosted.org/packages/f5/39/46f5ffa2bb74b9469e50dc94cc907d9a9f638d4ed630a4e0ec48fdb4d8e8/zenify-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "01e13708d05fa1dc986ef1321610de657d1d1fa6b85ebd167fe1744f995b9d8a",
"md5": "43be30c04c99f974310c4155ec17dbd9",
"sha256": "159de23dfa8421e85a9bdc4df152e9eef25c388ba6d585d39fc0cac9cf1a9bb6"
},
"downloads": -1,
"filename": "zenify-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "43be30c04c99f974310c4155ec17dbd9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 3877081,
"upload_time": "2025-08-25T05:22:22",
"upload_time_iso_8601": "2025-08-25T05:22:22.453984Z",
"url": "https://files.pythonhosted.org/packages/01/e1/3708d05fa1dc986ef1321610de657d1d1fa6b85ebd167fe1744f995b9d8a/zenify-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-25 05:22:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kawarox",
"github_project": "zenify",
"github_not_found": true,
"lcname": "zenify"
}
JSON
