Metadata-Version: 2.4
Name: pucoti
Version: 0.11.2
Summary: A Purposeful Countdown Timer
Project-URL: Homepage, https://github.com/ddorn/pucoti
Project-URL: Repository, https://github.com/ddorn/pucoti
License: GPL-3.0
License-File: COPYING
Keywords: countdown,gui,pygame,timer
Requires-Python: >=3.12
Requires-Dist: luckypot>=0.1.1
Requires-Dist: platformdirs>=4.3.6
Requires-Dist: pydantic>=2.9.2
Requires-Dist: pygame-ce>=2.5.2
Requires-Dist: pyobjc-framework-cocoa==10.3.1; sys_platform == 'darwin'
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: pyzmq>=26.2.0
Requires-Dist: requests>=2.32.3
Requires-Dist: ruamel-yaml>=0.18.6
Requires-Dist: typer>=0.13.0
Description-Content-Type: text/markdown

# 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.
- **No Pause**: No pause button. Time always moves forward.

PUCOTI is straightforward and gets the job done. Give it a try.

## Screenshots

### *Pucoti can be big...*
![Screenshot of PUCOTI full-screen](./images/screenshot.webp)
### *... or stay in a corner*
![Screenshot of PUCOTI in the bottom right of a screen](./images/screenshot-small.webp)
### *Keep track of your intentions*
![Screenshot of PUCOTI showing the history of intentions](./images/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](./images/cli-help.webp)


## Contributors

A warm thank you to all the contributors who have helped make PUCOTI better and gave their precious time 💖⌛
- [@niajane](https://github.com/ddorn/pucoti/commits?author=niajane)
