Skip to main content

Progress Watchdog

Cartoon Bulldog - CC https://openverse.org/image/aedd8c62-ff3c-4365-9af1-147c1973440f?q=cartoon+bulldog&p=3

Progress Watchdog: A program to help avoid analysis paralysis and time dilation due to tunnel vision.

External Resources

  • Hat tip to the author for the buzzer sound effect I use.

  • I used ChatGPT to help me prototype this tool. AI haters please send your complaints, religious treatises, and assertions about the implications this has on my character to /dev/null. I've heard them all before and frankly I don't give a rat's posterior.

Current Status

What works, what doesn't.

Mac works great (tested on Sequoia.latest) - Windows works pretty well, though the mechanism to detect hotkey presses needs more testing. Linux isn't working yet. Natch :)

Installation via uv

Right now you can check the project out from github and run `uv run progress-watchdog'

If you want to run the program without installing, you can use uv for that as well:

╭─cpatti at rocinante in ~ 25-03-09 - 21:06:30
╰─○ uv tool run progress-watchdog                                                    <region:us-east-1>
usage: progress-watchdog [-h] --buzzer BUZZER [--timeout TIMEOUT]
progress-watchdog: error: the following arguments are required: --buzzer
╭─cpatti at rocinante in ~ 25-03-09 - 21:06:36
╰─○ uv tool run progress-watchdog --help                                             <region:us-east-1>
usage: progress-watchdog [-h] --buzzer BUZZER [--timeout TIMEOUT]

options:
  -h, --help         show this help message and exit
  --buzzer BUZZER    Filename for the alert sound to play when no progress is detected
  --timeout TIMEOUT  Number of seconds to wait before alerting that no progress was detected.
╭─cpatti at rocinante in ~ 25-03-09 - 21:06:54
╰─○                                                                                  <region:us-east-1>

You'll also need to provide an MP3 file that the program will play to shock you out of your tunnel vision :)

I used this one but you can choose any you like!

TODO

  • Implement some cleaner way to exit than Ctrl-c with an exception :)
  • Make configurables into args or a configuration file or something.
  • Make the "I made Progress!" key chord not insert characters into the buffer.

Metadata

Release files for progress-watchdog 0.1.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for progress-watchdog 0.1.5
File Size Uploaded Provenance Actions
progress_watchdog-0.1.5.tar.gz 291.3 kB Without provenance Details for progress_watchdog-0.1.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for progress-watchdog 0.1.5
File Interpreter ABI Platform Actions
progress_watchdog-0.1.5-py3-none-any.whl Python 3 none any Details for progress_watchdog-0.1.5-py3-none-any.whl

Total release size: 347.5 kB

Release files / progress_watchdog-0.1.5.tar.gz

Download URL progress_watchdog-0.1.5.tar.gz
Size 291.3 kB
Tags Source
SHA-256 checksum
How to use checksums
5a851cf451bba96d58c0b35afc30ca1f734c17936caf4aa20280fd032d6aa9af
BLAKE2b-256 checksum
How to use checksums
5ee7659d45c7e649143dfb567e87bdabf470ef4968883bbc0365915843ead7ed
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.5.24

Release files / progress_watchdog-0.1.5-py3-none-any.whl

Download URL progress_watchdog-0.1.5-py3-none-any.whl
Size 56.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
07bd1c8a346840ead1aa2dd553da8aa5630d67b9b266025772f1cf583e66d966
BLAKE2b-256 checksum
How to use checksums
cc273f1b9d6add7ca7155f28e036b7592100abee500f6f5d94f1702a385b1195
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.5.24

Security for progress-watchdog 0.1.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page