Skip to content

Custom plugin for the Obsidian note-taking app. Create a beautiful timeline view of your tasks across your notes. Organize and visualize your tasks based on dates and tags with an interactive timeline that supports custom colors, grouping, and auto-refresh.

License

Notifications You must be signed in to change notification settings

BrandonTrigueros/obsidian-task-timeline-plugin

Repository files navigation

Task Timeline for Obsidian

Create a beautiful timeline view of your tasks across your notes. Organize and visualize your tasks based on dates and tags with an interactive timeline that supports custom colors, grouping, and auto-refresh.

Features

  • Timeline View: Visualize tasks sorted by date and grouped by tag.
  • Calendar View: See tasks in a monthly calendar format for better date-based planning.
  • Custom Date Parsing: Parse dates using a configurable format (default: DD-MMM-YYYY).
  • Task Grouping: Automatically groups tasks by tag with expandable/collapsible groups.
  • Color Customization: Use auto-generated or custom colors for tag groups.
  • Overdue and Reminder Indicators: Display task status (Today, Tomorrow, Overdue, or number of days left).
  • File Navigation: Click a task to open its source file quickly.
  • Auto-Refresh: Timeline updates regularly as your notes change.

How to Use

  1. Formatting Tasks

    Add tasks to your notes using the format: Task description -> DD-MMM-YYYY #Tag

    Examples:

    Write plugin documentation -> 15-Oct-2023 #Work
    Submit report -> 10-Oct-2023 #Finance
    Schedule team meeting -> 20-Oct-2023 #Work #Important

    The task format requires:

    • A description
    • An arrow -> followed by a date
    • Tags with # prefix
  2. Timeline Interaction

    When viewing your timeline, you can:

    Hotkeys & Actions:

    Hotkey Action
    Click on a task Open the source file
    Click on a tag header Expand/Collapse the tag group
    Drag a tag header Reorder tag groups
    Right-click on a tag header Choose a custom tag color

How to Install

From Within Obsidian

  1. Open Settings > Community plugins
  2. Make sure Safe mode is off
  3. Click Browse community plugins
  4. Search for Task Timeline
  5. Click Install
  6. Close the plugins window and enable Task Timeline

Demo

Task Timeline Demo

Support & Contributions

This plugin is provided for free. If you like it or want to support ongoing development, feel free to contribute or donate:

GitHub Sponsors Paypal BuyMeACoffee

Notes

This plugin is still experimental. Please make backups of your notes before using, as bugs might lead to unexpected behavior.


Feel free to file issues or contribute on GitHub:

About

Custom plugin for the Obsidian note-taking app. Create a beautiful timeline view of your tasks across your notes. Organize and visualize your tasks based on dates and tags with an interactive timeline that supports custom colors, grouping, and auto-refresh.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published