TaskWeaver

A simple and elegant task timer plugin for Obsidian with category support and daily note integration.

Features

• Stopwatch Timer - Track time spent on tasks with persistent timers that survive app restarts and sleep mode
• Category Management - Organize tasks with color-coded categories and emoji support
• Visual Category Selection - Click to select categories with intuitive card-based UI
• Active Timer Display - Large, prominent timer view when a task is running
• Daily Note Integration - Automatically log completed tasks to your daily note using Obsidian's Daily Notes plugin
• Customizable Format - Configure how tasks are logged with placeholders for title, duration, emoji, and category
• Theme Aware - Fully respects Obsidian's theming system for seamless integration

Design

• Sidebar Optimized - Designed to work perfectly in Obsidian's sidebar
• Clean UI - Minimal, intuitive interface that doesn't get in your way
• Color Picker - Visual color selection with 12 preset colors plus custom color support
• Polished Timer Controls - Dedicated Pause, Stop, and Complete buttons with color-coded states
• Task States - Clear visual indicators for running, paused, and completed tasks

Installation

Manual Installation

1. Build the plugin:

   npm install
   npm run build
   

2. Copy the built files to your vault:

   • Copy main.js, manifest.json, and styles.css to:
   • <your-vault>/.obsidian/plugins/taskweaver/

3. Reload Obsidian and enable the plugin in Settings ’ Community Plugins

Quick Package Script

Use the included batch script to build and package:

build-package.bat

This creates a taskweaver-package folder with all required files ready to install.

Usage

1. Create Categories - Click "Categories" to add task categories with colors and emojis
2. Add Tasks - Click "Add Task" and select a category
3. Start Timer - Click "Start" on any task to begin tracking time
4. Manage Active Task - Use Pause, Stop, or Complete buttons on the active timer
5. Daily Note Logging - Enable in settings to automatically log completed tasks

Settings

• Enable Daily Note Logging - Toggle automatic logging to daily notes
• Daily Note Format - Customize log format using placeholders:
  • {{title}} - Task title
  • {{duration}} - Time spent
  • {{emoji}} - Category emoji
  • {{category}} - Category name

Building

Requirements:

• Node.js
• npm

Build commands:

# Install dependencies
npm install

# Development build with watch mode
npm run dev

# Production build
npm run build

License

MIT