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 |
pip install .pip install mytimer==2.3ℹ️ You can use mytimer or python -m mytimer to run this program
mytimer --version
mytimer --info
ℹ️ 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
--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
--tone=-1 for random mode--test-tone for testmytimer --minute=7 --second=30 --face=3
--face=-1 for random modemytimer --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
In this mode, the timer seconds counter will not be shown
mytimer --minute=6 --hide-second
In this mode, the date/time will not be shown
mytimer --minute=20 --hide-datetime
ℹ️ Valid choices: [gregorian, jalali]
ℹ️ The default date system is gregorian
mytimer --minute=20 --date-system=jalali
mytimer --minute=5 --vertical
⚠️ 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
mytimer --programs-listmytimer --minute=7 --second=30 --message="Test message"
Just fill an issue and describe it. We'll check it ASAP!
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
12- Online Timer with Alarm and Sound
Give a ⭐️ if this project helped you!
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
eye-breakpower-napREADME.md updatedprint_date_time function modifiedPython 3.6 support dropped--date-system argumentREADME.md updatedcountdown_timer and countup_timer functions updated--vertical argument--test-tone argumentREADME.md updatedcountdown_timer and countup_timer functions updatedcoffee-breakmeditation--hide-datetime argumentREADME.md updatedcountdown_timer and countup_timer functions updated--info argument--hide-second argumentdev and main branchescountdown_timer and countup_timer functions updatedREADME.md updatedTONES.md updatedget_face functionget_tone functionshow_faces_list function updatedREADME.md updatedPython 3.13 added to test.ymlmatefrench-pressREADME.md updatedpuer-teapurple-tea--set-on argumentcount-up to countdownwhite-tea program duration changed from 10 minutes to 3 minutesrooibos-teayellow-tea--keep-on argumentREADME.md updatedmid-break--repeat argument--sign argumentlong-break program duration changed from 15 minutes to 30 minutesREADME.md updatedanimedorotwo_step_timer functionprint_message functionSECURITY.mdnava added to requirements.txtshort-break program duration changed from 10 minutes to 5 minuteslong-break program duration changed from 30 minutes to 15 minutespomodoro program updatedpomodoro_timer function modifiedload_params function modifiedREADME.md updatedanimedoro_timer function_112_26_timer function_52_17_timer functionfeature_request.yml templateconfig.yml for issue template52-17112-26run_timer function modifiedpomodoroTIME_PRINT_TEMPLATE changedKeyboardInterrupt exit handling updatedADDITIONAL_INFO added to argparser epilogPython 3.12 added to test.yml--programs-list argument--faces-list argument--v-shift argument--h-shift argumentDEFAULT_PARAMS parameterPROGRAMS_DEFAULTS parameterload_program_params functionjapanese-green-tea program bug fixedREADME.md updatedworkshort-breaklong-breaknoodlePROGRAMS.md updated--alarm-repeat argumentREADME.md updated--tone argumentTONES.mdinput_check decorator renamed to input_handlercountup_timer function inputs modifiedcountdown_timer function inputs modifiedPROGRAMS.md updatedFACES.md updated--program argumentPROGRAMS.mdrun_timer functionintREADME.md updatedWRONG_INPUT_ERROR renamed to INPUT_ERROR_MESSAGE--message argumentplay_sound function modifiedplaysound removed from requirements.txtREADME.md updatedREADME.md updatedparams.py--face argumentFACES.mdREADME.md updatedart library version changed from 1.8 to 2.9--version flagcountdown_timer function modifiedcountup_timer function modifiedFAQs
A Geeky Timer for Terminal Enthusiasts
We found that mytimer demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Application Security
/Security News
Socket CEO Feross Aboukhadijeh and a16z partner Joel de la Garza discuss vibe coding, AI-driven software development, and how the rise of LLMs, despite their risks, still points toward a more secure and innovative future.
Research
/Security News
Threat actors hijacked Toptal’s GitHub org, publishing npm packages with malicious payloads that steal tokens and attempt to wipe victim systems.
Research
/Security News
Socket researchers investigate 4 malicious npm and PyPI packages with 56,000+ downloads that install surveillance malware.