Gantt Calendar

简体中文

Screenshots

Year View

Gantt View

Week Timeline View

Sidebar View (Task List + Daily Timeline)

Day View with Embedded Editor

Installation

Via BRAT

1. Install and enable the community plugin BRAT
2. Run the command BRAT: Add a beta plugin for testing
3. Enter the repository URL: https://github.com/sustcsugar/obsidian-gantt-calendar

Manual

1. Download the latest Release
2. Extract and copy the folder to <your-vault>/.obsidian/plugins/
3. Restart Obsidian and enable the plugin in Settings

Quick Start

Open the View

• Click the sidebar icon to open the main calendar view
• Use the view switcher in the toolbar to switch between views

Create Tasks

Use the Add Task button in the toolbar, or manually write tasks in any Markdown file:

- [ ] 🎯 Complete project documentation 📅 2025-12-20

Refresh the plugin and the task will appear in the calendar and task list.

Features

Layout

The plugin uses a toolbar + content area layout:

• Toolbar Left — View switcher (6 views)
• Toolbar Center — Current date range / title
• Toolbar Right — Functional buttons (navigation, sort, filter, add task, etc.)

Task Formats

Tasks Plugin Format (Emoji)

- [ ] 🎯 Complete project documentation ⏫ ➕ 2025-01-10 📅 2025-01-15

Dataview Plugin Format (Inline Fields)

- [ ] 🎯 Complete project documentation [priority:: high] [created:: 2025-01-10] [due:: 2025-01-15]

Time Precision

• Date: YYYY-MM-DD (e.g., 2026-04-27)
• Time: YYYY-MM-DD HH:mm (e.g., 2026-04-27 14:00)
• Tasks with time automatically display in timeline layout

Recurring Task Syntax

🔁 every day              # Every day
🔁 every 3 days           # Every 3 days
🔁 every week on Monday   # Every Monday
🔁 every month on 15      # Every month on the 15th
🔁 every year on 01-01    # Every year on Jan 1
🔁 every weekday          # Every weekday
🔁 when done              # Restart after completion

Year View

• Year Overview — 12 month cards showing full-year task distribution
• Task Heatmap — 5-level color gradient for task density
  • 8 palette options: blue / green / red / purple / orange / cyan / pink / yellow
  • 3D heatmap effect (off / slight / prominent)
• Responsive Layout — Auto-switches between 4×3 / 3×4 / 2×6 / 1×12 grids
• Task Count — Optional per-day task total display
• Lunar Calendar — Chinese lunar dates in month cards
• Click Navigation — Click a date to switch to Day View

Month View

• Monthly Calendar — Standard month grid layout with daily tasks
• Week Numbers — ISO week numbers shown in the first column
• Task Display Limit — Configurable per-day task count (1–10) with "+N more" overflow
• Task Popup — Click a date to view all tasks for that day
• Festival Display — Solar/lunar/solar-term festivals with distinct colors
• Drag & Drop — Drag task cards between days to reschedule
• Recurring Tasks — Virtual instances for repeating tasks
• Week Start — Configurable Monday or Sunday start

Week View

• Dual Mode Layout
  • List Mode — When no timed tasks exist, displays 7-column card layout
  • Timeline Mode — When timed tasks are detected, shows 24-hour vertical time grid with 7 days side by side
• Today Highlight — Current day is visually emphasized
• Navigation — Previous week / This week / Next week
• Drag & Drop — Drag tasks to any day or hour slot
• Quick Create — Hover over empty time slots to reveal "+" button for fast task creation
• Current Time Indicator — Red line marking the current time
• Lunar Info — Lunar dates and festivals in day headers

Day View

