{"id":17685820,"url":"https://github.com/sepandhaghighi/mytimer","last_synced_at":"2025-04-04T10:02:12.729Z","repository":{"id":61663953,"uuid":"551120902","full_name":"sepandhaghighi/mytimer","owner":"sepandhaghighi","description":"A Geeky Timer for Terminal Enthusiasts","archived":false,"fork":false,"pushed_at":"2024-11-28T19:59:36.000Z","size":6378,"stargazers_count":108,"open_issues_count":1,"forks_count":10,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-11-29T09:14:04.256Z","etag":null,"topics":["cli","console","console-app","console-application","counter","geek","pomodoro","pomodoro-technique","pomodoro-timer","python","stopwatch","terminal","terminal-app","terminal-based","time-management","timer"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sepandhaghighi.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":"https://github.com/sepandhaghighi/mytimer#show-your-support"}},"created_at":"2022-10-13T21:51:09.000Z","updated_at":"2024-11-07T10:06:17.000Z","dependencies_parsed_at":"2024-01-13T21:22:25.107Z","dependency_job_id":"7c91f5ee-c9bb-41dd-b0d2-ebbf6b7f551f","html_url":"https://github.com/sepandhaghighi/mytimer","commit_stats":{"total_commits":135,"total_committers":5,"mean_commits":27.0,"dds":0.1703703703703704,"last_synced_commit":"a98137c010df3d6a3e499e01158a1e714bb06b9c"},"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sepandhaghighi%2Fmytimer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sepandhaghighi%2Fmytimer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sepandhaghighi%2Fmytimer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sepandhaghighi%2Fmytimer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sepandhaghighi","download_url":"https://codeload.github.com/sepandhaghighi/mytimer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247151237,"owners_count":20892290,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","console","console-app","console-application","counter","geek","pomodoro","pomodoro-technique","pomodoro-timer","python","stopwatch","terminal","terminal-app","terminal-based","time-management","timer"],"created_at":"2024-10-24T10:29:08.848Z","updated_at":"2025-04-04T10:02:12.689Z","avatar_url":"https://github.com/sepandhaghighi.png","language":"Python","funding_links":["https://github.com/sepandhaghighi/mytimer#show-your-support"],"categories":["\u003ca name=\"time-tracker\"\u003e\u003c/a\u003eTime trackers"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://github.com/sepandhaghighi/mytimer/raw/main/otherfiles/logo.png\" width=\"500\"\u003e\n\u003ch1\u003eMyTimer: A Geeky Timer for Terminal Enthusiasts\u003c/h1\u003e\n\u003cbr/\u003e\n\u003ca href=\"https://badge.fury.io/py/mytimer\"\u003e\u003cimg src=\"https://badge.fury.io/py/mytimer.svg\" alt=\"PyPI version\"\u003e\u003c/a\u003e\n\u003ca href=\"https://www.python.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/built%20with-Python3-green.svg\" alt=\"built with Python3\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/sepandhaghighi/mytimer\"\u003e\u003cimg alt=\"GitHub repo size\" src=\"https://img.shields.io/github/repo-size/sepandhaghighi/mytimer\"\u003e\u003c/a\u003e\n\u003c/div\u003e\t\t\t\n\t\t\t\t\n## Overview\t\n\n\u003cp align=\"justify\"\u003e\t\t\t\t\t\n\u003cstrong\u003eMyTimer\u003c/strong\u003e 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 \u003cstrong\u003eMyTimer\u003c/strong\u003e 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\u003c/p\u003e\n\n\u003ctable\u003e\n\t\u003ctr\u003e\n\t\t\u003ctd align=\"center\"\u003ePyPI Counter\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003e\u003ca href=\"http://pepy.tech/project/mytimer\"\u003e\u003cimg src=\"http://pepy.tech/badge/mytimer\"\u003e\u003c/a\u003e\u003c/td\u003e\n\t\u003c/tr\u003e\n\t\u003ctr\u003e\n\t\t\u003ctd align=\"center\"\u003eGithub Stars\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/sepandhaghighi/mytimer\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/sepandhaghighi/mytimer.svg?style=social\u0026label=Stars\"\u003e\u003c/a\u003e\u003c/td\u003e\n\t\u003c/tr\u003e\n\u003c/table\u003e\n\n\n\n\u003ctable\u003e\n\t\u003ctr\u003e \n\t\t\u003ctd align=\"center\"\u003eBranch\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003emain\u003c/td\u003e\t\n\t\t\u003ctd align=\"center\"\u003edev\u003c/td\u003e\t\n\t\u003c/tr\u003e\n\t\u003ctr\u003e\n\t\t\u003ctd align=\"center\"\u003eCI\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003e\u003cimg src=\"https://github.com/sepandhaghighi/mytimer/actions/workflows/test.yml/badge.svg?branch=main\"\u003e\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003e\u003cimg src=\"https://github.com/sepandhaghighi/mytimer/actions/workflows/test.yml/badge.svg?branch=dev\"\u003e\u003c/td\u003e\n\t\u003c/tr\u003e\n\u003c/table\u003e\n\n\n\u003ctable\u003e\n\t\u003ctr\u003e \n\t\t\u003ctd align=\"center\"\u003eCode Quality\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003e\u003ca href=\"https://www.codefactor.io/repository/github/sepandhaghighi/mytimer\"\u003e\u003cimg src=\"https://www.codefactor.io/repository/github/sepandhaghighi/mytimer/badge\" alt=\"CodeFactor\" /\u003e\u003c/a\u003e\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003e\u003ca href=\"https://www.codacy.com/gh/sepandhaghighi/mytimer/dashboard?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=sepandhaghighi/mytimer\u0026amp;utm_campaign=Badge_Grade\"\u003e\u003cimg src=\"https://app.codacy.com/project/badge/Grade/1bf28500431a498998ac79891cd79cda\"/\u003e\u003c/a\u003e\u003c/td\u003e\n\t\t\u003ctd align=\"center\"\u003e\u003ca href=\"https://codebeat.co/projects/github-com-sepandhaghighi-mytimer-main\"\u003e\u003cimg alt=\"codebeat badge\" src=\"https://codebeat.co/badges/ae1c0ac1-9890-4149-b260-b1f3174ef520\" /\u003e\u003c/a\u003e\u003c/td\u003e\n\t\u003c/tr\u003e\n\u003c/table\u003e\n\n\n## Installation\t\t\n\n### Source Code\n- Download [Version 2.2](https://github.com/sepandhaghighi/mytimer/archive/v2.2.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==2.2`\t\t\t\t\t\t\n\n\n## Usage\n\nℹ️ 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ℹ️ 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ℹ️ 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ℹ️ 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⚠️ 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ℹ️ The default value is `1`\n\n```console\nmytimer --minute=7 --second=30 --alarm --alarm-repeat=5\n```\n\n### Tone\n\nℹ️ 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* Use `--test-tone` for test\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ℹ️ 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ℹ️ 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### Hide Date/Time\n\nIn this mode, the date/time will not be shown\n\n```console\nmytimer --minute=20 --hide-datetime\n```\n\n### Date System\n\nℹ️ Valid choices: [`gregorian`, `jalali`]\n\nℹ️ The default date system is `gregorian`\n\n```console\nmytimer --minute=20 --date-system=jalali\n```\n\n### Vertical Mode\n\n```console\nmytimer --minute=5 --vertical\n```\n\n### Set on\n\n⚠️ 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## Screen Record\n\n\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"https://github.com/sepandhaghighi/mytimer/raw/main/otherfiles/help.gif\"\u003e\n\n\u003c/div\u003e\n\n\n## Issues \u0026 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\u003cblockquote\u003e1- \u003ca href=\"https://mixkit.co/free-sound-effects/alarm/\"\u003eMixkit Free Alarm Sound Effects\u003c/a\u003e\u003c/blockquote\u003e\n\n\u003cblockquote\u003e2- \u003ca href=\"https://www.online-timers.com/\"\u003eOnline Timer\u003c/a\u003e\u003c/blockquote\u003e\n\n\u003cblockquote\u003e3- \u003ca href=\"https://www.mediacollege.com/\"\u003eMedia College\u003c/a\u003e\u003c/blockquote\u003e\n\n\u003cblockquote\u003e4- \u003ca href=\"https://en.wikipedia.org/wiki/Pomodoro_Technique\"\u003ePomodoro Technique\u003c/a\u003e\u003c/blockquote\u003e\n\n\u003cblockquote\u003e5- \u003ca href=\"https://www.themuse.com/advice/the-rule-of-52-and-17-its-random-but-it-ups-your-productivity\"\u003eThe Rule of 52 and 17: It's Random, But it Ups Your Productivity\u003c/a\u003e\u003c/blockquote\u003e\n\n\u003cblockquote\u003e6- \u003ca href=\"https://desktime.com/blog/productivity-research\"\u003eDesktime’s Productivity Research: An Overview of Our Finds Throughout the Years\u003c/a\u003e\u003c/blockquote\u003e\n\n\u003cblockquote\u003e7- \u003ca href=\"https://ankushkun.github.io/animedoro-timer/Animedoro/\"\u003eAnimeDoro Timer\u003c/a\u003e\u003c/blockquote\u003e\n\n\u003cblockquote\u003e8- \u003ca href=\"https://worldteadirectory.com/know-tea-guide-tea-steeping-time/\"\u003eKnow Your Tea: Your Guide to Tea Steeping Time\u003c/a\u003e\u003c/blockquote\u003e\n\n\u003cblockquote\u003e9- \u003ca href=\"https://artfultea.com/blogs/101/loose-leaf-tea-steep-time\"\u003eHow Long to Steep Tea: A Complete Guide\u003c/a\u003e\u003c/blockquote\u003e\n\n\u003cblockquote\u003e10- \u003ca href=\"https://majestycoffee.com/blogs/posts/how-long-to-steep\"\u003eHow Long to Steep French Press: Mastering the Perfect Brew\u003c/a\u003e\u003c/blockquote\u003e\n\n\u003cblockquote\u003e11- \u003ca href=\"https://freesound.org\"\u003eFreesound\u003c/a\u003e\u003c/blockquote\u003e\n\n\u003cblockquote\u003e12- \u003ca href=\"https://www.online-timer.net/\"\u003eOnline Timer with Alarm and Sound\u003c/a\u003e\u003c/blockquote\u003e\n\n\n## Show Your Support\n\t\t\t\t\t\t\t\t\n\u003ch3\u003eStar This Repo\u003c/h3\u003e\t\t\t\t\t\n\nGive a ⭐️ if this project helped you!\n\n\u003ch3\u003eDonate to Our Project\u003c/h3\u003e\t\n\n\u003ch4\u003eBitcoin\u003c/h4\u003e\n1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy\n\u003ch4\u003eEthereum\u003c/h4\u003e\n0xcD4Db18B6664A9662123D4307B074aE968535388\n\u003ch4\u003eLitecoin\u003c/h4\u003e\nLdnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ\n\u003ch4\u003eDoge\u003c/h4\u003e\nDDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh\n\u003ch4\u003eTron\u003c/h4\u003e\nTCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7\n\u003ch4\u003eRipple\u003c/h4\u003e\nrN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq\n\u003ch4\u003eBinance Coin\u003c/h4\u003e\nbnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef\n\u003ch4\u003eTether\u003c/h4\u003e\n0xcD4Db18B6664A9662123D4307B074aE968535388\n\u003ch4\u003eDash\u003c/h4\u003e\nXd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s\n\u003ch4\u003eStellar\u003c/h4\u003e\t\t\nGALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL\n\u003ch4\u003eZilliqa\u003c/h4\u003e\nzil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5\n\u003ch4\u003eCoffeete\u003c/h4\u003e\n\u003ca href=\"http://www.coffeete.ir/opensource\"\u003e\n\u003cimg src=\"http://www.coffeete.ir/images/buttons/lemonchiffon.png\" style=\"width:260px;\" /\u003e\n\u003c/a\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsepandhaghighi%2Fmytimer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsepandhaghighi%2Fmytimer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsepandhaghighi%2Fmytimer/lists"}