<div align="center">
<img src="https://github.com/sepandhaghighi/mytimer/raw/main/otherfiles/logo.png" width="500">
<h1>MyTimer: A Geeky Timer for Terminal Enthusiasts</h1>
<br/>
<a href="https://badge.fury.io/py/mytimer"><img src="https://badge.fury.io/py/mytimer.svg" alt="PyPI version"></a>
<a href="https://www.python.org/"><img src="https://img.shields.io/badge/built%20with-Python3-green.svg" alt="built with Python3"></a>
<a href="https://github.com/sepandhaghighi/mytimer"><img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/sepandhaghighi/mytimer"></a>
</div>
## Overview
<p align="justify">
<strong>MyTimer</strong> 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 <strong>MyTimer</strong> 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.
</p>
<table>
<tr>
<td align="center">PyPI Counter</td>
<td align="center"><a href="http://pepy.tech/project/mytimer"><img src="http://pepy.tech/badge/mytimer"></a></td>
</tr>
<tr>
<td align="center">Github Stars</td>
<td align="center"><a href="https://github.com/sepandhaghighi/mytimer"><img src="https://img.shields.io/github/stars/sepandhaghighi/mytimer.svg?style=social&label=Stars"></a></td>
</tr>
</table>
<table>
<tr>
<td align="center">Branch</td>
<td align="center">main</td>
<td align="center">dev</td>
</tr>
<tr>
<td align="center">CI</td>
<td align="center"><img src="https://github.com/sepandhaghighi/mytimer/actions/workflows/test.yml/badge.svg?branch=main"></td>
<td align="center"><img src="https://github.com/sepandhaghighi/mytimer/actions/workflows/test.yml/badge.svg?branch=dev"></td>
</tr>
</table>
<table>
<tr>
<td align="center">Code Quality</td>
<td align="center"><a href="https://www.codefactor.io/repository/github/sepandhaghighi/mytimer"><img src="https://www.codefactor.io/repository/github/sepandhaghighi/mytimer/badge" alt="CodeFactor" /></a></td>
<td align="center"><a href="https://www.codacy.com/gh/sepandhaghighi/mytimer/dashboard?utm_source=github.com&utm_medium=referral&utm_content=sepandhaghighi/mytimer&utm_campaign=Badge_Grade"><img src="https://app.codacy.com/project/badge/Grade/1bf28500431a498998ac79891cd79cda"/></a></td>
<td align="center"><a href="https://codebeat.co/projects/github-com-sepandhaghighi-mytimer-main"><img alt="codebeat badge" src="https://codebeat.co/badges/ae1c0ac1-9890-4149-b260-b1f3174ef520" /></a></td>
</tr>
</table>
## Installation
### Source Code
- Download [Version 1.9](https://github.com/sepandhaghighi/mytimer/archive/v1.9.zip) or [Latest Source](https://github.com/sepandhaghighi/mytimer/archive/dev.zip)
- `pip install .`
### PyPI
- Check [Python Packaging User Guide](https://packaging.python.org/installing/)
- `pip install mytimer==1.9`
## Usage
ℹ️ You can use `mytimer` or `python -m mytimer` to run this program
### Version
```console
mytimer --version
```
### Info
```console
mytimer --info
```
### Basic
ℹ️ Press `Ctrl + C` to exit
```console
mytimer
```
### Time Limit
```console
mytimer --minute=7 --second=30
```
```console
mytimer --hour=2 --minute=20
```
### Timer Mode
ℹ️ The default mode is `countdown`
```console
mytimer --minute=7 --second=30 --countdown
```
```console
mytimer --minute=7 --second=30 --countup
```
### Repeat
ℹ️ The default value is `1`
```console
mytimer --repeat=3 --second=4
```
* Use `--repeat=-1` for infinite loop
### Alarm
⚠️ This mode may not be supported on all systems
```console
mytimer --minute=7 --second=30 --alarm
```
### Alarm Repeat
ℹ️ The default value is `1`
```console
mytimer --minute=7 --second=30 --alarm --alarm-repeat=5
```
### Tone
ℹ️ The default tone is `1`
```console
mytimer --minute=7 --second=30 --alarm --tone=2
```
* Use `--tone=-1` for random mode
* [Tones List](https://github.com/sepandhaghighi/mytimer/blob/main/TONES.md)
### Face
```console
mytimer --minute=7 --second=30 --face=3
```
* Use `--face=-1` for random mode
* [Faces List](https://github.com/sepandhaghighi/mytimer/blob/main/FACES.md)
* `mytimer --faces-list`
### Vertical/Horizontal Shift
ℹ️ The vertical and horizontal shift both have default values of `0`
```console
mytimer --v-shift=20 --h-shift=30
```
### Timer Sign
ℹ️ Valid choices: [`""`, `"+"`, `"-"`]
```console
mytimer --sign="+"
```
### Keep on
In this mode, the timer will continue running after it times out
```console
mytimer --minute=5 --keep-on
```
### Hide Second
In this mode, the timer seconds counter will not be shown
```console
mytimer --minute=6 --hide-second
```
### Set on
⚠️ Local time
In this mode, the timer sets on the given time. For example, here we set a timer for `15:05`.
```console
mytimer --hour=15 --minute=5 --set-on
```
### Program
```console
mytimer --program=black-tea
```
* [Programs List](https://github.com/sepandhaghighi/mytimer/blob/main/PROGRAMS.md)
* `mytimer --programs-list`
### Message
```console
mytimer --minute=7 --second=30 --message="Test message"
```
<div align="center">
<img src="https://github.com/sepandhaghighi/mytimer/raw/main/otherfiles/help.gif">
<p>Screen Record</p>
</div>
## Issues & Bug Reports
Just fill an issue and describe it. We'll check it ASAP!
- Please complete the issue template
## References
<blockquote>1- <a href="https://mixkit.co/free-sound-effects/alarm/">Mixkit Free Alarm Sound Effects</a></blockquote>
<blockquote>2- <a href="https://www.online-timers.com/">Online Timer</a></blockquote>
<blockquote>3- <a href="https://www.mediacollege.com/">Media College</a></blockquote>
<blockquote>4- <a href="https://en.wikipedia.org/wiki/Pomodoro_Technique">Pomodoro Technique</a></blockquote>
<blockquote>5- <a href="https://www.themuse.com/advice/the-rule-of-52-and-17-its-random-but-it-ups-your-productivity">The Rule of 52 and 17: It's Random, But it Ups Your Productivity</a></blockquote>
<blockquote>6- <a href="https://desktime.com/blog/productivity-research">Desktime’s Productivity Research: An Overview of Our Finds Throughout the Years</a></blockquote>
<blockquote>7- <a href="https://ankushkun.github.io/animedoro-timer/Animedoro/">AnimeDoro Timer</a></blockquote>
<blockquote>8- <a href="https://worldteadirectory.com/know-tea-guide-tea-steeping-time/">Know Your Tea: Your Guide to Tea Steeping Time</a></blockquote>
<blockquote>9- <a href="https://artfultea.com/blogs/101/loose-leaf-tea-steep-time">How Long to Steep Tea: A Complete Guide</a></blockquote>
<blockquote>10- <a href="https://majestycoffee.com/blogs/posts/how-long-to-steep">How Long to Steep French Press: Mastering the Perfect Brew</a></blockquote>
<blockquote>11- <a href="https://freesound.org">Freesound</a></blockquote>
<blockquote>12- <a href="https://www.online-timer.net/">Online Timer with Alarm and Sound</a></blockquote>
## Show Your Support
<h3>Star This Repo</h3>
Give a ⭐️ if this project helped you!
<h3>Donate to Our Project</h3>
<h4>Bitcoin</h4>
1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy
<h4>Ethereum</h4>
0xcD4Db18B6664A9662123D4307B074aE968535388
<h4>Litecoin</h4>
Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ
<h4>Doge</h4>
DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh
<h4>Tron</h4>
TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7
<h4>Ripple</h4>
rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq
<h4>Binance Coin</h4>
bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef
<h4>Tether</h4>
0xcD4Db18B6664A9662123D4307B074aE968535388
<h4>Dash</h4>
Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s
<h4>Stellar</h4>
GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL
<h4>Zilliqa</h4>
zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5
<h4>Coffeete</h4>
<a href="http://www.coffeete.ir/opensource">
<img src="http://www.coffeete.ir/images/buttons/lemonchiffon.png" style="width:260px;" />
</a>
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
## [Unreleased]
## [1.9] - 2024-12-18
### Added
- 5 new tones
- `--info` argument
- `--hide-second` argument
### Changed
- GitHub actions are limited to the `dev` and `main` branches
- `countdown_timer` and `countup_timer` functions updated
- `README.md` updated
- `TONES.md` updated
## [1.8] - 2024-10-23
### Added
- 5 new tones
- Face random mode
- Tone random mode
- `get_face` function
- `get_tone` function
### Changed
- `show_faces_list` function updated
- `README.md` updated
- Test system modified
- `Python 3.13` added to `test.yml`
## [1.7] - 2024-10-09
### Added
- 2 new programs
1. `mate`
2. `french-press`
- 9 new tones
### Changed
- `README.md` updated
## [1.6] - 2024-08-30
### Added
- 2 new programs
1. `puer-tea`
2. `purple-tea`
- `--set-on` argument
### Changed
- Default mode changed from `count-up` to `countdown`
- `white-tea` program duration changed from `10` minutes to `3` minutes
## [1.5] - 2024-08-12
### Added
- 2 new programs
1. `rooibos-tea`
2. `yellow-tea`
- `--keep-on` argument
### Changed
- `README.md` updated
- Programs message updated
## [1.4] - 2024-07-15
### Added
- 1 new program
1. `mid-break`
- `--repeat` argument
- `--sign` argument
### Changed
- `long-break` program duration changed from `15` minutes to `30` minutes
- `README.md` updated
## [1.3] - 2024-05-23
### Added
- 1 new program
1. `animedoro`
- `two_step_timer` function
- `print_message` function
- `SECURITY.md`
### Changed
- Test system modified
- `nava` added to `requirements.txt`
- Sound playing system updated
- Python 3.5 dropped
- `short-break` program duration changed from `10` minutes to `5` minutes
- `long-break` program duration changed from `30` minutes to `15` minutes
- `pomodoro` program updated
- `pomodoro_timer` function modified
- `load_params` function modified
- `README.md` updated
### Removed
- `animedoro_timer` function
- `_112_26_timer` function
- `_52_17_timer` function
## [1.2] - 2024-02-05
### Added
- `feature_request.yml` template
- `config.yml` for issue template
- 2 new programs
1. `52-17`
2. `112-26`
### Changed
- Bug report template modified
- `run_timer` function modified
## [1.1] - 2023-12-20
### Added
- 1 new program
1. `pomodoro`
### Changed
- `TIME_PRINT_TEMPLATE` changed
- `KeyboardInterrupt` exit handling updated
- `ADDITIONAL_INFO` added to argparser epilog
- `Python 3.12` added to `test.yml`
## [1.0] - 2023-11-08
### Added
- `--programs-list` argument
- `--faces-list` argument
- `--v-shift` argument
- `--h-shift` argument
- `DEFAULT_PARAMS` parameter
- `PROGRAMS_DEFAULTS` parameter
- `load_program_params` function
### Changed
- `japanese-green-tea` program bug fixed
- `README.md` updated
## [0.9] - 2023-10-04
### Added
- 4 new faces
- 4 new programs
1. `work`
2. `short-break`
3. `long-break`
4. `noodle`
### Changed
- `PROGRAMS.md` updated
## [0.8] - 2023-08-07
### Added
- Logo
- `--alarm-repeat` argument
### Changed
- Tones length modified
- `README.md` updated
## [0.7] - 2023-07-23
### Added
- `--tone` argument
- `TONES.md`
- 9 new tones
### Changed
- Test system modified
- `input_check` decorator renamed to `input_handler`
- `countup_timer` function inputs modified
- `countdown_timer` function inputs modified
- `PROGRAMS.md` updated
- `FACES.md` updated
## [0.6] - 2023-07-04
### Added
- `--program` argument
- `PROGRAMS.md`
- `run_timer` function
### Changed
- Inputs type changed to `int`
- `README.md` updated
- `WRONG_INPUT_ERROR` renamed to `INPUT_ERROR_MESSAGE`
- Alarm tone changed
## [0.5] - 2023-05-25
### Added
- 5 new faces
- `--message` argument
### Changed
- `play_sound` function modified
- `playsound` removed from `requirements.txt`
- `README.md` updated
## [0.4] - 2023-02-10
### Added
- 4 new faces
- Infinite timer mode
### Changed
- `README.md` updated
- Parameters moved to `params.py`
## [0.3] - 2022-11-25
### Added
- `--face` argument
- `FACES.md`
### Changed
- `README.md` updated
- Minimum `art` library version changed from `1.8` to `2.9`
## [0.2] - 2022-11-03
### Added
- `--version` flag
### Changed
- Test system modified
- `countdown_timer` function modified
- `countup_timer` function modified
## [0.1] - 2022-10-18
### Added
- Countdown mode
- Count-up mode
- Alarm
[Unreleased]: https://github.com/sepandhaghighi/mytimer/compare/v1.9...dev
[1.9]: https://github.com/sepandhaghighi/mytimer/compare/v1.8...v1.9
[1.8]: https://github.com/sepandhaghighi/mytimer/compare/v1.7...v1.8
[1.7]: https://github.com/sepandhaghighi/mytimer/compare/v1.6...v1.7
[1.6]: https://github.com/sepandhaghighi/mytimer/compare/v1.5...v1.6
[1.5]: https://github.com/sepandhaghighi/mytimer/compare/v1.4...v1.5
[1.4]: https://github.com/sepandhaghighi/mytimer/compare/v1.3...v1.4
[1.3]: https://github.com/sepandhaghighi/mytimer/compare/v1.2...v1.3
[1.2]: https://github.com/sepandhaghighi/mytimer/compare/v1.1...v1.2
[1.1]: https://github.com/sepandhaghighi/mytimer/compare/v1.0...v1.1
[1.0]: https://github.com/sepandhaghighi/mytimer/compare/v0.9...v1.0
[0.9]: https://github.com/sepandhaghighi/mytimer/compare/v0.8...v0.9
[0.8]: https://github.com/sepandhaghighi/mytimer/compare/v0.7...v0.8
[0.7]: https://github.com/sepandhaghighi/mytimer/compare/v0.6...v0.7
[0.6]: https://github.com/sepandhaghighi/mytimer/compare/v0.5...v0.6
[0.5]: https://github.com/sepandhaghighi/mytimer/compare/v0.4...v0.5
[0.4]: https://github.com/sepandhaghighi/mytimer/compare/v0.3...v0.4
[0.3]: https://github.com/sepandhaghighi/mytimer/compare/v0.2...v0.3
[0.2]: https://github.com/sepandhaghighi/mytimer/compare/v0.1...v0.2
[0.1]: https://github.com/sepandhaghighi/mytimer/compare/daa2be6...v0.1
Raw data
{
"_id": null,
"home_page": "https://github.com/sepandhaghighi/mytimer",
"name": "mytimer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "timer time clock terminal stopwatch cli geek",
"author": "Sepand Haghighi",
"author_email": "me@sepand.tech",
"download_url": "https://files.pythonhosted.org/packages/1d/74/082e2dd077f38241e0bf75af7d6beef11c91367f933729bd67207efa2a43/mytimer-1.9.tar.gz",
"platform": null,
"description": "\n<div align=\"center\">\n<img src=\"https://github.com/sepandhaghighi/mytimer/raw/main/otherfiles/logo.png\" width=\"500\">\n<h1>MyTimer: A Geeky Timer for Terminal Enthusiasts</h1>\n<br/>\n<a href=\"https://badge.fury.io/py/mytimer\"><img src=\"https://badge.fury.io/py/mytimer.svg\" alt=\"PyPI version\"></a>\n<a href=\"https://www.python.org/\"><img src=\"https://img.shields.io/badge/built%20with-Python3-green.svg\" alt=\"built with Python3\"></a>\n<a href=\"https://github.com/sepandhaghighi/mytimer\"><img alt=\"GitHub repo size\" src=\"https://img.shields.io/github/repo-size/sepandhaghighi/mytimer\"></a>\n</div>\t\t\t\n\t\t\t\t\n## Overview\t\n\n<p align=\"justify\">\t\t\t\t\t\n<strong>MyTimer</strong> 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!\n\nThe main objective of <strong>MyTimer</strong> 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.\n</p>\n\n<table>\n\t<tr>\n\t\t<td align=\"center\">PyPI Counter</td>\n\t\t<td align=\"center\"><a href=\"http://pepy.tech/project/mytimer\"><img src=\"http://pepy.tech/badge/mytimer\"></a></td>\n\t</tr>\n\t<tr>\n\t\t<td align=\"center\">Github Stars</td>\n\t\t<td align=\"center\"><a href=\"https://github.com/sepandhaghighi/mytimer\"><img src=\"https://img.shields.io/github/stars/sepandhaghighi/mytimer.svg?style=social&label=Stars\"></a></td>\n\t</tr>\n</table>\n\n\n\n<table>\n\t<tr> \n\t\t<td align=\"center\">Branch</td>\n\t\t<td align=\"center\">main</td>\t\n\t\t<td align=\"center\">dev</td>\t\n\t</tr>\n\t<tr>\n\t\t<td align=\"center\">CI</td>\n\t\t<td align=\"center\"><img src=\"https://github.com/sepandhaghighi/mytimer/actions/workflows/test.yml/badge.svg?branch=main\"></td>\n\t\t<td align=\"center\"><img src=\"https://github.com/sepandhaghighi/mytimer/actions/workflows/test.yml/badge.svg?branch=dev\"></td>\n\t</tr>\n</table>\n\n\n<table>\n\t<tr> \n\t\t<td align=\"center\">Code Quality</td>\n\t\t<td align=\"center\"><a href=\"https://www.codefactor.io/repository/github/sepandhaghighi/mytimer\"><img src=\"https://www.codefactor.io/repository/github/sepandhaghighi/mytimer/badge\" alt=\"CodeFactor\" /></a></td>\n\t\t<td align=\"center\"><a href=\"https://www.codacy.com/gh/sepandhaghighi/mytimer/dashboard?utm_source=github.com&utm_medium=referral&utm_content=sepandhaghighi/mytimer&utm_campaign=Badge_Grade\"><img src=\"https://app.codacy.com/project/badge/Grade/1bf28500431a498998ac79891cd79cda\"/></a></td>\n\t\t<td align=\"center\"><a href=\"https://codebeat.co/projects/github-com-sepandhaghighi-mytimer-main\"><img alt=\"codebeat badge\" src=\"https://codebeat.co/badges/ae1c0ac1-9890-4149-b260-b1f3174ef520\" /></a></td>\n\t</tr>\n</table>\n\n\n## Installation\t\t\n\n### Source Code\n- Download [Version 1.9](https://github.com/sepandhaghighi/mytimer/archive/v1.9.zip) or [Latest Source](https://github.com/sepandhaghighi/mytimer/archive/dev.zip)\n- `pip install .`\t\t\t\t\n\n### PyPI\n\n- Check [Python Packaging User Guide](https://packaging.python.org/installing/) \n- `pip install mytimer==1.9`\t\t\t\t\t\t\n\n\n## Usage\n\n\u2139\ufe0f You can use `mytimer` or `python -m mytimer` to run this program\n\n### Version\n\n```console\nmytimer --version\n```\n\n### Info\n\n```console\nmytimer --info\n```\n\n### Basic\n\n\u2139\ufe0f Press `Ctrl + C` to exit\n\n```console\nmytimer\n```\n\n### Time Limit\n\n```console\nmytimer --minute=7 --second=30\n```\n\n```console\nmytimer --hour=2 --minute=20\n```\n\n### Timer Mode\n\n\u2139\ufe0f The default mode is `countdown`\n\n```console\nmytimer --minute=7 --second=30 --countdown\n```\t\n\n```console\nmytimer --minute=7 --second=30 --countup\n```\t\n\n### Repeat\n\n\u2139\ufe0f The default value is `1`\n\n```console\nmytimer --repeat=3 --second=4\n```\n* Use `--repeat=-1` for infinite loop\n\n### Alarm\n\n\u26a0\ufe0f This mode may not be supported on all systems\n\n```console\nmytimer --minute=7 --second=30 --alarm\n```\n\n### Alarm Repeat\n\n\u2139\ufe0f The default value is `1`\n\n```console\nmytimer --minute=7 --second=30 --alarm --alarm-repeat=5\n```\n\n### Tone\n\n\u2139\ufe0f The default tone is `1`\n\n```console\nmytimer --minute=7 --second=30 --alarm --tone=2\n```\n* Use `--tone=-1` for random mode\n* [Tones List](https://github.com/sepandhaghighi/mytimer/blob/main/TONES.md)\n\n### Face\n\n\n```console\nmytimer --minute=7 --second=30 --face=3\n```\n* Use `--face=-1` for random mode\n* [Faces List](https://github.com/sepandhaghighi/mytimer/blob/main/FACES.md)\n* `mytimer --faces-list`\n\n\n### Vertical/Horizontal Shift\n\n\u2139\ufe0f The vertical and horizontal shift both have default values of `0`\n\n```console\nmytimer --v-shift=20 --h-shift=30\n```\n\n### Timer Sign\n\n\u2139\ufe0f Valid choices: [`\"\"`, `\"+\"`, `\"-\"`]\n\n```console\nmytimer --sign=\"+\"\n```\n\n### Keep on\n\nIn this mode, the timer will continue running after it times out\n\n```console\nmytimer --minute=5 --keep-on\n```\n\n### Hide Second\n\nIn this mode, the timer seconds counter will not be shown\n\n```console\nmytimer --minute=6 --hide-second\n```\n\n### Set on\n\n\u26a0\ufe0f Local time\n\nIn this mode, the timer sets on the given time. For example, here we set a timer for `15:05`.\n\n```console\nmytimer --hour=15 --minute=5 --set-on\n```\n\n### Program\n\n```console\nmytimer --program=black-tea\n```\n* [Programs List](https://github.com/sepandhaghighi/mytimer/blob/main/PROGRAMS.md)\n* `mytimer --programs-list`\n\n### Message\n\n\n```console\nmytimer --minute=7 --second=30 --message=\"Test message\"\n```\n\n<div align=\"center\">\n\n<img src=\"https://github.com/sepandhaghighi/mytimer/raw/main/otherfiles/help.gif\">\n<p>Screen Record</p>\n\n</div>\n\n\n## Issues & Bug Reports\t\t\t\n\nJust fill an issue and describe it. We'll check it ASAP!\n\n- Please complete the issue template\n \t\t\t\n\n## References\n\n<blockquote>1- <a href=\"https://mixkit.co/free-sound-effects/alarm/\">Mixkit Free Alarm Sound Effects</a></blockquote>\n\n<blockquote>2- <a href=\"https://www.online-timers.com/\">Online Timer</a></blockquote>\n\n<blockquote>3- <a href=\"https://www.mediacollege.com/\">Media College</a></blockquote>\n\n<blockquote>4- <a href=\"https://en.wikipedia.org/wiki/Pomodoro_Technique\">Pomodoro Technique</a></blockquote>\n\n<blockquote>5- <a href=\"https://www.themuse.com/advice/the-rule-of-52-and-17-its-random-but-it-ups-your-productivity\">The Rule of 52 and 17: It's Random, But it Ups Your Productivity</a></blockquote>\n\n<blockquote>6- <a href=\"https://desktime.com/blog/productivity-research\">Desktime\u2019s Productivity Research: An Overview of Our Finds Throughout the Years</a></blockquote>\n\n<blockquote>7- <a href=\"https://ankushkun.github.io/animedoro-timer/Animedoro/\">AnimeDoro Timer</a></blockquote>\n\n<blockquote>8- <a href=\"https://worldteadirectory.com/know-tea-guide-tea-steeping-time/\">Know Your Tea: Your Guide to Tea Steeping Time</a></blockquote>\n\n<blockquote>9- <a href=\"https://artfultea.com/blogs/101/loose-leaf-tea-steep-time\">How Long to Steep Tea: A Complete Guide</a></blockquote>\n\n<blockquote>10- <a href=\"https://majestycoffee.com/blogs/posts/how-long-to-steep\">How Long to Steep French Press: Mastering the Perfect Brew</a></blockquote>\n\n<blockquote>11- <a href=\"https://freesound.org\">Freesound</a></blockquote>\n\n<blockquote>12- <a href=\"https://www.online-timer.net/\">Online Timer with Alarm and Sound</a></blockquote>\n\n\n## Show Your Support\n\t\t\t\t\t\t\t\t\n<h3>Star This Repo</h3>\t\t\t\t\t\n\nGive a \u2b50\ufe0f if this project helped you!\n\n<h3>Donate to Our Project</h3>\t\n\n<h4>Bitcoin</h4>\n1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy\n<h4>Ethereum</h4>\n0xcD4Db18B6664A9662123D4307B074aE968535388\n<h4>Litecoin</h4>\nLdnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ\n<h4>Doge</h4>\nDDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh\n<h4>Tron</h4>\nTCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7\n<h4>Ripple</h4>\nrN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq\n<h4>Binance Coin</h4>\nbnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef\n<h4>Tether</h4>\n0xcD4Db18B6664A9662123D4307B074aE968535388\n<h4>Dash</h4>\nXd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s\n<h4>Stellar</h4>\t\t\nGALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL\n<h4>Zilliqa</h4>\nzil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5\n<h4>Coffeete</h4>\n<a href=\"http://www.coffeete.ir/opensource\">\n<img src=\"http://www.coffeete.ir/images/buttons/lemonchiffon.png\" style=\"width:260px;\" />\n</a>\n\n\n# Changelog\nAll notable changes to this project will be documented in this file.\n\nThe format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)\nand this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).\n\n## [Unreleased]\n## [1.9] - 2024-12-18\n### Added\n- 5 new tones\n- `--info` argument\n- `--hide-second` argument\n### Changed\n- GitHub actions are limited to the `dev` and `main` branches\n- `countdown_timer` and `countup_timer` functions updated\n- `README.md` updated\n- `TONES.md` updated\n## [1.8] - 2024-10-23\n### Added\n- 5 new tones\n- Face random mode\n- Tone random mode\n- `get_face` function\n- `get_tone` function\n### Changed\n- `show_faces_list` function updated\n- `README.md` updated\n- Test system modified\n- `Python 3.13` added to `test.yml`\n## [1.7] - 2024-10-09\n### Added\n- 2 new programs\n\t1. `mate`\n\t2. `french-press`\n- 9 new tones\n### Changed\n- `README.md` updated\n## [1.6] - 2024-08-30\n### Added\n- 2 new programs\n\t1. `puer-tea`\n\t2. `purple-tea`\n- `--set-on` argument\n### Changed\n- Default mode changed from `count-up` to `countdown`\n- `white-tea` program duration changed from `10` minutes to `3` minutes\n## [1.5] - 2024-08-12\n### Added\n- 2 new programs\n\t1. `rooibos-tea`\n\t2. `yellow-tea`\n- `--keep-on` argument\n### Changed\n- `README.md` updated\n- Programs message updated\n## [1.4] - 2024-07-15\n### Added\n- 1 new program\n\t1. `mid-break`\n- `--repeat` argument\n- `--sign` argument\n### Changed\n- `long-break` program duration changed from `15` minutes to `30` minutes\n- `README.md` updated\n## [1.3] - 2024-05-23\n### Added\n- 1 new program\n\t1. `animedoro`\n- `two_step_timer` function\n- `print_message` function\n- `SECURITY.md`\n### Changed\n- Test system modified\n- `nava` added to `requirements.txt`\n- Sound playing system updated\n- Python 3.5 dropped\n- `short-break` program duration changed from `10` minutes to `5` minutes\n- `long-break` program duration changed from `30` minutes to `15` minutes\n- `pomodoro` program updated\n- `pomodoro_timer` function modified\n- `load_params` function modified\n- `README.md` updated\n### Removed\n- `animedoro_timer` function\n- `_112_26_timer` function\n- `_52_17_timer` function\n## [1.2] - 2024-02-05\n### Added\n- `feature_request.yml` template\n- `config.yml` for issue template\n- 2 new programs\n\t1. `52-17`\n\t2. `112-26`\n### Changed\n- Bug report template modified\n- `run_timer` function modified\n## [1.1] - 2023-12-20\n### Added\n- 1 new program\n\t1. `pomodoro`\n### Changed\n- `TIME_PRINT_TEMPLATE` changed\n- `KeyboardInterrupt` exit handling updated\n- `ADDITIONAL_INFO` added to argparser epilog\n- `Python 3.12` added to `test.yml`\n## [1.0] - 2023-11-08\n### Added\n- `--programs-list` argument\n- `--faces-list` argument\n- `--v-shift` argument\n- `--h-shift` argument\n- `DEFAULT_PARAMS` parameter\n- `PROGRAMS_DEFAULTS` parameter\n- `load_program_params` function\n### Changed\n- `japanese-green-tea` program bug fixed\n- `README.md` updated\n## [0.9] - 2023-10-04\n### Added\n- 4 new faces\n- 4 new programs\n\t1. `work`\n\t2. `short-break`\n\t3. `long-break`\n\t4. `noodle`\n### Changed\n- `PROGRAMS.md` updated\n## [0.8] - 2023-08-07\n### Added\n- Logo\n- `--alarm-repeat` argument\n### Changed\n- Tones length modified\n- `README.md` updated\n## [0.7] - 2023-07-23\n### Added\n- `--tone` argument\n- `TONES.md`\n- 9 new tones\n### Changed\n- Test system modified\n- `input_check` decorator renamed to `input_handler`\n- `countup_timer` function inputs modified\n- `countdown_timer` function inputs modified\n- `PROGRAMS.md` updated\n- `FACES.md` updated\n## [0.6] - 2023-07-04\n### Added\n- `--program` argument\n- `PROGRAMS.md`\n- `run_timer` function\n### Changed\n- Inputs type changed to `int`\n- `README.md` updated\n- `WRONG_INPUT_ERROR` renamed to `INPUT_ERROR_MESSAGE`\n- Alarm tone changed\n## [0.5] - 2023-05-25\n### Added\n- 5 new faces\n- `--message` argument\n### Changed\n- `play_sound` function modified\n- `playsound` removed from `requirements.txt`\n- `README.md` updated\n## [0.4] - 2023-02-10\n### Added\n- 4 new faces\n- Infinite timer mode\n### Changed\n- `README.md` updated\n- Parameters moved to `params.py`\n## [0.3] - 2022-11-25\n### Added\n- `--face` argument\n- `FACES.md`\n### Changed\n- `README.md` updated\n- Minimum `art` library version changed from `1.8` to `2.9`\n## [0.2] - 2022-11-03\n### Added\n- `--version` flag\n### Changed\n- Test system modified\n- `countdown_timer` function modified\n- `countup_timer` function modified\n## [0.1] - 2022-10-18\n### Added\n- Countdown mode\n- Count-up mode\n- Alarm\n\n[Unreleased]: https://github.com/sepandhaghighi/mytimer/compare/v1.9...dev\n[1.9]: https://github.com/sepandhaghighi/mytimer/compare/v1.8...v1.9\n[1.8]: https://github.com/sepandhaghighi/mytimer/compare/v1.7...v1.8\n[1.7]: https://github.com/sepandhaghighi/mytimer/compare/v1.6...v1.7\n[1.6]: https://github.com/sepandhaghighi/mytimer/compare/v1.5...v1.6\n[1.5]: https://github.com/sepandhaghighi/mytimer/compare/v1.4...v1.5\n[1.4]: https://github.com/sepandhaghighi/mytimer/compare/v1.3...v1.4\n[1.3]: https://github.com/sepandhaghighi/mytimer/compare/v1.2...v1.3\n[1.2]: https://github.com/sepandhaghighi/mytimer/compare/v1.1...v1.2\n[1.1]: https://github.com/sepandhaghighi/mytimer/compare/v1.0...v1.1\n[1.0]: https://github.com/sepandhaghighi/mytimer/compare/v0.9...v1.0\n[0.9]: https://github.com/sepandhaghighi/mytimer/compare/v0.8...v0.9\n[0.8]: https://github.com/sepandhaghighi/mytimer/compare/v0.7...v0.8\n[0.7]: https://github.com/sepandhaghighi/mytimer/compare/v0.6...v0.7\n[0.6]: https://github.com/sepandhaghighi/mytimer/compare/v0.5...v0.6\n[0.5]: https://github.com/sepandhaghighi/mytimer/compare/v0.4...v0.5\n[0.4]: https://github.com/sepandhaghighi/mytimer/compare/v0.3...v0.4\n[0.3]: https://github.com/sepandhaghighi/mytimer/compare/v0.2...v0.3\n[0.2]: https://github.com/sepandhaghighi/mytimer/compare/v0.1...v0.2\n[0.1]: https://github.com/sepandhaghighi/mytimer/compare/daa2be6...v0.1\n\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Geeky Timer for Terminal Enthusiasts",
"version": "1.9",
"project_urls": {
"Download": "https://github.com/sepandhaghighi/mytimer/tarball/v1.9",
"Homepage": "https://github.com/sepandhaghighi/mytimer",
"Source": "https://github.com/sepandhaghighi/mytimer"
},
"split_keywords": [
"timer",
"time",
"clock",
"terminal",
"stopwatch",
"cli",
"geek"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4128fb108626b185ab7d06c39e9844c4b1de6928015724abaadc9ba137f85c80",
"md5": "b11e63099a984985d66d79d1b341db49",
"sha256": "594e55fee3d4ebba8e5475508a38116f6349dee55e9c849d57ffd5afbc2ebf3a"
},
"downloads": -1,
"filename": "mytimer-1.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b11e63099a984985d66d79d1b341db49",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 6142693,
"upload_time": "2024-12-18T15:57:19",
"upload_time_iso_8601": "2024-12-18T15:57:19.920968Z",
"url": "https://files.pythonhosted.org/packages/41/28/fb108626b185ab7d06c39e9844c4b1de6928015724abaadc9ba137f85c80/mytimer-1.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1d74082e2dd077f38241e0bf75af7d6beef11c91367f933729bd67207efa2a43",
"md5": "2c0b5ea9ee9c2c7b4e32ddb4b5a8f2cc",
"sha256": "b77c80fe732fd5504f3ecca41cdb288ba4b0e67536ae206011e287a94a9e848e"
},
"downloads": -1,
"filename": "mytimer-1.9.tar.gz",
"has_sig": false,
"md5_digest": "2c0b5ea9ee9c2c7b4e32ddb4b5a8f2cc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 6167793,
"upload_time": "2024-12-18T15:57:14",
"upload_time_iso_8601": "2024-12-18T15:57:14.504172Z",
"url": "https://files.pythonhosted.org/packages/1d/74/082e2dd077f38241e0bf75af7d6beef11c91367f933729bd67207efa2a43/mytimer-1.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-18 15:57:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sepandhaghighi",
"github_project": "mytimer",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "art",
"specs": [
[
">=",
"5.3"
]
]
},
{
"name": "nava",
"specs": [
[
">=",
"0.4"
]
]
}
],
"lcname": "mytimer"
}
JSON
