{"id":13537625,"url":"https://github.com/blakek/pomodoro","last_synced_at":"2025-06-14T23:31:48.207Z","repository":{"id":55627385,"uuid":"203225719","full_name":"blakek/pomodoro","owner":"blakek","description":"🍅 A simple terminal-based pomodoro timer","archived":false,"fork":false,"pushed_at":"2022-04-06T01:10:46.000Z","size":9,"stargazers_count":10,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-18T09:34:21.417Z","etag":null,"topics":["homebrew","minutes","notifications","pomodoro","pomodoro-cli","pomodoro-clock","pomodoro-technique"],"latest_commit_sha":null,"homepage":"","language":"Go","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/blakek.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-08-19T18:14:50.000Z","updated_at":"2025-02-08T07:04:54.000Z","dependencies_parsed_at":"2022-08-15T04:50:36.197Z","dependency_job_id":null,"html_url":"https://github.com/blakek/pomodoro","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blakek%2Fpomodoro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blakek%2Fpomodoro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blakek%2Fpomodoro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blakek%2Fpomodoro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blakek","download_url":"https://codeload.github.com/blakek/pomodoro/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250541751,"owners_count":21447574,"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":["homebrew","minutes","notifications","pomodoro","pomodoro-cli","pomodoro-clock","pomodoro-technique"],"created_at":"2024-08-01T09:01:01.281Z","updated_at":"2025-04-24T01:22:53.184Z","avatar_url":"https://github.com/blakek.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# pomodoro\n\n\u003e A simple terminal-based pomodoro timer\n\nThe point of pomodoro timers is to help you focus and save time. Unfortunately,\nI found myself wasting time with other tools. To fix that, I spent a few minutes\nmaking a simple timer for use in the terminal.\n\n## Usage\n\nHere are some common ways to use the timer:\n\n**Start a 25 minute timer:**\n\n```bash\npomodoro\n```\n\n**Start a short (5 minute) break:**\n\n```bash\npomodoro -s\n```\n\n**Start a short (20 minute) break:**\n\n```bash\npomodoro -l\n```\n\n**Start a 3 minute timer for tea:**\n\n```bash\npomodoro -c 3m\n```\n\n**Start a 1 hour, 2 minute, 3 second timer:**\n\n```bash\npomodoro -c 1h2m3s\n```\n\nIf you want to see more details, here's all options at the time of writing:\n\n- `-c time, --custom time`: start a custom timer (time in minutes)\n- `-h, --help`: show the help text\n- `-l, --long`: starts the timer for 20 minutes\n- `-s, --short`: starts the timer for 5 minutes\n\n**Remember:** you can always run `pomodoro --help` to get the latest list of\noptions available.\n\n## Install\n\nYou can install using [Homebrew](https://brew.sh/) or manually build from source:\n\n### Install with Homebrew\n\nRunning this in your terminal adds [my tap](https://github.com/blakek/homebrew-blakek) and installs the package:\n\n```bash\nbrew tap blakek/blakek \u0026\u0026 brew install blakek/blakek/pomodoro\n```\n\n### Build from Source\n\nFirst, either [clone this repo](https://help.github.com/articles/cloning-a-repository/)\nor [download a zip file](https://github.com/blakek/pomodoro/archive/master.zip).\n\nThen, in a terminal open to this project's directory, build with Go:\n\n```\n$ go build\n```\n\n## Updating\n\nIf you installed using Homebrew, you can use the normal `brew upgrade` process.\n\nThe easiest way to update from a source build is to pull the latest changes\n(e.g. `git pull`) and re-run the install directions. If you keep the\nrepository, you can occasionally run `git pull \u0026\u0026 go build` to build using the\nlatest changes.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblakek%2Fpomodoro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblakek%2Fpomodoro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblakek%2Fpomodoro/lists"}