Task Doc Builder 📸📝

Task Doc Builder is a native desktop application and web tool designed for rapid documentation, technical workflow logging, and task report generation. It continuously monitors system clipboard activity, deduplicates screenshots, allows dynamic section structuring, and automatically compiles everything into formatted Microsoft Word (.docx) documents.

---

🌟 Key Features

• 🖥️ Native Desktop GUI: Built with PyWebView for a sleek, standalone desktop experience without requiring a browser window.
• ⚡ Background Clipboard Polling: Monitored clipboard daemon continuously captures fresh images without lagging or throttling the OS.
• 🔍 Smart Deduplication: MD5 hash check on clipboard thumbnails prevents duplicate images from bloating your queue.
• 📝 Dynamic Section & Task Structuring: Add headings, sub-task labels, and descriptions to group screenshots into structured reports.
• 📄 Direct .docx Word Export: Compiles image queues with automatic DPI detection and image scaling (max 6.0 in margins) directly into native Word documents.
• 🌐 Browser / HTTP Server Fallback: Includes fallback scripts to run as a local web server (http.server / npx http-server) if Python desktop bindings are unavailable.

---

🏗️ Tech Stack

• Backend / Desktop Binding: Python 3, PyWebView (webview)
• Document Processing: python-docx
• Image Processing: Pillow (PIL)
• Frontend UI: Single-page HTML5, CSS3, ES6 JavaScript
• Sub-module / UI Components: React 18, Vite, TypeScript, Tailwind CSS (codenest/)

---

🚀 Quick Start

1. Requirements

• Python 3.8+ (Required for Native Desktop App and Word Document export)

2. Install Dependencies

Run the included automated batch installer:

install_dependencies.bat

Or manually install via pip:

pip install pywebview python-docx Pillow

---

💡 How to Use

Launch Option A: Native Desktop App (Recommended)

Double-click Launch.bat or run from terminal:

python app.py

Launch Option B: Browser Mode (Web Server)

Double-click START-TaskDocBuilder.bat to launch the local web server on port 8000:

python -m http.server 8000

---

📂 Project Structure

├── app.py                      # Core PyWebView desktop app & document generator backend
├── task-doc-builder.html       # Main single-page interactive application interface
├── Launch.bat                  # One-click launcher for Native Desktop App
├── START-TaskDocBuilder.bat    # One-click launcher for Browser HTTP Server Mode
├── install_dependencies.bat    # Automated Python dependency setup script
├── codenest/                   # React/Vite UI component container
│   ├── src/                    # TypeScript components (Liquid Glass cards, background effects)
│   ├── package.json            # Node project configuration
│   └── vite.config.ts          # Vite build config
├── .gitignore                  # Git exclusion rules
└── README.md                   # Project documentation

---

📄 License

This project is licensed under the MIT License.