# PUCOTI
**A Purposeful Countdown Timer**
Stay on task with PUCOTI, a countdown timer built for simplicity and purpose.
### Features:
- **Countdown**: Counts down to zero (and can go below zero).
- **Bell Alert**: Rings a bell when it hits zero.
- **Persistent Reminder**: Rings every 20 seconds until you acknowledge it. Don't forget to do the thing.
- **Set Intentions**: Write down what you intend to do during the countdown.
- **History**: Keeps a log of your intentions and how long you spent on each.
- **Large Font**: Uses the biggest font it can for visibility.
- **Sway Integration**: Automatically moves to the corner of your screen if you use Sway WM.
- **Total Time**: Shows the total time you've spent on the timer.
- **Configurable**: Change the bell sound, waste time changing colors, and more.
- **Basic Controls**: Add or subtract time, reset the timer, but not more.
PUCOTI is straightforward and gets the job done. Give it a try.
## Screenshots
### *Pucoti can be big...*
![Screenshot of PUCOTI full-screen](./assets/screenshot.webp)
### *... or stay in a corner*
![Screenshot of PUCOTI in the bottom right of a screen](./assets/screenshot-small.webp)
### *Keep track of your intentions*
![Screenshot of PUCOTI showing the history of intentions](./assets/screenshot-history.webp)
## Installation
You can easily install PUCOTI using pip. Follow these steps:
1. **Install PUCOTI:**
```sh
pip install pucoti
```
2. **Run PUCOTI:**
```sh
pucoti 5m
```
That's it! PUCOTI should now be up and running.
## Usage
![Usage](./assets/cli-help.webp)
Raw data
{
"_id": null,
"home_page": "https://github.com/ddorn/pucoti",
"name": "pucoti",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.12",
"maintainer_email": null,
"keywords": "timer, countdown, pygame",
"author": "ddorn",
"author_email": "diego.dorn@free.fr",
"download_url": "https://files.pythonhosted.org/packages/d7/e1/4887f8b873cbd829d1e1203623588f67145023fc946256d1df44e20dedad/pucoti-0.6.3.tar.gz",
"platform": null,
"description": "# PUCOTI\n\n**A Purposeful Countdown Timer**\n\nStay on task with PUCOTI, a countdown timer built for simplicity and purpose.\n\n### Features:\n- **Countdown**: Counts down to zero (and can go below zero).\n- **Bell Alert**: Rings a bell when it hits zero.\n- **Persistent Reminder**: Rings every 20 seconds until you acknowledge it. Don't forget to do the thing.\n- **Set Intentions**: Write down what you intend to do during the countdown.\n- **History**: Keeps a log of your intentions and how long you spent on each.\n- **Large Font**: Uses the biggest font it can for visibility.\n- **Sway Integration**: Automatically moves to the corner of your screen if you use Sway WM.\n- **Total Time**: Shows the total time you've spent on the timer.\n- **Configurable**: Change the bell sound, waste time changing colors, and more.\n- **Basic Controls**: Add or subtract time, reset the timer, but not more.\n\nPUCOTI is straightforward and gets the job done. Give it a try.\n\n## Screenshots\n\n### *Pucoti can be big...*\n![Screenshot of PUCOTI full-screen](./assets/screenshot.webp)\n### *... or stay in a corner*\n![Screenshot of PUCOTI in the bottom right of a screen](./assets/screenshot-small.webp)\n### *Keep track of your intentions*\n![Screenshot of PUCOTI showing the history of intentions](./assets/screenshot-history.webp)\n\n## Installation\n\nYou can easily install PUCOTI using pip. Follow these steps:\n\n1. **Install PUCOTI:**\n ```sh\n pip install pucoti\n ```\n\n2. **Run PUCOTI:**\n ```sh\n pucoti 5m\n ```\n\nThat's it! PUCOTI should now be up and running.\n\n## Usage\n\n![Usage](./assets/cli-help.webp)\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "A Purposeful Countdown Timer",
"version": "0.6.3",
"project_urls": {
"Homepage": "https://github.com/ddorn/pucoti",
"Repository": "https://github.com/ddorn/pucoti"
},
"split_keywords": [
"timer",
" countdown",
" pygame"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "deacd4ce0571fdcbb60749b2707c9544b9cb71c5ea7b272a5153301a428cf3bd",
"md5": "be1fa164cf963f10abd4361153ce0e29",
"sha256": "eec7c2f941eff910909a65f7aa837c44ef5493c06f8c834edcdb0e8d2487d165"
},
"downloads": -1,
"filename": "pucoti-0.6.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "be1fa164cf963f10abd4361153ce0e29",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.12",
"size": 381627,
"upload_time": "2024-06-08T15:33:44",
"upload_time_iso_8601": "2024-06-08T15:33:44.919764Z",
"url": "https://files.pythonhosted.org/packages/de/ac/d4ce0571fdcbb60749b2707c9544b9cb71c5ea7b272a5153301a428cf3bd/pucoti-0.6.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d7e14887f8b873cbd829d1e1203623588f67145023fc946256d1df44e20dedad",
"md5": "f5ddacb1d75017589326572d6d03718a",
"sha256": "b47193a3b11192df33394b3c7b942238f845db44b7f899d51af9fcd7efdd2780"
},
"downloads": -1,
"filename": "pucoti-0.6.3.tar.gz",
"has_sig": false,
"md5_digest": "f5ddacb1d75017589326572d6d03718a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.12",
"size": 383958,
"upload_time": "2024-06-08T15:33:46",
"upload_time_iso_8601": "2024-06-08T15:33:46.965319Z",
"url": "https://files.pythonhosted.org/packages/d7/e1/4887f8b873cbd829d1e1203623588f67145023fc946256d1df44e20dedad/pucoti-0.6.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-08 15:33:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ddorn",
"github_project": "pucoti",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pucoti"
}