Skip to content

Comprehensive task and note management with calendar integration for Obsidian

License

Notifications You must be signed in to change notification settings

okmango/tasknotes

 
 

Repository files navigation

TaskNotes for Obsidian

A task and note management plugin with calendar views and daily notes.

Downloads Screenshot of biblib Obsidian plugin

Rationale

TaskNotes uses YAML frontmatter to store task data, providing several benefits. YAML is a standard format compatible with many tools, ensuring long-term data stability in line with Obsidian's file-over-app philosophy. The frontmatter approach makes it trivial to add custom fields like "assigned-to" or "attachments" that integrate seamlessly with other tools like Obsidian Bases. This extensibility has made it easy to add features like time-tracking, which would be difficult to implement cleanly in other task formats. The one-note-per-task approach enables you to add unstructured content in the note body for descriptions and progress notes. Each task becomes a full participant in your knowledge graph, leveraging native Obsidian features like backlinking and graph visualization. This creates a complete history and context for every task in one place.

Core Features

Task Management

  • Individual Markdown files with YAML frontmatter
  • Properties: title, status, priority, due date, scheduled date, contexts, tags, time estimates
  • Recurring tasks with per-date completion tracking
  • Time tracking with multiple sessions per task
  • Archive functionality using tags
  • Advanced filtering and grouping options

Calendar Integration

  • Month view with task and note display
  • Mini calendar for compact layouts
  • ICS/iCal subscription support
  • Direct navigation to daily notes

Time Management

  • Built-in time tracking with start/stop functionality
  • Pomodoro timer with task integration
  • Session history and statistics

Editor Integration

  • Interactive task previews on wikilinks
  • One-click checkbox-to-task conversion
  • Template support with parent note context

Views

  • Calendar: Month view with agenda
  • Task List: Filtering and grouping
  • Kanban: Drag-and-drop task management
  • Agenda: Daily task and note overview
  • Notes: Date-based note browser
  • Pomodoro: Timer with statistics

Configuration

Customization

  • Field Mapping: Customize YAML property names to match existing workflows
  • Custom Statuses: Define task statuses with colors and completion behavior
  • Custom Priorities: Create priority levels with weight-based sorting
  • Templates: Configure daily note templates with Obsidian variables

YAML Structure

Task Example

title: "Complete documentation"
status: "in-progress"
due: "2024-01-20"
priority: "high"
contexts: ["work"]
timeEstimate: 120
timeEntries:
  - startTime: "2024-01-15T10:30:00"
    endTime: "2024-01-15T11:15:00"

Recurring Task

title: "Weekly meeting"
recurrence:
  frequency: "weekly"
  days_of_week: ["mon"]
complete_instances: ["2024-01-08"]

Credits

This plugin uses FullCalendar.io for its calendar components.

License

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

About

Comprehensive task and note management with calendar integration for Obsidian

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 73.7%
  • CSS 25.3%
  • JavaScript 1.0%