sepandhaghighi / nafas

🧘‍♂️ Breathing Gymnastics Application

---

Nafas

---

Table of contents

• Overview
• Installation
• Usage
• Issues & Bug Reports
• Dependencies
• Contribution
• References
• Authors
• License
• Show Your Support
• Changelog
• Code of Conduct

Overview

Breathing gymnastics is a system of breathing exercises that focuses on the treatment of various diseases and general health promotion. Nafas is a collection of breathing gymnastics designed to reduce the exhaustion of long working hours. With multiple breathing patterns, Nafas helps you find your way to a detoxified energetic workday and also improves your concentration by increasing the oxygen level. No need to walk away to take a break, just sit comfortably, run Nafas and let the journey begin. Nafas means breath in Persian.

Open Hub
PyPI Counter
Github Stars

Branch	master	dev
CI

Code Quality

Installation

Source Code

• Download Version 0.6 or Latest Source
• pip install -r requirements.txt or pip3 install -r requirements.txt (Need root access)
• python3 setup.py install or python setup.py install (Need root access)

PyPI

• Check Python Packaging User Guide
• pip install nafas==0.6 or pip3 install nafas==0.6 (Need root access)

Exe Version (Only Windows)

• Download Exe-Version 0.6
• Run NAFAS-0.6.exe

Usage

Screen Record

Issues & Bug Reports

Just fill an issue and describe it. We'll check it ASAP!

• Please complete the issue template

You can also join our discord server

Dependencies

master	dev

References

1- Prana Breath

2- Rickard, Kathleen Benjamin, Dorothy J. Dunn, and Virginia M. Brouch. "Breathing techniques associated with improved health outcomes." (2015).

3- Zaccaro, Andrea, Andrea Piarulli, Marco Laurino, Erika Garbella, Danilo Menicucci, Bruno Neri, and Angelo Gemignani. "How breath-control can change your life: a systematic review on psycho-physiological correlates of slow breathing." Frontiers in human neuroscience 12 (2018): 353.

4- Brook, Robert D., Lawrence J. Appel, Melvyn Rubenfire, Gbenga Ogedegbe, John D. Bisognano, William J. Elliott, Flavio D. Fuchs et al. "Beyond medications and diet: alternative approaches to lowering blood pressure: a scientific statement from the American Heart Association." Hypertension 61, no. 6 (2013): 1360-1383.

5- Russo, Marc A., Danielle M. Santarelli, and Dean O’Rourke. "The physiological effects of slow breathing in the healthy human." Breathe 13, no. 4 (2017): 298-309.

6- Bujatti, M., and P. Biederer. "Serotonin, noradrenaline, dopamine metabolites in transcendental meditation-technique." Journal of Neural Transmission 39, no. 3 (1976): 257-267.

7- Martarelli, Daniele, Mario Cocchioni, Stefania Scuri, and Pierluigi Pompei. "Diaphragmatic breathing reduces exercise-induced oxidative stress." Evidence-Based Complementary and Alternative Medicine 2011 (2011).

8- DrWeil, Integrative Medicine & Healthy Living

9- Human Givens Institute

10- This 2-Minute Breathing Exercise Can Help You Make Better Decisions

11- Using 5-5-5 Breathing to Calm Down

12- Free Text-To-Speech and Text-to-MP3 for US English

• Logo designed by Sara Amiri Fard

Show your support

Star this repo

Give a ⭐️ if this project helped you!

Donate to our project

Bitcoin

1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy

Ethereum

0xcD4Db18B6664A9662123D4307B074aE968535388

Litecoin

Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ

Doge

DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh

Tron

TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7

Ripple

rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq

Binance Coin

bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef

Tether

0xcD4Db18B6664A9662123D4307B074aE968535388

Dash

Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s

Stellar

GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL

Zilliqa

zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5

Coffeete

nafas's Issues

Python 3.10 Support

Description

Python 3.10 Support

Add new sound for preparing section

Description

Add new sound for preparing section

Operating System

Windows 10

Python Version

