Pomo-Tracker

A modern, intuitive Pomodoro timer & productivity tracker with rich statistics and Discord presence.

_{Windows (Microsoft Store & Executable) ⋅ Linux (AUR, AppImage, Executable) ⋅ macOS (Executable)}

Overview

• Pomo-Tracker is a yet another productivity app. While it doesn't try to hold your hand it does try giving you the opportunity to join hands with friends on the journey.
  • Some useful tools to aid that
    • Generally:
      • Custom timers Ranging from 5mins to 8hrs
      • Stopwatch modes for sessions where you just want to work without a set time in mind
      • Comprehensive productivity tracking for actually informative graphs and other tracking
        • Subjects, Sub-Subjects, Accountability Management & Tracking
      • Desktop Companion a cleans simple way to manage the timer without actually having to open it
      • Desktop Tickets keep a clean note of things to do...or things you've done as you work.
      • Scheduler the ability to plan your days but also see them as they've gone by
    • Socially:
      • Discord Rich Presence so your other friends can see your grind
      • Feed Platform to provide the ability to keep up with friends on studies/study habits and their stats.
        • See friend activity
        • Rankings to compete with your friends
      • Cross-Platform Stats Syncing between other clients (desktop, mobile)
      • Group Study Sessions & Quizzes

with more ideas & features to come! A lot of these features are still on the way though as a disclaimer. See the Roadmap below for details.

---

Screenshots

More Screenshots

Discord Rich Presence

Other Hero Images

Installation

This project is under active development, and features are subject to change. If you find bugs/issues, kindly raise an issue with the bug or feature tag.

Platform	Distribution Method	Quick Link / Command
Windows	Microsoft Store
Windows, Linux, macOS	GitHub Releases	Download Latest Binaries
Arch Linux	AUR (pomo-tracker-bin)	paru -S pomo-tracker-bin or yay -S pomo-tracker-bin

Arch Linux (AUR) Detailed Guide

You can install pomo-tracker-bin from the Arch User Repository using an AUR helper:

# Using paru
paru -S pomo-tracker-bin

# Using yay
yay -S pomo-tracker-bin

Manual Installation

If you prefer building manually without an AUR helper:

git clone https://aur.archlinux.org/pomo-tracker-bin.git
cd pomo-tracker-bin
makepkg -si

Roadmap

timeline
    title Pomo-Tracker Roadmap
    v0.3.0 Polish and Stronger Foundation : Fully functional mobile build
                                 : Desktop notifications and pause alerts
                                 : More stats features (streaks, heatmap hover)
                                 : List completed tasks in a session
                                 : Bug Fixes
                                 : Quality of Life
    v0.4.0 Desktop Companion     : Deskmate mini-timer window
                                 : Floating desktop ticket widget
                                 : Centralized settings page
                                 : State-listener architecture refactor
                                 : Consider untracked time
    v0.5.0 Advanced Tracking     : Macro buttons per subject
                                 : Nested sub-subjects and archiving
                                 : Comparative stats and target lines
                                 : Auto-continue break detection
    v0.6.0 Productivity Hub      : First-time onboarding flow
                                 : Modular home and timer widgets
                                 : Built-in scheduler page
	Uncertain 					           : Cross-platform Sync
								                 : Full Feed Page
																 : Play Store release
																 : Custom themes
																 : Group Study Sessions & Quizzes

Loading

Technologies Used

• Flet: GUI
• Python: The Core Language
• SQLite: Local Database for Stats and Settings
• pypresence: Discord RPC
• Subject Icons Images: Undraw Open Source Illustrations

License

This project is licensed under the MIT License - see the LICENSE file for details.