{"id":13492174,"url":"https://github.com/coolcode/tomato-clock","last_synced_at":"2025-05-16T14:08:15.345Z","repository":{"id":51072977,"uuid":"245938714","full_name":"coolcode/tomato-clock","owner":"coolcode","description":"Tomato Clock is a straightforward command-line Pomodoro application. https://en.wikipedia.org/wiki/Pomodoro_Technique","archived":false,"fork":false,"pushed_at":"2024-09-23T17:35:10.000Z","size":124,"stargazers_count":524,"open_issues_count":0,"forks_count":114,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-05-13T14:59:32.425Z","etag":null,"topics":["pomodoro","pomodoro-timer","python","terminal","terminal-app","tomato","tomato-timer"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/tomato-clock","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/coolcode.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-09T03:49:59.000Z","updated_at":"2025-05-13T02:13:13.000Z","dependencies_parsed_at":"2024-02-03T08:33:18.364Z","dependency_job_id":"9e39f644-26e1-411d-8237-7555493aab39","html_url":"https://github.com/coolcode/tomato-clock","commit_stats":{"total_commits":46,"total_committers":2,"mean_commits":23.0,"dds":"0.021739130434782594","last_synced_commit":"8b0aad21485819c1f05566ff2f9cb7bf4b525817"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coolcode%2Ftomato-clock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coolcode%2Ftomato-clock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coolcode%2Ftomato-clock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coolcode%2Ftomato-clock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coolcode","download_url":"https://codeload.github.com/coolcode/tomato-clock/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254544146,"owners_count":22088807,"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":["pomodoro","pomodoro-timer","python","terminal","terminal-app","tomato","tomato-timer"],"created_at":"2024-07-31T19:01:03.741Z","updated_at":"2025-05-16T14:08:12.321Z","avatar_url":"https://github.com/coolcode.png","language":"Python","readme":"# 🍅 Tomato Clock (Python)\n\n[![Publish to PyPI](https://github.com/coolcode/tomato-clock/actions/workflows/package.yml/badge.svg)](https://github.com/coolcode/tomato-clock/actions/workflows/package.yml)\n[![PyPI tomato-clock](https://badge.fury.io/py/tomato-clock.svg)](https://pypi.python.org/pypi/tomato-clock/)\n\nTomato Clock is a straightforward command-line Pomodoro application.\n\n- [Pomodoro Technique](https://en.wikipedia.org/wiki/Pomodoro_Technique)\n- [番茄工作法](https://zh.wikipedia.org/zh-cn/%E7%95%AA%E8%8C%84%E5%B7%A5%E4%BD%9C%E6%B3%95)\n- [Tomato Clock (Rust)](https://github.com/coolcode/tomato-clock-rs)\n\n## Installation\n\n[Install python](https://www.python.org)\n\n- Install via pip:\n\n```sh\npip install tomato-clock\n```\n\n- Install via source code:\n\n```sh\ngit clone https://github.com/coolcode/tomato-clock.git\ncd tomato-clock\nchmod +x tomato.py \n```\n\n## How to use\n\n- if you install via pip\n\n```sh\ntomato         # start a 25 minutes tomato clock + 5 minutes break\ntomato -t      # start a 25 minutes tomato clock\ntomato -t \u003cn\u003e  # start a \u003cn\u003e minutes tomato clock\ntomato -b      # take a 5 minutes break\ntomato -b \u003cn\u003e  # take a \u003cn\u003e minutes break\ntomato -h      # help\n```\n\n- if you install via source code\n\n```sh\n./tomato.py         # start a 25 minutes tomato clock + 5 minutes break\n./tomato.py -t      # start a 25 minutes tomato clock\n./tomato.py -t \u003cn\u003e  # start a \u003cn\u003e minutes tomato clock\n./tomato.py -b      # take a 5 minutes break\n./tomato.py -b \u003cn\u003e  # take a \u003cn\u003e minutes break\n./tomato.py -h      # help\n```\n\n## Terminal Output\n\n```sh\n🍅 tomato 25 minutes. Ctrl+C to exit\n 🍅🍅---------------------------------------------- [8%] 23:04 ⏰ \n```\n\n## Desktop Notification\n\n- MacOS\n\n```sh\nbrew install terminal-notifier \n```\n\n`terminal-notifier` actually is a cross-platform desktop notifier, please refer to ➜ [terminal-notifier](https://github.com/julienXX/terminal-notifier#download)\n\n\u003cimg src=\"https://github.com/coolcode/tomato-clock/blob/master/img/screenshot-macos.png?raw=true\" alt=\"terminal-notifier\" width=\"300\"/\u003e\n\n- Ubuntu\n\n`notify-send`\n\n\u003cimg src=\"https://github.com/coolcode/tomato-clock/blob/master/img/screenshot-ubuntu.png?raw=true\" alt=\"ubuntu-notification\" width=\"300\"/\u003e\n\n\n## Voice Notifications\n\nTomato Clock uses `say`(text-to-speech) for voice notifications.\n\n- MacOS\n\nMacOS already has `say`. see [here](https://ss64.com/osx/say.html) or [more detail](https://gist.github.com/mculp/4b95752e25c456d425c6)  \n\n- Ubuntu\n\nSee this link: [say](http://manpages.ubuntu.com/manpages/trusty/man1/say.1.html)\n\n```sh\nsudo apt-get install gnustep-gui-runtime\n```\n\n- Windows\n\nCheck this one: https://github.com/SeanBracksDev/tomato-clock\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoolcode%2Ftomato-clock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoolcode%2Ftomato-clock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoolcode%2Ftomato-clock/lists"}