{"id":13606660,"url":"https://github.com/phux/pomogoro","last_synced_at":"2025-04-15T02:27:15.149Z","repository":{"id":73539241,"uuid":"156572136","full_name":"phux/pomogoro","owner":"phux","description":"Text-file based todo time tracking","archived":false,"fork":false,"pushed_at":"2020-04-20T21:52:53.000Z","size":175,"stargazers_count":24,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-28T14:11:41.682Z","etag":null,"topics":["pomodoro","time-tracker","todo","todotxt"],"latest_commit_sha":null,"homepage":null,"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/phux.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2018-11-07T16:01:48.000Z","updated_at":"2024-11-23T15:02:53.000Z","dependencies_parsed_at":"2024-06-20T04:22:41.635Z","dependency_job_id":"790d85d2-8a6f-4a46-a211-d68542438e85","html_url":"https://github.com/phux/pomogoro","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phux%2Fpomogoro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phux%2Fpomogoro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phux%2Fpomogoro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phux%2Fpomogoro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phux","download_url":"https://codeload.github.com/phux/pomogoro/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248993196,"owners_count":21195150,"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","time-tracker","todo","todotxt"],"created_at":"2024-08-01T19:01:11.234Z","updated_at":"2025-04-15T02:27:15.130Z","avatar_url":"https://github.com/phux.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# Pomogoro\n\nPomogoro is a command-line tool to combine [todo.txt](http://todotxt.org/) (or\nany other text based todo file) and\nthe [Pomodoro Technique](http://francescocirillo.com/pages/pomodoro-technique).\n\n![pomogoro screenshot](.github/screenshot.png)\n\n## Features\n\n- made to work with `todo.txt` files but is compatible with any line-based text\n  files\n- time tracking history per task per day\n- OS notifications (pomodoro finished, break started, break finished)\n- option to enable/disable pomodoro style tracking\n- configurable pomodoro and break durations\n- auto break after one pomodoro is finished\n\n## Installation\n\n### Option 1: get a binary\n\nGo to [Releases](https://github.com/phux/pomogoro/releases) and grep the\nappropriate release for your architecture.\n\n```\n# extract\ntar -xvzf \u003crelease.tar.gz\u003e\n# move the binary to a directory in your $PATH\nmv pomogoro ~/.local/bin\n\n```\n\n### Option 2: `go get`\n\n- [golang](https://golang.org/)\n- `PATH` contains path to `go/bin/` directory\n\n```\ngo get -u github.com/phux/pomogoro\n```\n\nAfter this you can start pomogoro via\n\n```\npomogoro --config \u003cabsolute/path/to/config.toml\u003e\n```\n\n## Configuration\n\nYou need to pass an absolute path to a config.toml file via `--config /your/path/to/config.toml`.\n\n```\n# config.toml\nTodoFile = \"/absolute/path/to/your/todo.txt\" # containing the tasks you want to track\nLogFile = \"/absolute/path/to/pomogoro.log\" # tracking log file\nBreakDuration = 5 # in minutes\nPomodoroEnabled = true # whether to use pomodoro timer or not\nPomodoroDuration = 25 # in minutes\nLogIdleTime = true # also log idle times\nLogBreakTime = true # also log breaks\n```\n\n## Keybindings\n\n| Key           | Function                                                   |\n| ------------- | ---------------------------------------------------------- |\n| `j/k/Up/Down` | Scroll down/up in windows                                  |\n| `Enter`       | Start tracking on current task in the todo window          |\n| `p`           | Toggle: Freeze timer                                       |\n| `c`           | Cancel current timer (task or break)                       |\n| `s`           | Toggle between summary per task per day and recent history |\n| `r`           | Refresh todo list                                          |\n| `?`           | Toggle: show keyboard bindings                             |\n| `CTRL-c`      | quit                                                       |\n\n## Todos\n\n- [ ] Jira: Fetch tasks \u0026 push time trackings (WIP)\n- [ ] reduce 1s lag after key press\n- [ ] cleanup codebase \u0026 more tests\n- [ ] group by todo.txt projects\n\n## Built With\n\n- [gocui](https://github.com/jroimartin/gocui) - Terminal UI\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphux%2Fpomogoro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphux%2Fpomogoro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphux%2Fpomogoro/lists"}