# vipassana-timer
Meditation timer for vipassana (insight meditation) with different postures.
For context - this package was originally created to work with Yuttadhammo Bhikkhu's online meditation style, which includes (optional) prostration at the beginning of the meditation, then walking meditation and then sitting. If you just want to do 'normal' sitting practice, you can still use this package, just type 's' followed by the minutes you want to do. Also, you can add your own 'postures' if you want multiple bells in the sitting session - see below.
## Requirements
- playsound
## Installation
```sh
pip install vipassana-timer
```
or
```sh
git clone https://github.com/toxicologist/vipassana-timer
cd vipassana-timer
python setup.py install
```
## Usage
```
>meditate -h
usage: meditate [-h] [times]
Simple vipassana meditation timer
positional arguments:
times Times for each meditation posture (format: 'p5w30s30')
optional arguments:
-h, --help show this help message and exit
```
The script takes inputs for the three postures: prostration, walking, and sitting -
represented by the letters 'p', 'w', 's', each followed by the desired time, in minutes.
For example, if one wanted to do 10 minutes walking and 10 sitting:
```sh
# example usage
>meditate w10s10
#or
>meditate
Enter times (format: 'p5w30s30'): w10s10
#result
Times:
Walking: 10
Sitting: 10
Walking: 10:00 remaining
```
Or, to do 35 minutes of sitting:
```sh
>meditate s35
Times:
Sitting: 35
Sitting: 35:00 remaining
```
If you want to add your own posture, just edit the `POSTURES` variable in `__init__.py`.
## Good luck meditating! :)
Raw data
{
"_id": null,
"home_page": "https://github.com/toxicologist/vipassana-timer",
"name": "vipassana-timer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "meditation, vipassana, timer, countdown",
"author": "toxicologist",
"author_email": "toxiccologist@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/7f/25/8bb2f412eaf0d8b1a5ac783999356fa817e85310baa56b63bced1dc87a1d/vipassana-timer-1.1.tar.gz",
"platform": null,
"description": "# vipassana-timer\nMeditation timer for vipassana (insight meditation) with different postures.\n\nFor context - this package was originally created to work with Yuttadhammo Bhikkhu's online meditation style, which includes (optional) prostration at the beginning of the meditation, then walking meditation and then sitting. If you just want to do 'normal' sitting practice, you can still use this package, just type 's' followed by the minutes you want to do. Also, you can add your own 'postures' if you want multiple bells in the sitting session - see below.\n\n## Requirements\n - playsound\n\n## Installation\n```sh\npip install vipassana-timer\n```\n\nor\n\n```sh\ngit clone https://github.com/toxicologist/vipassana-timer\ncd vipassana-timer\npython setup.py install\n```\n\n## Usage\n```\n>meditate -h\nusage: meditate [-h] [times]\n\nSimple vipassana meditation timer\n\npositional arguments:\n times Times for each meditation posture (format: 'p5w30s30')\n\noptional arguments:\n -h, --help show this help message and exit\n\n```\n\nThe script takes inputs for the three postures: prostration, walking, and sitting -\nrepresented by the letters 'p', 'w', 's', each followed by the desired time, in minutes.\n\nFor example, if one wanted to do 10 minutes walking and 10 sitting:\n```sh\n# example usage\n>meditate w10s10\n\n#or\n>meditate\nEnter times (format: 'p5w30s30'): w10s10\n\n#result\n\nTimes:\nWalking: 10\nSitting: 10\n\nWalking: 10:00 remaining\n```\n\nOr, to do 35 minutes of sitting:\n```sh\n>meditate s35\n\nTimes:\nSitting: 35\n\nSitting: 35:00 remaining\n```\n\n\nIf you want to add your own posture, just edit the `POSTURES` variable in `__init__.py`.\n\n## Good luck meditating! :)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A small meditation timer for vipassana",
"version": "1.1",
"project_urls": {
"Bug Tracker": "https://github.com/toxicologist/vipassana-timer/issues",
"Homepage": "https://github.com/toxicologist/vipassana-timer"
},
"split_keywords": [
"meditation",
" vipassana",
" timer",
" countdown"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e667b535d5d204a75cc9972d86d9d8080756cf493ae27b61730131eb86053462",
"md5": "93f8c444333f692c105b45d8e97c3850",
"sha256": "cb4ece038dd42fe240f66e1403f261238ff6ebe8a956bbe131d865ec704b520c"
},
"downloads": -1,
"filename": "vipassana_timer-1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "93f8c444333f692c105b45d8e97c3850",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 737604,
"upload_time": "2024-07-04T00:22:49",
"upload_time_iso_8601": "2024-07-04T00:22:49.738251Z",
"url": "https://files.pythonhosted.org/packages/e6/67/b535d5d204a75cc9972d86d9d8080756cf493ae27b61730131eb86053462/vipassana_timer-1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7f258bb2f412eaf0d8b1a5ac783999356fa817e85310baa56b63bced1dc87a1d",
"md5": "9ef76197576459b525962ba53fdf413e",
"sha256": "0fd9039a768f9072f9a6331e48bf2293b8e2cee4ee74ec5ab2a20220edb4c5c0"
},
"downloads": -1,
"filename": "vipassana-timer-1.1.tar.gz",
"has_sig": false,
"md5_digest": "9ef76197576459b525962ba53fdf413e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 739378,
"upload_time": "2024-07-04T00:22:56",
"upload_time_iso_8601": "2024-07-04T00:22:56.278148Z",
"url": "https://files.pythonhosted.org/packages/7f/25/8bb2f412eaf0d8b1a5ac783999356fa817e85310baa56b63bced1dc87a1d/vipassana-timer-1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-04 00:22:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "toxicologist",
"github_project": "vipassana-timer",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "vipassana-timer"
}