MyTimer: A Geeky Timer for Terminal Enthusiasts

MyTimer is a Python project that aims to provide a simple yet efficient timer for terminal users, particularly targeting the geek community. This project allows users to set timers directly from their command line interface, making it convenient for those who spend a significant amount of time working in the terminal!

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.

PyPI Counter
Github Stars

Branch	main	dev
CI

Code Quality

• Download Version 1.8 or Latest Source
• pip install .

• Check Python Packaging User Guide
• pip install mytimer==1.8

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

mytimer --version

⚠️ Press Ctrl + C to exit

mytimer

mytimer --minute=7 --second=30

mytimer --hour=2 --minute=20

⚠️ The default mode is countdown

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

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

⚠️ The default value is 1

mytimer --repeat=3 --second=4

• Use --repeat=-1 for infinite loop

⚠️ This mode may not be supported on all systems

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

⚠️ The default value is 1

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

⚠️ The default tone is 1

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

• Use --tone=-1 for random mode
• Tones List

mytimer --minute=7 --second=30 --face=3

• Use --face=-1 for random mode
• Faces List
• mytimer --faces-list

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

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

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

mytimer --sign="+"

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

mytimer --minute=5 --keep-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

mytimer --program=black-tea

• Programs List
• mytimer --programs-list

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

Screen Record

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

• Please complete the issue template

1- Mixkit Free Alarm Sound Effects

2- Online Timer

3- Media College

4- Pomodoro Technique

5- The Rule of 52 and 17: It's Random, But it Ups Your Productivity

6- Desktime’s Productivity Research: An Overview of Our Finds Throughout the Years

7- AnimeDoro Timer

8- Know Your Tea: Your Guide to Tea Steeping Time

9- How Long to Steep Tea: A Complete Guide

10- How Long to Steep French Press: Mastering the Perfect Brew

11- Freesound

Give a ⭐️ if this project helped you!