• Task List — Detailed view of all tasks for the selected day
• Timeline Layout — When timed tasks exist, renders 0:00–23:00 time grid with tasks positioned at their hours
• Drag & Drop — Drag tasks to any hour slot to adjust time
• Quick Create — Hover over empty slots for "+" quick-create button
• Current Time Indicator — Red line at the current time
• Daily Note Integration
  • Embedded full editor (WorkspaceSplit mode)
  • Edit / Preview mode toggle
  • Auto-loads daily note for the selected date
  • Supports Obsidian core daily notes, Periodic Notes plugin, and custom paths
• Resizable Split — Draggable divider between task and note panes (horizontal or vertical layout)
• Lunar Info Bar — Lunar date, festivals, and solar terms

Task View

• Task List — Centralized display of all tasks
• Date Range Filter — All / Today / This Week / This Month / Custom range
• Time Field Selector — Filter by any of 6 date fields
• Multi-dimensional Filtering — Status, priority, and tags (AND/OR/NOT operators)
• Sorting — 7 sort fields with asc/desc toggle
• Persistent State — Filter and sort settings persist across refreshes

Gantt View

• Interactive Gantt Bars — Custom SVG rendering engine
  • Drag entire bar to shift dates
  • Drag endpoints to adjust start/end dates
  • Drag to change progress percentage
  • Click to open task edit modal
• Navigation — Jump to today / scroll left / scroll right
• Incremental Refresh — Smart update strategy to avoid full redraws
• Tag & Status Filtering — Filter gantt bars by tags and status
• Configurable Fields — Choose which date fields map to gantt start/end

Sidebar View

Two-tab sidebar for quick task access:

Task List Tab

• Keyword search (debounced)
• Multi-dimensional filters: status, priority, tags (OR/AND), date range
• Sort by: priority / due date / start date
• Click task to navigate to source file

Daily Timeline Tab

• 24-hour timeline for today's timed tasks
• All-day task section
• Current time indicator line
• Drag & drop to adjust time
• Quick create on empty slots

Context Menu

Right-click any task for:

• Edit Task — Full edit modal (description, priority, dates, repeat, tags)
• Create Note — Generate a wiki-linked note from the task (same name or alias)
• Set Priority — 6 levels: highest / high / medium / normal / low / lowest
• Set Status — Custom statuses (important, question)
• Postpone — Delay 1/3/7 days (from due date or from today)
• Cancel / Restore — Toggle cancelled state
• Delete — Remove task from markdown file

Feishu (Lark) Sync

• Bidirectional Sync — Push local tasks to Feishu and pull Feishu tasks to Obsidian
• OAuth 2.0 — Secure authentication with automatic token refresh
• Push Filters — Filter by file paths, completion status, and date
• Conflict Resolution — Multiple strategies: local-wins, remote-wins, newest-wins, manual
• Auto Sync — Configurable automatic sync interval
• Sync Result Modal — Detailed per-task sync results with statistics

Roadmap

Task Parsing

• Tasks and Dataview dual-format parsing
• Global filter markers
• Task tags
• Task description
• 6 priority levels
• 6 date fields with time precision (HH:mm)
• Recurring task recognition and display
• Nested tag recognition
• Multi-line task recognition
• Sub-task recognition
• Task dependency relationships

Views

• Day View with Daily Note integration (embedded editor)
• Day View timeline layout
• Week View dual mode (list + timeline)
• Week/Month View drag & drop
• Year View heatmap and task count
• Task View (multi-dimensional filter + date range)
• Gantt View (drag + incremental refresh + navigation)
• Sidebar View (task list + daily timeline)

Toolbar

• View switcher
• Tag / status / priority filtering
• Date navigation buttons
• Time field selector
• Add task button

Interactions

• Task cards (description, tags, priority)
• Context menu (edit, create note, priority, status, postpone, cancel, delete)
• Hover tooltips
• Quick create on empty time slots

Future Plans (v2.0.0)

• Third-party calendar subscription (Feishu Calendar, Outlook Calendar)
• Microsoft To Do sync
• Google / Apple Calendar via CalDAV

Contributing

Issues and Pull Requests are welcome!

License

MIT