{"id":16184343,"url":"https://github.com/mattmezza/timer","last_synced_at":"2025-06-21T05:39:02.123Z","repository":{"id":79954648,"uuid":"319596253","full_name":"mattmezza/timer","owner":"mattmezza","description":"A CLI timer for MacOS with notification support.","archived":false,"fork":false,"pushed_at":"2020-12-08T14:21:25.000Z","size":117,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-13T15:36:28.066Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/mattmezza.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-08T09:57:49.000Z","updated_at":"2023-03-08T03:07:41.000Z","dependencies_parsed_at":"2023-05-24T12:45:18.553Z","dependency_job_id":null,"html_url":"https://github.com/mattmezza/timer","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattmezza%2Ftimer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattmezza%2Ftimer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattmezza%2Ftimer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattmezza%2Ftimer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mattmezza","download_url":"https://codeload.github.com/mattmezza/timer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247656018,"owners_count":20974281,"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":[],"created_at":"2024-10-10T07:09:54.495Z","updated_at":"2025-04-07T12:46:20.900Z","avatar_url":"https://github.com/mattmezza.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"timer\n===\n\n`timer` is a utility to quickly start a timer without leaving the terminal. Thanks to `terminal-notifier` it also supports notification so that you are aware when time elapses.\n\n![](timer.gif)\n\n\n\nInstallation\n===\n\nYou can download the latest verions of `timer` (via this repository) and you can then source the `timer.sh` file in your bash profile. You can see an example of how I did it in my [dotfiles](https://github.com/mattmezza/dotfiles) (see plugins.sh and plugins.txt).\n\n```bash\ngit clone --branch 1.0.0 git@github.com/mattmezza/timer.git timer \u0026\u0026 source timer/pacco\n```\n\n`timer` should be compatible with any *nix OS but it has been tested with macOS Big Sur (and the prev version).\n\n\nDependencies\n===\n\n`timer` depends on [terminal-notifier](https://github.com/julienXX/terminal-notifier). `timer` automatically installs this dependency via `brew install terminal-notifier` if it cannot find it installed on your system.\nOf course, you need to have `brew` installed.\n\nUsage\n===\n```\nUsage:\n  $ ./timer 'Message' [OPTIONS]\nOptions:\n  -M|--msg|--message\n  -h|--hours:                 specifies the amount in hours\n  -m|--minutes:               specifies the amount in minutes\n  -s|--seconds:               specifies the amount in seconds\n  -T|--title\n  -t|--subtitle\n  -o|--open:                  optional URL to open when clicking\n  -i|--ignore-do-not-disturb: ignores DnD and awakes\\!\n  -a|--audio:                 whether or not to have the 'bling'\nE.g.:\n  $ ./timer -h 0 -m 0 -s 5 'Text'  # timer elapsing in 5sec\n  $ ./timer -h 0 -m 30 'Text'  # timer elapsing in 30min\n  $ ./timer --audio -m 1 'Text'  # timer with audio feedback\n\n```\n`timer` can be used also from `stdin` with a pipe: `echo \"Message\" | timer -i`. In case you also specify a message, the CLI option will prevail.\n\n\nDevelopment\n===\n\nDeveloping this utility is quite easy: just clone this repo and start editing the `timer.sh` file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattmezza%2Ftimer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattmezza%2Ftimer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattmezza%2Ftimer/lists"}