{"id":14563547,"url":"https://github.com/zxch3n/PomodoroLogger","last_synced_at":"2025-09-04T06:32:09.371Z","repository":{"id":37276040,"uuid":"195848841","full_name":"zxch3n/PomodoroLogger","owner":"zxch3n","description":"Pomodoro Logger :clock930: -- When a time tracker meets Pomodoro and Kanban board","archived":true,"fork":false,"pushed_at":"2023-03-07T15:25:34.000Z","size":28559,"stargazers_count":989,"open_issues_count":97,"forks_count":121,"subscribers_count":22,"default_branch":"master","last_synced_at":"2024-09-08T02:42:07.908Z","etag":null,"topics":["desktop","desktop-app","efficiency","electron","kanban-board","pomodoro","pomodoro-logger","pomodoro-technique","pomodoro-timer","productivity","time-management","time-tracker-app","time-tracking","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zxch3n.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-07-08T16:23:48.000Z","updated_at":"2024-09-07T20:49:29.000Z","dependencies_parsed_at":"2022-07-14T05:00:28.589Z","dependency_job_id":null,"html_url":"https://github.com/zxch3n/PomodoroLogger","commit_stats":null,"previous_names":[],"tags_count":48,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zxch3n%2FPomodoroLogger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zxch3n%2FPomodoroLogger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zxch3n%2FPomodoroLogger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zxch3n%2FPomodoroLogger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zxch3n","download_url":"https://codeload.github.com/zxch3n/PomodoroLogger/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231940610,"owners_count":18449183,"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":["desktop","desktop-app","efficiency","electron","kanban-board","pomodoro","pomodoro-logger","pomodoro-technique","pomodoro-timer","productivity","time-management","time-tracker-app","time-tracking","typescript"],"created_at":"2024-09-07T02:02:31.191Z","updated_at":"2024-12-31T03:30:39.341Z","avatar_url":"https://github.com/zxch3n.png","language":"TypeScript","funding_links":[],"categories":["Productivity Tools","typescript"],"sub_categories":["Time Management"],"readme":"\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://i.postimg.cc/hvjXfB94/icon.png\" width=\"360\"/\u003e\n\u003c/p\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://circleci.com/gh/zxch3n/PomodoroLogger\"\u003e\n    \u003cimg src=\"https://circleci.com/gh/zxch3n/PomodoroLogger.svg?style=svg\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://deepscan.io/dashboard#view=project\u0026tid=5098\u0026pid=6887\u0026bid=60495\"\u003e\n    \u003cimg src=\"https://deepscan.io/api/teams/5098/projects/6887/branches/60495/badge/grade.svg\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://codecov.io/gh/zxch3n/PomodoroLogger\"\u003e\n    \u003cimg src=\"https://codecov.io/gh/zxch3n/PomodoroLogger/branch/master/graph/badge.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/zxch3n/PomodoroLogger/releases/latest\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/downloads/zxch3n/PomodoroLogger/total\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\n\n# Pomodoro Logger :clock930:\n\n\n\u003e **Invest your time easily**\n\n[中文README](https://github.com/zxch3n/PomodoroLogger/wiki/中文README)\n\n\n\u003cimg align=\"right\" src=\"https://i.postimg.cc/0j8FJ70x/image.png\" height=\"280\"/\u003e\n\n- Use [Pomodoro Technique](https://en.wikipedia.org/wiki/Pomodoro_Technique) to manage your time\n- Collect and visualize your desktop working activities, i.e., the names and titles of the using apps, **locally**\n- Use integrated Kanban Board to make your schedule control easier\n- Analyse your efficiency\n\n## Pomodoro Technique :tomato:\n\nThe working loop in the Pomodoro Technique is split into a 25-minute focus session and a 5-minute rest session. During a work session, the user focuses on one todo item and should not do anything irrelevant. The Pomodoro Technique can greatly improve the efficiency of work and study and alleviate work fatigue.\n\nIn the Pomodoro Logger, the app will record the names and titles of the apps you use on your PC during the working sessions. The titles of apps contain rich semantic information. For example, the browser title includes the title of the website being viewed, and the IDE often provides the project path or project name.\n\n- `Pomodoro Technique - Wikipedia - Google Chrome`\n- `DeepMind (@DeepMindAI) | Twitter - Google Chrome`\n- `pomodoro-logger [C:\\code\\pomodoro-logger] .\\src\\renderer\\components\\src\\Application.tsx - WebStorm`\n\n\nBy connecting your todo items with the corresponding recorded Pomodoro sessions, you can analyze how often you are interrupted by email and social software, the time distribution of the application and application title used to complete the task. It will help you have a more comprehensive understanding of your working hours on PC.\n\n\n## Efficiency Analysis\n\nPomodoro Logger keeps a list of distracting app (you can config it in the setting). When it detect your using distracting apps, you lose your efficiency.\n\nIt calculates user efficiency by [a heuristic method](./src/shared/efficiency/efficiency.png).\n\nDemonstrating your efficiency by the dots. The larger the hole, the less efficient you are.\n\n\u003cimg width=\"150px\" src=\"https://i.postimg.cc/Kzth8088/da.gif\"/\u003e\n\nYou can view the record in detail by clicking the circle\n\n\u003cp align=\"center\"\u003e\n    \u003cimg width=\"600px\" src=\"https://i.postimg.cc/SKWhN9Vb/image.png\"/\u003e\n\u003c/pa\u003e\n\n\n# Data :chart_with_upwards_trend:\n\nPomodoro Logger records your desktop activities when you are in a working session of Pomodoro. \n\nIt only records your application activities, including the name and title of the focused application.\n\nYou can import / export / delete all your data in the settings. \n\nAll the data is saved and processed **locally**.\n\n# Kanban Board\n\nPomodoro Logger has integrated [Kanban Board](https://en.wikipedia.org/wiki/Kanban_board) to help you organize and estimate the time spent of your todos easily with confidence.\n\nThe lists in Kanban are divided into `Todo`, `In Progress`, and `Done`. Though lists customization is possible, you are required to preserve `In Progress` list and `Done` list in order to track, estimate and analyze your project time spent. You can set the estimated time cost on each todo card. Pomodoro Logger will assist you with the corresponding actual time spent record. i.e., When you are focusing on a Kanban board, it will automatically associate your Pomodoro session with the todo cards of `In Progress` list in the Kanban, which makes further analysis possible.\n\nTo make the statistics more accurate, you can keep the cards of the `In Progress` list as few as possible to precisely reflect the tasks you are focusing on.\n\n\n# Download\n\nWin10 / macOS / Linux\n\nTo download, go to [release page](https://github.com/rem2016/PomodoroLogger/releases).\n\n\n# Contribution\n\nI'd love to see you're involved! Read [the Contribution Guide](./.github/CONTRIBUTION.md) for detail.\n\n- The roadmap is shown on the [issue page](https://github.com/zxch3n/PomodoroLogger/issues)\n- If you find a bug or want a new feature, [create a issue](https://github.com/zxch3n/PomodoroLogger/issues)\n- If you want to start working on an issue, read [the Contribution Guide](./.github/CONTRIBUTION.md) and comment on the issue to let me know\n\n# Screenshot\n\n\n| **Pomodoro** |**Show Countdown in Tray**|\n|:-|:-|\n| \u003cimg src=\"https://i.postimg.cc/Fs87Gx0w/choose-Focuse.gif\" width=\"256\"/\u003e|\u003cimg src=\"https://i.postimg.cc/LsMhF6CT/tray.png\" width=\"256\"/\u003e|\n|**Session Finished**|**Switch Mode**|\n|\u003cimg src=\"https://i.postimg.cc/fT9wWQ0g/session-Finished.gif\" height=\"256\"/\u003e|\u003cimg src=\"https://i.postimg.cc/DZp202gR/switch-Mode.gif\" height=\"256\"/\u003e|\n\n| **Kanban Board**| **Draggable Card** |\n|:-| :- |\n| \u003cimg src=\"https://i.postimg.cc/rs136CfV/Kanban-Board.png\" height=\"256\"/\u003e|  \u003cimg src=\"https://i.postimg.cc/7Zrqft3P/moving-Around.gif\" height=\"256\"/\u003e|\n| **Estimate Your Time Spent**| **Search Your Cards**|\n| \u003cimg src=\"https://i.postimg.cc/HxRzScHp/todo.png\" height=\"256\"/\u003e|  \u003cimg src=\"https://i.postimg.cc/CLBKZf97/search-Card.gif\" height=\"256\"/\u003e|\n\n| **Visulization**|\n|:-|\n| \u003cimg src=\"https://i.postimg.cc/CKH5hT9V/vis.png\" width=\"512\"/\u003e|\n| \u003cimg src=\"https://i.postimg.cc/d150CRqH/vis1.png\" width=\"512\"/\u003e|\n  \n\n\n# License\n\n\n[GPL-3.0 License](./LICENSE)\n\nCopyright © 2019 Zixuan Chen.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzxch3n%2FPomodoroLogger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzxch3n%2FPomodoroLogger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzxch3n%2FPomodoroLogger/lists"}