Skip to main content

A Purposeful Countdown Timer

Project description

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

... or stay in a corner

Screenshot of PUCOTI in the bottom right of a screen

Keep track of your intentions

Screenshot of PUCOTI showing the history of intentions

Installation

You can easily install PUCOTI using pip. Follow these steps:

  1. Install PUCOTI:

    pip install pucoti
    
  2. Run PUCOTI:

    pucoti 5m
    

That's it! PUCOTI should now be up and running.

Usage

Usage

Telemetry

I collect minimal anonymous usage statistics to prioritise per-platform development. On startup, PUCOTI sends its version and basic OS/desktop metadata. It also reports when you use some specific features (e.g. joining a room). You can see what is sent in telemetry.py and desactivate it by passing --no-telemetry or setting telemetry = false in the config file.

It also lets me know how many people use PUCOTI, and this motivates me a lot to keep making it better!

Contributors

A warm thank you to all the contributors who have helped make PUCOTI better and gave their precious time 💖⌛

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pucoti-0.12.6-py3-none-any.whl (437.7 kB view details)

Uploaded Python 3

File details

Details for the file pucoti-0.12.6-py3-none-any.whl.

File metadata

  • Download URL: pucoti-0.12.6-py3-none-any.whl
  • Upload date:
  • Size: 437.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.21

File hashes

Hashes for pucoti-0.12.6-py3-none-any.whl
Algorithm Hash digest
SHA256 15d96e446ca7c7d5d229d719714d4f88fed0d2bd142d634a26a43b4c8f37b53f
MD5 a1706fb762e5402c9d34624119989955
BLAKE2b-256 a9b67977aa9225e43fbe40a4cc7ec3797bde1ffb81feda37dbf184bdae0f599b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page