atom-smasher / vsleep

verbose cli sleep command

vsleep

verbose sleep command, with extra features

Like normal unix/linux/BSD sleep, sleep for 5 minutes:

vsleep 300

---

Also acepts a time to sleep until. Sleep until 9pm:

vsleep 21:00
vsleep 9 pm
vsleep 9pm

Target time accepts any format that's understood by date's DATE STRING. Integer-only values are interpreted as seconds of delay, and any other characters (including spaces) cause this argument to be interpreted as DATE STRING formatted target-times.

Sleep for 2 hours:

vsleep 2 hours

Sleep until 9pm tomorrow:

vsleep 21:00 tomorrow

Sleep until 9pm, 2 days from now:

vsleep 21:00 2 days

Sleep until 9pm Friday:

vsleep 21:00 Friday

Sleep for 3 days:

vsleep 3 days

Sleep until 7pm, 1 July, 2023:

vsleep 1 July 2023 19:00
vsleep 2023-07-01 19:00

Sleep until 7pm, 1 July, 2023, New York time, specified via epoch seconds:

TZ=America/New_York vsleep @1688252400

---

A time-zones can be explicitly specified via the TZ environment variable. Sleep until 8am GMT:

TZ=GMT vsleep 08:00

---

Sleep until 9pm, but randomly add 0-300 seconds of extra delay:

vsleep -j 300 21:00

Sleep until 9pm, but randomly add or subtract 0-300 seconds of delay:

vsleep -J 300 21:00

---

Verbose output can be supressed with the -q option, making this like a standard sleep command with extra functionality for interpreting target times.

Other verbosity options can be seen via the help menu:

vsleep -h

---

Notes

• Timing accuracy tends to be in the realm of 10-50mS, on my laptop. Close enough for anything that I intend to use it for.
• There's a bash and sh version. They each do the same thing. In theory, the sh version should be more portable, but in practice the bash version is probably more portable.