Spud

A extensible potato-themed focus timer for the shell.

Use: Work with complete focus for 25 minutes, break for 5. After four cycles, take a longer 30 minute break.¹

Installation

make install

Note

If you're on a minimalist distro, make sure you have ~/.local/bin/ in your path!

Usage

usage: spud [options]

Configuration:
  Place a bash script at '~/.config/spud/hooks.sh' to override default behaviors.
  See the example hooks.sh for details.

Options:
  -w --work-timer <int>          [default: 25]
  -b --break-timer <int>         [default 5]
  -l --long-break-timer <int>    [default 30] (0 to disable)
  -i --long-break-interval <int> [default 3]
  -g --grace-timer <int>         [default 5]
  -p --prompt-user               Wait for input when timer ends
  -s --speedup                   Debug: Count seconds, not minutes
  -h --help                      Show this message

Credits

• notification.wav, originally zapsplat_mobile_phone_notification_003_16522.mp3 obtained from zapsplat.com under CC0.
• Original Potato script created by Bladtman242

Important

LEGAL NOTICE — This software is a potato-based interval timer. It isn't affiliated with, endorsed by, or related to any registered trademarks involving tomatoes, pasta sauces, or consulting firms that claim ownership over the concept of 25-minute intervals. By using this software, you agree that time is a public utility.

Footnotes

1. Only use for focusing on work, not for ruining fun! ↩