https://github.com/ltbringer/boxtime

Analyze timeboxed events on your calendar.
https://github.com/ltbringer/boxtime

Last synced: 10 months ago
JSON representation

Analyze timeboxed events on your calendar.

• Host: GitHub
• URL: https://github.com/ltbringer/boxtime
• Owner: ltbringer
• License: mit
• Created: 2023-12-27T19:52:00.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-01-06T12:39:59.000Z (over 2 years ago)
• Last Synced: 2025-03-25T09:18:58.303Z (about 1 year ago)
• Language: Python
• Size: 1.34 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# BoxTime

An application that helps you understand the distribution of time across different categories of

tasks that you perform.

You need:

- A clone of this project.

- Google Calendar

- Habit of timeboxing tasks.

## Installation

You need:

1. Miniconda/conda or any other environment manager that allows installing and switching python versions.

    ```shell

    conda create -n timebox python=3.10 # 3.10 or higher works

    ```

2. Python 3.10 or above.

3. `git`: To clone this project.

4. jupyter notebook or vscode jupyter extension.

5. A google cloud account.

    

    Getting GCP credentials

    You'd need to request credentials from google cloud to access the calendar API.

    [This guide](https://developers.google.com/calendar/api/quickstart/python) outlines the steps needed to acquire the credentials. 

    ![Google credentials page](./resources/image.png)

    Once you hit create, you will be able to download the credentials. The file is originally named as `client_secret_(\d+)-[a-z0-9]+.apps.googleusercontent.com.json`

    

6. Create a `credentials` dir at the root and save the credential as `google.credentials.json`.

7. Launch the sketch.ipynb.

8. (Optional) You can install custom fonts if you prefer that to the default selected by matplotlib. Clearing the font cache in `~/.cache/matplotlib/` might be necessary.

## Demo

### Quantitative

Quality of time spent over a year

![Heatmap showing time spent](./resources/charts/heatmap.png)

This chart penalizes working longer hours as much as staggeringly less. However, this is a judgement based on quantity and misses importance of themes like:

- _Great work done efficiently_.

- _Time taken to resolve major outages._

Distribution of time over different task categories

![Violin plot showing distribution of time](./resources/charts/violin.png)

This chart delves deeper into the time spent, to highlight attempts at juggling various types of work. This chart values consistency and makes one-off moments clearer.

Time balancing



This chart helps making comparison with others operating at the target role. This could vary by person and industry, but the area and shape can help you identify if efforts are at least in the right direction.

### Qualitative

The above charts aren't are sure sign of progress but they help you with direction. If business impact is your strongest index, well...? folks should be excited?

**or** the way impact is measured, delivered, defined, etc might be misunderstood. Either way, the chart's job is to provoke thoughts.

There are more blind spots that are unaddressed by a time boxed calendar. The calendar shows what you are working on, what you have noticed. It can't talk about the things

you are missing or avoiding. To help you with that, we will share a simple contract around an emotion journal.