Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wocal — WorkTime Calculator

Status Platform License

Wocal is a cross-platform desktop application designed to track, calculate, and analyze focused work sessions with high precision. It combines offline-first reliability, real-time analytics, and a distraction-free interface to help users maintain deep work consistency.


Link

https://lolakshay.github.io/wocal


Overview

Wocal is built for students, developers, and professionals who need accurate and reliable time tracking. The system ensures that no tracked time is ever lost, even in cases of crashes or unexpected shutdowns.


Core Features

1. Time Tracking Engine

  • Interactive tracking toggle with responsive animation feedback
  • Automatic recovery of active sessions after crashes or forced shutdowns
  • Background system tray integration for quick access and control
  • Audible system cues for session start and stop confirmation
  • Configurable break reminders using OS-level notifications

2. Authentication and Sync

  • Firebase Authentication using Identity Toolkit APIs
  • Intelligent input parsing to prevent login issues
  • Fully functional offline mode with local-first storage
  • Background synchronization with safe merging of cloud and local data
  • One-click permanent account deletion

3. Dashboard and Daily Metrics

  • Real-time display of:
    • Total work time
    • Number of sessions
    • Longest session
  • Goal-based progress bar with dynamic color feedback
  • Streak tracking system for continuous productivity
  • Motivational quote system during idle states

4. Advanced Analytics

  • GitHub-style heatmap showing 24 weeks of activity
  • Calendar navigation (daily / weekly / monthly views)
  • Detailed session breakdown for each day
  • Tagging system for annotating sessions
  • Selective deletion of historical data

5. Data Management

  • Export data as CSV for spreadsheet usage
  • Export complete raw JSON data
  • Local database mapped to user identity
  • Full user ownership and control over stored data

6. User Interface and Experience

  • Smooth transitions using stacked view navigation
  • Hover-based micro-interactions across UI elements
  • Native dark mode with high-contrast visuals
  • Responsive layout that adapts to window resizing

Design Principles

  • Reliability-first architecture
  • Offline-first functionality
  • Minimal and distraction-free interface
  • High-performance background operations
  • Complete data transparency and ownership

Use Cases

  • Deep work tracking
  • Study session monitoring
  • Developer productivity analysis
  • Habit and consistency tracking

License

This project is licensed under the MIT License.


Author

Developed by TGNAS

About

Wocal: A premium, offline-first desktop work tracker with fail-safe session recovery, Firebase cloud sync, and advanced GitHub-style heatmap analytics for granular productivity insights and total data sovereignty.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages