mytimer
mytimer copied to clipboard
A Geeky Timer for Terminal Enthusiasts
Table of contents
- Overview
- Installation
- Usage
- Issues & Bug Reports
- Contribution
- References
- Authors
- License
- Show Your Support
- Changelog
- Code of Conduct
Overview
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 |
Installation
Source Code
- Download Version 1.2 or Latest Source
-
pip install .
PyPI
- Check Python Packaging User Guide
-
pip install mytimer==1.2
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 count-up
mytimer --minute=7 --second=30 --countdown
```
```console
mytimer --minute=7 --second=30 --countup
```
### Alarm
⚠️ This mode may not be supported on all systems
```console
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
- 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
Program
mytimer --program=black-tea
- Programs List
-
mytimer --programs-list
Message
mytimer --minute=7 --second=30 --message="Test message"
Screen Record
Issues & Bug Reports
Just fill an issue and describe it. We'll check it ASAP!
- Please complete the issue template
References
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
Show your support
Star this repo
Give a ⭐️ if this project helped you!