{"id":13631623,"url":"https://github.com/mehdidc/pomodoro","last_synced_at":"2025-05-15T13:14:07.195Z","repository":{"id":52215628,"uuid":"90751811","full_name":"mehdidc/pomodoro","owner":"mehdidc","description":"simple command line pomodoro app with visualization of statistics","archived":false,"fork":false,"pushed_at":"2021-01-23T22:13:23.000Z","size":201,"stargazers_count":560,"open_issues_count":10,"forks_count":58,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-11T13:09:30.889Z","etag":null,"topics":["pomodoro","pomodoro-clock","pomodoro-technique","productivity","python"],"latest_commit_sha":null,"homepage":null,"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/mehdidc.png","metadata":{"files":{"readme":"README.md","changelog":null,"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-05-09T13:57:04.000Z","updated_at":"2025-03-09T06:19:33.000Z","dependencies_parsed_at":"2022-08-29T15:00:13.601Z","dependency_job_id":null,"html_url":"https://github.com/mehdidc/pomodoro","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/mehdidc%2Fpomodoro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mehdidc%2Fpomodoro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mehdidc%2Fpomodoro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mehdidc%2Fpomodoro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mehdidc","download_url":"https://codeload.github.com/mehdidc/pomodoro/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254346569,"owners_count":22055809,"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-clock","pomodoro-technique","productivity","python"],"created_at":"2024-08-01T22:02:32.424Z","updated_at":"2025-05-15T13:14:07.172Z","avatar_url":"https://github.com/mehdidc.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Pomodoro\n\nSimple command line pomodoro app with visualization of statistics.\nThe Pomodoro technique is a time management technique for improving productivity.\n\nCheck \u003chttps://en.wikipedia.org/wiki/Pomodoro_Technique\u003e\nfor more details.\n\nThe code is based on: \u003chttp://code.activestate.com/recipes/577358-pomodoro-timer/\u003e\n\n## How to install ?\n\n```bash\n    pip install pomodoro-cli\n```\n\nOR\n\n```bash\n    git clone https://github.com/mehdidc/pomodoro\n    cd pomodoro\n    pip install -r requirements.txt\n    python setup.py install\n```\n\n\n## How to use it?\n\n```bash\n  pomodoro 60 5\n```\n\nwill run pomodoro cycles of 60mins of work and 5mins of rest. \nBy default an alarm sound will be played at the end of pomodoros.\n**Warning** : alarm needs either mpg123 (https://www.mpg123.de/) or \nffplay(https://ffmpeg.org/ffplay.html) to be installed.\n\nit can be disabled using:\n  \n```bash\n  pomodoro 60 5 --alarm=False\n```\n\nInstead of an alarm, you might rather want to receive a message box each time you finish a pomodoro. \nTo do that, you can do:\n\n```bash\n  pomodoro 60 5 --notif=True --alarm=False\n```\n\n**Warning** : notif needs pyqt5 (https://pypi.python.org/pypi/PyQt5/5.8.2)\n\nEnable display of a command line countdown timer as follows:\n\n```bash\n  pomodoro 60 5 --timer=True\n```\n\n\n## Statistics\n\neach time a pomodoro is performed, its recorded on a small text database in your HOME/.pomodoro. To visualize the statistics of your pomodoros, you can use pomostat. Here are some examples:\n\n```bash\n  pomostat overall\n  pomostat week\n  pomostat thisweek\n  pomostat lastweek\n  pomostat week --weekof='2018-01-01'\n  pomostat stats\n  pomostat weeks\n  pomostat today\n  pomostat yesterday\n```\n\nCheck ```pomostat --help``` for more information. \n\nHere is an example of graph with ```pomostat thisweek```:\n\n![pomo](https://raw.githubusercontent.com/mehdidc/pomodoro/master/pomo.png)\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmehdidc%2Fpomodoro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmehdidc%2Fpomodoro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmehdidc%2Fpomodoro/lists"}