/pwsh-intervalTimer

An interval/Pomodoro timer for PowerShell.

Primary LanguagePowerShell

pwsh-intervalTimer

This project is inspired by rlue's timer project.

Requirement: PowerShell on Windows

pwsh-intervalTimer is a command line interval timer written in PowerShell syntax.

Features

  • Customizable countdown timer with customizable intervals.
  • Calming, serene alert tones inspired by Buddhist meditation bells.
  • Customizable timer delays and repetitions.

Preview

Preview

Installation

Via PowerShell Gallery with the following command:

Install-Module interval-timer

Usage

$ timer [duration(in minutes), duration2, .. durationN] [options] [value]

    -r rounds                        Repeat timer (n < 0 repeats forever)
    -d seconds                       Delay timer start

Timer duration may be specified in decimal form, for example, 90 seconds may be specified as 1.5. If multiple durations are specified, an alert will be triggered at the end of each interval.

For more information, run:

man timer

Examples

Simple timer (30m)

$ timer 30

Meditation timer

Let’s say you meditate for 30 minutes. You can set the interval bell to ring after 5 minutes, so you can spend the first 5 minutes settling/relaxing yourself and your mind, and then begin the actual meditation practice when the interval bell rings.

$ timer 5,25
  1. Decide on the task to be done.
  2. Set the pomodoro timer (traditionally to 25 minutes).
  3. Work on the task until the timer rings.
  4. After the timer rings, put a checkmark on a piece of paper.
  5. If you have fewer than four checkmarks, take a short break (3–5 minutes), then go to step 2.
  6. After four pomodoros, take a longer break (15–30 minutes), reset your checkmark count to zero, then go to step 1.
$ timer 25,5,25,5,25,5,25,20

Or to repeat this 135-minute set twice in a row,

$ timer 25,5,25,5,25,5,25,20 -r 2

Credits


Rajeswar Khan