{"id":17492155,"url":"https://github.com/chunkhang/tempus","last_synced_at":"2026-01-18T11:49:11.770Z","repository":{"id":50210735,"uuid":"109513060","full_name":"chunkhang/tempus","owner":"chunkhang","description":"Tempus est de essentia","archived":false,"fork":false,"pushed_at":"2022-12-08T00:41:10.000Z","size":30,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-11T09:18:05.801Z","etag":null,"topics":["cli","pip","python3","tempus","timer"],"latest_commit_sha":null,"homepage":"https://pypi.python.org/pypi/tempus","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chunkhang.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-11-04T16:55:45.000Z","updated_at":"2023-02-13T23:20:36.000Z","dependencies_parsed_at":"2023-01-24T01:00:46.391Z","dependency_job_id":null,"html_url":"https://github.com/chunkhang/tempus","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chunkhang%2Ftempus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chunkhang%2Ftempus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chunkhang%2Ftempus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chunkhang%2Ftempus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chunkhang","download_url":"https://codeload.github.com/chunkhang/tempus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247535585,"owners_count":20954586,"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","pip","python3","tempus","timer"],"created_at":"2024-10-19T08:23:30.606Z","updated_at":"2026-01-18T11:49:11.759Z","avatar_url":"https://github.com/chunkhang.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tempus [![PyPI](https://img.shields.io/pypi/v/tempus.svg)](https://pypi.python.org/pypi/tempus) [![Travis](https://img.shields.io/travis/chunkhang/tempus.svg)](https://travis-ci.org/chunkhang/tempus)\n\n\u003cimg src=\"https://images.unsplash.com/photo-1501139083538-0139583c060f?auto=format\u0026fit=crop\u0026w=1950\u0026q=60\u0026ixid=dW5zcGxhc2guY29tOzs7Ozs%3D\" alt=\"Hourglass\" width=400/\u003e\u003cbr/\u003e\n***TEMPUS EST DE ESSENTIA*** \u003cbr/\u003e\n*Time is of the essence*\n\n## INSTALLATION\n\n```\n$ pip install tempus\n```\n**Python Versions** \u003cbr/\u003e\n3.3 | 3.4 | 3.5 | 3.6\n\n## USAGE\n\n### Timer\n**tempus timer \\\u003cduration\\\u003e** \u003cbr/\u003e\ntempus timer 1m | tempus timer 2m15s | tempus timer 30s | tempus timer 10000s \u003cbr/\u003e\u003cbr/\u003e\n![Tempus Timer](https://user-images.githubusercontent.com/12708862/32622525-188160a2-c5be-11e7-937d-6eb5c8209a22.gif)\n\n### Stopwatch\n\nComing soon\n\n### Metronome\n\nComing soon\n\n## CAVEATS\n\n### Font\nThe progress bar may appear distorted or unsmooth when filling up due to the terminal's font not displaying the unicode characters as intended. Hence, you may need to play around with your font to get the best experience.\n```\n$ tempus test\nEnsure that the characters below are:\n* Equal in height\n* Forming a smooth gradient across\n* Aesthetically pleasing\n\n|█▉▊▋▌▍▎▏ |\n|⣿⣷⣧⣇⡇⡆⡄⡀|\n\nhttps://github.com/chunkhang/tempus/#font\n```\n**Recommended Fonts** \u003cbr/\u003e\nMenlo | SF Mono \u003cbr/\u003e\n\n### Terminal\nThe progress bar needs a certain amount of space to ensure proper printing. Therefore, you may get a message if your terminal size is too small. In that case, just adjust your terminal's window before executing the command again.\n```\n$ tempus timer 1m\nThe terminal is too small: 52 x 25\nIt needs to be at least  : 80 x 10\n```\n**Minimum Size** \u003cbr/\u003e\n80 x 10\n\n## RELEASES\n\n### 1.1.0\n* Shiny new progress bar for timer\n\n### 1.0.0\n* Initial release\n\n## UNLICENSE\n\n```\nThis is free and unencumbered software released into the public domain.\n\nAnyone is free to copy, modify, publish, use, compile, sell, or\ndistribute this software, either in source code form or as a compiled\nbinary, for any purpose, commercial or non-commercial, and by any\nmeans.\n\nIn jurisdictions that recognize copyright laws, the author or authors\nof this software dedicate any and all copyright interest in the\nsoftware to the public domain. We make this dedication for the benefit\nof the public at large and to the detriment of our heirs and\nsuccessors. We intend this dedication to be an overt act of\nrelinquishment in perpetuity of all present and future rights to this\nsoftware under copyright law.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.\nIN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR\nOTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,\nARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\nOTHER DEALINGS IN THE SOFTWARE.\n\nFor more information, please refer to \u003chttp://unlicense.org\u003e\n```\n\n## CONTACT\n\nFeel free to report bugs or suggest features \u003cbr/\u003e\n**[Marcus Mu](http://marcusmu.me)** | chunkhang@gmail.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchunkhang%2Ftempus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchunkhang%2Ftempus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchunkhang%2Ftempus/lists"}