{"id":13501481,"url":"https://github.com/trehn/termdown","last_synced_at":"2025-05-14T21:08:12.356Z","repository":{"id":17437113,"uuid":"20210561","full_name":"trehn/termdown","owner":"trehn","description":"Countdown timer and stopwatch in your terminal","archived":false,"fork":false,"pushed_at":"2024-07-22T00:01:39.000Z","size":275,"stargazers_count":1402,"open_issues_count":32,"forks_count":112,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-04-03T06:07:37.173Z","etag":null,"topics":["countdown","python","stopwatch","terminal","timer"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/trehn.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-05-27T07:12:40.000Z","updated_at":"2025-03-30T08:05:30.000Z","dependencies_parsed_at":"2022-07-16T11:00:31.952Z","dependency_job_id":"627b08da-a9d8-42bf-a610-e562adff6862","html_url":"https://github.com/trehn/termdown","commit_stats":{"total_commits":161,"total_committers":22,"mean_commits":7.318181818181818,"dds":"0.20496894409937894","last_synced_commit":"66eb1b03be530cc859357071a77bc003f1514f34"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trehn%2Ftermdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trehn%2Ftermdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trehn%2Ftermdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trehn%2Ftermdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trehn","download_url":"https://codeload.github.com/trehn/termdown/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248202885,"owners_count":21064454,"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":["countdown","python","stopwatch","terminal","timer"],"created_at":"2024-07-31T22:01:38.953Z","updated_at":"2025-04-10T10:50:19.445Z","avatar_url":"https://github.com/trehn.png","language":"Python","readme":"![termdown demo](/termdown.gif?raw=true)\n\n```\nUsage: termdown [OPTIONS] [TIME]\n\n  Starts a countdown to TIME. Example values for TIME:\n  10, '1h 5m 30s', '12:00', '2020-01-01', '2020-01-01 14:00 UTC'.\n\n  If TIME is not given, termdown will operate in stopwatch mode\n  and count forward.\n\n  Hotkeys:\n      E       Show end time (countdown mode only)\n      L       Lap (stopwatch mode only)\n      R       Reset\n      SPACE   Pause (will delay absolute TIME)\n      +       Plus (will add 10 seconds)\n      -       Minus (will subtract 10 seconds)\n      Q       Quit\n\nOptions:\n  -a, --alt-format              Use colon-separated time format\n  -b, --blink                   Flash terminal at end of countdown\n  -B, --no-bell                 Don't ring terminal bell at end of countdown\n  -c, --critical N              Draw final N seconds in red and announce them\n                                individually with --voice or --exec-cmd\n                                (defaults to 3)\n\n  -e, --end                     Display target datetime of unpaused countdown\n  -f, --font FONT               Choose from\n                                http://www.figlet.org/examples.html\n\n  -p, --voice-prefix TEXT       Add TEXT to the beginning of --voice and\n                                --exec annunciations (except per-second ones)\n\n  -q, --quit-after N            Quit N seconds after countdown (use with -b or\n                                -t) or terminate stopwatch after N seconds\n\n  -s, --no-seconds              Don't show seconds (except for last minute of\n                                countdown and first minute of stopwatch)\n\n  -t, --text TEXT               Text to display at end of countdown\n  -T, --title TEXT              Text to display on top of countdown/stopwatch\n  -W, --no-window-title         Don't update terminal title with\n                                remaining/elapsed time\n\n  -v, --voice VOICE             Spoken countdown (at fixed intervals with per-\n                                second annunciations starting at --critical;\n                                requires `espeak` on Linux or `say` on macOS;\n                                choose VOICE from `say -v '?'` or `espeak\n                                --voices`)\n\n  -o, --outfile PATH            File to write current remaining/elapsed time\n                                to\n\n  --exec-cmd CMD                Runs CMD every second. '{0}' and '{1}' in CMD\n                                will be replaced with the remaining/elapsed\n                                number of seconds and a more sparse\n                                annunciation as in --voice, respectively. For\n                                example, to get a callout at five seconds\n                                only, use: --exec-cmd \"if [ '{0}' == '5' ];\n                                then say -v Alex {1}; fi\"\n\n  --no-figlet                   Don't use ASCII art for display\n  --no-figlet-y-offset INTEGER  Vertical offset within the terminal (only for\n                                --no-figlet)\n\n  --no-text-magic               Don't try to replace non-ASCII characters (use\n                                with -t)\n\n  --version                     Show version and exit\n  -z, --time                    Show current time instead of\n                                countdown/stopwatch\n\n  -Z, --time-format TEXT        Format for --time/--end (defaults to\n                                \"%H:%M:%S\", ignores --no-seconds)\n\n  -D, --date-format TEXT        Format for --end (defaults to \"%Y-%m-%d\")\n  --help                        Show this message and exit.\n```\n\n```\npip install termdown\n```\n\n------------------------------------------------------------------------\n\n![PyPI version](http://img.shields.io/pypi/v/termdown.svg) \u0026nbsp; ![Python 3.x](http://img.shields.io/badge/Python-3.x-green.svg) \u0026nbsp; ![PyPI license](http://img.shields.io/badge/License-GPLv3-red.svg)\n","funding_links":[],"categories":["Python","Productivity Tools"],"sub_categories":["Time Management"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrehn%2Ftermdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrehn%2Ftermdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrehn%2Ftermdown/lists"}