Skip to content

ejwells0/purrductivity

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

56 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Purrductivity

A cat-themed macOS menu-bar productivity app. Cats live in your menu bar, remind you about your tasks, and nag you (adorably) when you snooze them.

Features

  • Recurring reminders: daily, weekly, monthly, quarterly, or one-time
  • Snooze with escalating cat popup reminders
  • Weekly and quarterly goal tracking with on-track / behind status
  • EOS-style "rock report" export
  • Menu-bar badge showing what's due

Requirements

  • macOS only (uses the native menu bar via rumps/pyobjc)
  • Python 3.13+

Install & Run

pip install -r requirements.txt
python main.py

Architecture

Two-process design: rumps owns the main thread of the main process (a macOS requirement for menu-bar apps), while the Tkinter UI runs in a spawned child process, communicating over multiprocessing.Queue. Scheduling is handled by APScheduler; tasks persist in TinyDB (JSON) at data/tasks.db.

Tests

pytest

License

MIT — see LICENSE.

Credits

Cat artwork was generated for this project and is covered by the repository's MIT license.

About

Cat-themed macOS menu-bar productivity app — reminders, goal tracking, and nagging cats (Python, rumps + Tkinter)

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages