marcodifrancesco / calendaranalyzer

Dashboard to visualize your Google Calendar events.

Welcome to Calendar Analyzer 👋

Your Life, Visualized.

Visualize Google Calendar events in an Interactive Dashboard.

Includes 3 years of data, collected every 30 minutes.

👁️ Preview

Preview hosted in a 1GB Raspberry Pi, be kind to it ❤️

Preview not available for now, but you can stil run it on your own. Check out the next section :)

🚀 Usage

Run with 3 years of sample data provided.

Prerequisites: Python 3.10

1. Clone repository

git clone https://github.com/MarcoDiFrancesco/CalendarAnalyzer.git
cd CalendarAnalyzer

2. (Optional) Create Virtual Environment

python3.10 -m venv .venv
source .venv/bin/activate

3. Install Python packages

pip install wheel
pip install -r requirements.txt

4. Source environment variables (e.g. calendar links)

source .envvars.sample

5. Run Dashboard

streamlit run app.py

6. Now open the Dashboard → http://localhost:8501

FAQ

🚉 Which platform you collect data with? Google Calendar.

⬇️ How do you download data from Google Calendar? Instructions in the Wiki page Get calendar link.

📜 Which categories do you use? List of activities e.g. Study, Sport; can be found in the Wiki page Categorization.

❓ Why these categories? Can be found in Wiki page Categorization rules.

🖼️ How does code structure looks like? Nobody wants to know, but still looks amazing, just look Wiki page Extra.