Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zxch3n/PomodoroLogger

Pomodoro Logger :clock930: -- When a time tracker meets Pomodoro and Kanban board
https://github.com/zxch3n/PomodoroLogger

desktop desktop-app efficiency electron kanban-board pomodoro pomodoro-logger pomodoro-technique pomodoro-timer productivity time-management time-tracker-app time-tracking typescript

Last synced: 4 months ago
JSON representation

Pomodoro Logger :clock930: -- When a time tracker meets Pomodoro and Kanban board

Awesome Lists containing this project

README 

        




  






  

    

  

  

    

  

  

    

  

  

    

  




# Pomodoro Logger :clock930:



> **Invest your time easily**



[中文README](https://github.com/zxch3n/PomodoroLogger/wiki/中文README)






- Use [Pomodoro Technique](https://en.wikipedia.org/wiki/Pomodoro_Technique) to manage your time

- Collect and visualize your desktop working activities, i.e., the names and titles of the using apps, **locally**

- Use integrated Kanban Board to make your schedule control easier

- Analyse your efficiency



## Pomodoro Technique :tomato:



The 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.



In 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.



- `Pomodoro Technique - Wikipedia - Google Chrome`

- `DeepMind (@DeepMindAI) | Twitter - Google Chrome`

- `pomodoro-logger [C:\code\pomodoro-logger] .\src\renderer\components\src\Application.tsx - WebStorm`



By 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.



## Efficiency Analysis



Pomodoro 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.



It calculates user efficiency by [a heuristic method](./src/shared/efficiency/efficiency.png).



Demonstrating your efficiency by the dots. The larger the hole, the less efficient you are.






You can view the record in detail by clicking the circle





    



# Data :chart_with_upwards_trend:



Pomodoro Logger records your desktop activities when you are in a working session of Pomodoro. 



It only records your application activities, including the name and title of the focused application.



You can import / export / delete all your data in the settings. 



All the data is saved and processed **locally**.



# Kanban Board



Pomodoro 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.



The 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.



To 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.



# Download



Win10 / macOS / Linux



To download, go to [release page](https://github.com/rem2016/PomodoroLogger/releases).



# Contribution



I'd love to see you're involved! Read [the Contribution Guide](./.github/CONTRIBUTION.md) for detail.



- The roadmap is shown on the [issue page](https://github.com/zxch3n/PomodoroLogger/issues)

- If you find a bug or want a new feature, [create a issue](https://github.com/zxch3n/PomodoroLogger/issues)

- 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



# Screenshot



| **Pomodoro** |**Show Countdown in Tray**|

|:-|:-|

| ||

|**Session Finished**|**Switch Mode**|

|||



| **Kanban Board**| **Draggable Card** |

|:-| :- |

| |  |

| **Estimate Your Time Spent**| **Search Your Cards**|

| |  |



| **Visulization**|

|:-|

| |

| |

  



# License



[GPL-3.0 License](./LICENSE)



Copyright © 2019 Zixuan Chen.