Python 3.5.2

Nafas Version (Use : nafas.__version__)

v0.3

Add logo and icon

Add details aboout chosen mode

When working with nafas user may be bored and confused about number of cycles that remain, It won't be bad if we add more details about number of cycles and etc when waiting for start.

5-5-5 Breathing Exercise

Description

5-5-5 Breathing Exercise
https://k12.thoughtfullearning.com/minilesson/using-5-5-5-breathing-calm-down

End of program bug

Description

Exiting at the end of each run

Steps/Code to Reproduce

pip install nafas==0.2
python -m nafas

Expected Behavior

Asking the user

Actual Behavior

Exit

Operating System

Windows 10

Python Version

Python 3.5.2

Nafas Version (Use : nafas.__version__)

0.2

Move CI/CD to Github action

Description

Migrate to Github action

Add github folder

1. CODE_OF_CONDUCT.md
2. CONTRIBUTING.md
3. ISSUE_TEMPLATE.md
4. PULL_REQUEST_TEMPLATE.md

Add Countdown Timer

Description

Add a countdown timer for each section

Based on https://www.reddit.com/r/Python/comments/nayob4/nafas_opensource_breathing_gymnastics_application/gy06a99?utm_source=share&utm_medium=web2x&context=3

Add custom program feature

Icon lack of clarity in black background

Description

Icon lack of clarity in black background

Operating System

Windows 10

Python Version

Python 3.5.2

Nafas Version (Use : nafas.__version__)

0.2

Sounds problem in pypi version

Description

No sound in pypi version

Steps/Code to Reproduce

pip install nafas==0.2
python -m nafas

Expected Behavior

Play sounds

Actual Behavior

Nothing

Operating System

Windows 10

Python Version

Python 3.5.2

Nafas Version (Use : nafas.__version__)

0.2

Add build exe script

Add sound effect

4-7-8 Breathing Exercise

Description

4-7-8 Breathing Exercise

https://www.drweil.com/health-wellness/body-mind-spirit/stress-anxiety/breathing-three-exercises/

Add Reference section

It seems reasonable if we add some references which show where these breathing periods and their sequences come from.

5-2-7 Breathing Exercise

Description

5-2-7 Breathing Exercise
https://www.inc.com/mithu-storoni/this-2-minute-breathing-exercise-can-help-you-make-better-decisions-according-to-a-new-study.html

Add time counter

When trying to work with this code it's a little bit confusing when should we start or stop, making a kind of sense of time will make it more easy to use.

One solution can be adding .s for each second, I mean something like:

Preparing . . .
1
2
3
######################################################################
Start
######################################################################
Cycle : 1
- Inhale for 3 sec
. . .
- Retain for 6 sec

Update Logo

Description

Update logo

7-11 Breathing Exercise

Description

7-11 Breathing Exercise

https://www.hgi.org.uk/resources/delve-our-extensive-library/resources-and-techniques/7-11-breathing-how-does-deep

Fill github about section

It would be better if we have a representative About section so that it could be searched easily.
This issue don't need any PR and will closed manually after adding this section.

Sound doesn't play, yet no error..

Description

For some reason the sound (wav's) doesn't play while nafas also doesn't report an error..

Steps/Code to Reproduce

pip3 install nafas

python3 -m nafas

Expected Behavior

Sound should play when I start a breathing program

Actual Behavior

The program starts and counters start, however no sound is played.
I double checked if my audio is on, but for some reason it just won't play

I even went and ran the command while being inside the install location (because it has the sounds subfolder), still nothing:
/usr/local/lib/python3.9/site-packages/nafas

Operating System

MacOS 11.3.1 on a MacBook Pro 13" Intel
Using the iTerm app

Python Version

Python 3.9.5

Nafas Version (Use : nafas.__version__)

0.4

Thank you for making this app! really appreciate the work!

console_scripts entry point

Description

Add console_scripts entry point to setup.py to run Nafas directly from the terminal.

nafas

instead of

python -m nafas

Add tests

Add tests