Comma - Your Always-On Desktop Task Manager 📝

A lightweight, always-visible desktop task management application built with Python and PyQt5. Keep your tasks in sight, stay organized, and never miss a deadline.

✨ Key Features

• Always-On-Top Window: Persistent desktop presence for constant task visibility
• Intuitive Task Management: Create, edit, and delete tasks with ease
• Priority System: Organize tasks with Low, Medium, and High priority levels
• Smart Categorization: Group related tasks for better organization
• Theme Support: Switch between Light and Dark modes for comfortable viewing
• Task Statistics: Monitor your productivity with detailed task analytics
• Data Portability: Import and export tasks via JSON format

🚀 Quick Start

Prerequisites

• Python 3.x
• PyQt5
• JSON support (included in Python standard library)

Installation

# 1. Clone the repository
git clone https://github.com/shaayar/comma.git

# 2. Navigate to project directory
cd comma

# 3. Install required packages
pip install -r requirements.txt

# 4. Run the build script
python build_script.py

Running the Application

Find the executable in the dist folder based on your operating system:

• Windows: dist/windows/comma.exe
• macOS: dist/macos/comma.app
• Linux: dist/linux/comma

Move the executable to your preferred location or create a desktop shortcut for easy access.

🎨 Usage

1. Adding Tasks

   • Click the '+' button or use the shortcut Ctrl+N
   • Enter task details, priority, and category
   • Click 'Save' or press Enter

2. Managing Tasks

   • Mark tasks complete with a single click
   • Edit tasks by double-clicking
   • Delete tasks using the 'x' button or Delete key

3. Organization

   • Filter tasks by priority or category
   • Toggle between light and dark themes
   • View task statistics in the dashboard

4. Data Management

   • Export tasks: File → Export → Select location
   • Import tasks: File → Import → Choose file

🛠️ Technical Details

The application is built using:

• Python 3.x for core functionality
• PyQt5 for the graphical interface
• JSON for data storage and portability

System Requirements

• Operating System: Windows 7+, macOS 10.12+, or Linux
• Memory: Minimum 256MB RAM
• Storage: 50MB free space
• Display: 1024x768 minimum resolution

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details on:

• Code style and standards
• Pull request process
• Bug reporting
• Feature suggestions

📄 License

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

🙏 Acknowledgments

• PyQt5 Documentation
• Python Documentation

📞 Support

• Open an issue for bug reports

---

Made with ❤️ by Shubham Dave