https://github.com/feoh/progress-watchdog
Watchdog: A program to help avoid analysis paralysis and time dilation due to tunnel vision.
https://github.com/feoh/progress-watchdog
Last synced: 2 months ago
JSON representation
Watchdog: A program to help avoid analysis paralysis and time dilation due to tunnel vision.
- Host: GitHub
- URL: https://github.com/feoh/progress-watchdog
- Owner: feoh
- License: mit
- Created: 2025-03-04T16:11:40.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-07T01:32:08.000Z (11 months ago)
- Last Synced: 2025-10-12T11:43:52.131Z (9 months ago)
- Language: Python
- Size: 415 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Progress Watchdog
Progress Watchdog: A program to help avoid analysis paralysis and time dilation due to tunnel vision.
## External Resources
- Hat tip to [the author](https://pixabay.com/sound-effects/buzzer-or-wrong-answer-20582/)
for the buzzer sound effect I use.
- I used [ChatGPT](https://chatgpt.com/) 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.
### 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
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
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
╰─○
```
## 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.