mytimer

A Geeky Timer for Terminal Enthusiasts

MIT License

Downloads
1.1K
Stars
104
Committers
4

Overview

The main objective of MyTimer is to offer a minimalistic and distraction-free timer experience. It provides a clean and straightforward interface, ensuring that users can focus solely on tracking time without any unnecessary clutter or distractions.

Installation

Source Code

PyPI

Usage

⚠️ You can use mytimer or python -m mytimer to run this program

Version

mytimer --version

Basic

⚠️ Press Ctrl + C to exit

mytimer

Time Limit

mytimer --minute=7 --second=30
mytimer --hour=2 --minute=20

Timer Mode

⚠️ The default mode is countdown

mytimer --minute=7 --second=30 --countdown
mytimer --minute=7 --second=30 --countup

Repeat

⚠️ The default value is 1

mytimer --repeat=3 --second=4
  • Use --repeat=-1 for infinite loop

Alarm

⚠️ This mode may not be supported on all systems

mytimer --minute=7 --second=30 --alarm

Alarm Repeat

⚠️ The default value is 1

mytimer --minute=7 --second=30 --alarm --alarm-repeat=5

Tone

⚠️ The default tone is 1

mytimer --minute=7 --second=30 --alarm --tone=2

Face

mytimer --minute=7 --second=30 --face=3
  • Use --face=-1 for random mode
  • Faces List
  • mytimer --faces-list

Vertical/Horizontal Shift

⚠️ The vertical and horizontal shift both have default values of 0

mytimer --v-shift=20 --h-shift=30

Timer Sign

⚠️ Valid choices: ["", "+", "-"]

mytimer --sign="+"

Keep on

In this mode, the timer will continue running after it times out

mytimer --minute=5 --keep-on

Set on

⚠️ Local time

In this mode, the timer sets on the given time. For example, here we set a timer for 15:05.

mytimer --hour=15 --minute=5 --set-on

Program

mytimer --program=black-tea

Message

mytimer --minute=7 --second=30 --message="Test message"

Issues & Bug Reports

Just fill an issue and describe it. We'll check it ASAP!

  • Please complete the issue template

References

Show Your Support

Give a ⭐️ if this project helped you!