⚡ Focus Task

A productivity plugin for Obsidian that combines task management with focused time tracking, heavily inspired by Blitzit.

Features

🎯 Task Management

• Create tasks with time estimates
• Organize tasks into customizable lists (Work, Personal, Learning, etc.)
• Track actual time spent vs. estimated time
• Filter tasks by list, status, or date

🍅 Pomodoro Timer

• Built-in Pomodoro technique support
• Configurable work sessions (default: 25 minutes)
• Short and long breaks
• Auto-start breaks option
• Visual progress indicator

⏱️ Stopwatch Mode

• Free-form time tracking without Pomodoro constraints
• Alerts when exceeding time estimates

📊 Statistics

• Daily completed tasks counter
• Total focus time tracking
• Streak tracking for consecutive productive days
• Pomodoro completion count

📝 Daily Note Integration

• Automatically log completed tasks to your daily note
• Customizable date format and section heading
• Tracks time spent vs. estimated time

🎉 Celebrations & Feedback

• Celebration messages on task completion
• Sound notifications (optional)
• Visual feedback for early/late completions

Installation

Manual Installation

1. Download the latest release from the releases page
2. Extract the files into your vault's .obsidian/plugins/focus-task/ folder
3. Reload Obsidian
4. Enable the plugin in Settings → Community Plugins

From Source

1. Clone this repository into your vault's .obsidian/plugins/ folder
2. Run npm install to install dependencies
3. Run npm run build to compile the plugin
4. Reload Obsidian and enable the plugin

Usage

Opening Focus Task

• Click the ⚡ icon in the ribbon (left sidebar)
• Use the command palette: "Open Focus Task Panel"

Adding Tasks

• Click "+ Add Task" in the panel
• Use the command palette: "Quick Add Task"
• Set a time estimate and assign to a list

Starting a Focus Session

• Pomodoro Mode (▶): Click the play button on a task to start a timed Pomodoro session
• Stopwatch Mode (⏱): Click the stopwatch icon to track time freely

Keyboard Shortcuts

You can assign hotkeys to these commands in Settings → Hotkeys:

• Focus Task: Open Focus Task Panel
• Focus Task: Quick Add Task
• Focus Task: Toggle Timer (Play/Pause)
• Focus Task: Complete Current Task
• Focus Task: Start Focus Mode on Next Task

Settings

Pomodoro Timer

• Work Duration: Length of work sessions (5-60 minutes)
• Short Break: Length of short breaks (1-15 minutes)
• Long Break: Length of long breaks (5-30 minutes)
• Long Break Interval: Pomodoros before a long break

General

• Default Time Estimate: Default estimate for new tasks
• Enable Sounds: Toggle sound notifications
• Enable Celebrations: Toggle celebration messages

Daily Note Integration

• Log completed tasks: Enable/disable daily note logging
• Filename format: Set your daily note naming convention (YYYY-MM-DD)
• Section heading: Customize the heading for logged tasks

Lists

• Create custom lists with names, icons, and colors
• Default lists: Work, Personal, Learning

Credits

This plugin is heavily inspired by Blitzit, a fantastic productivity app. Focus Task brings similar functionality directly into Obsidian.

License

MIT License - see LICENSE for details.

Support

• Report Issues
• Source Code