Updated README.md
This commit is contained in:
85
README.md
85
README.md
@@ -0,0 +1,85 @@
|
|||||||
|
# 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:
|
||||||
|
```bash
|
||||||
|
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 <20> Community Plugins
|
||||||
|
|
||||||
|
### Quick Package Script
|
||||||
|
|
||||||
|
Use the included batch script to build and package:
|
||||||
|
```bash
|
||||||
|
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:
|
||||||
|
```bash
|
||||||
|
# Install dependencies
|
||||||
|
npm install
|
||||||
|
|
||||||
|
# Development build with watch mode
|
||||||
|
npm run dev
|
||||||
|
|
||||||
|
# Production build
|
||||||
|
npm run build
|
||||||
|
```
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
MIT
|
||||||
|
|||||||
Reference in New Issue
Block a user