https://github.com/raphaelamonteiro/penguin-time

🐧 A personal time tracking system designed to help users monitor and analyze productivity across daily activities.
https://github.com/raphaelamonteiro/penguin-time

Last synced: 15 days ago
JSON representation

🐧 A personal time tracking system designed to help users monitor and analyze productivity across daily activities.

• Host: GitHub
• URL: https://github.com/raphaelamonteiro/penguin-time
• Owner: raphaelamonteiro
• License: mit
• Created: 2026-06-12T19:39:01.000Z (20 days ago)
• Default Branch: main
• Last Pushed: 2026-06-12T21:25:38.000Z (20 days ago)
• Last Synced: 2026-06-12T23:14:27.125Z (20 days ago)
• Size: 4.88 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 🐧 PenguinTime

A personal time tracking system that helps users monitor and analyze productivity across daily activities.

---

## 🚀 Overview

PenguinTime is a personal productivity tracker designed to help users log time spent on different activities (work, study, projects) and visualize productivity insights through analytics and dashboards.

---

## 📌 Status

In development

---

## 🎯 Features

- Time tracking per activity

- Categories (Work, Study, Projects)

- Daily and weekly reports

- Productivity insights dashboard

- Personalized mascot system (Raul 🐧) that reflects user productivity

---

## 🧠 System

PenguinTime includes an adaptive mascot called **Raul 🐧**, which changes behavior based on user productivity data:

- 🚀 Productive (deep focus sessions)

- 📚 Focused (steady work)

- 😴 Tired (low activity / fatigue)

- 😵 Distracted (frequent task switching)

---

## 🧱 Architecture

Full Python-based application using Streamlit for UI, SQLite/PostgreSQL for storage, and Pandas for data analysis.

---

## 🛠️ Tech Stack

![Python](https://img.shields.io/badge/Python-3776AB?style=for-the-badge&logo=python&logoColor=white)

![Streamlit](https://img.shields.io/badge/Streamlit-FF4B4B?style=for-the-badge&logo=streamlit&logoColor=white)

---

## 📊 Future Improvements

- Advanced analytics pipeline (Big Data concepts)

- Real-time tracking

- Mobile version

- Gamification system for Raul 🐧

---

## 📸 Screenshots

(Add later)

> streamlit run src/app.py