A calendar view plugin for Obsidian that displays tasks from Kanban boards with dates and times in a beautiful calendar interface.
- Multiple Calendar Views: Week, Month, and Year views
- Kanban Integration: Automatically parses tasks from Kanban board markdown files
- Date & Time Support: Displays tasks with dates (
@{YYYY-MM-DD}) and optional times (@@{HH:MM}) - Tag Support: Shows task tags with color-coded labels
- Task Details: Click on tasks to view detailed information in a modal
- File Navigation: Click on tasks to open the source Kanban board file
- Theme Integration: Seamlessly integrates with Obsidian's light and dark themes
- Responsive Design: Works on desktop and mobile devices
- Download the latest release from the GitHub releases page
- Extract the files to your Obsidian vault's plugins folder:
VaultFolder/.obsidian/plugins/kanban-calendar/ - Reload Obsidian
- Enable the plugin in Settings → Community Plugins
-
Clone this repository into your vault's plugins folder:
cd VaultFolder/.obsidian/plugins/ git clone https://github.com/yourusername/obsidian-kanban-calendar.git cd obsidian-kanban-calendar
-
Install dependencies and build:
npm install npm run build
-
Reload Obsidian and enable the plugin
The plugin reads tasks from markdown files that follow this format:
## Doing
- [ ] **Task with date**
#tag1 #tag2 @{2025-06-15}
- [ ] **Task with date and time**
#urgent @{2025-06-16} @@{14:30}
- [x] **Completed task**
@{2025-06-14}
## To Do
- [ ] **Another task**
@{2025-06-20}- Dates: Use
@{YYYY-MM-DD}format - Times: Use
@@{HH:MM}format (24-hour) - Tags: Use standard hashtag format
#tagname
- Click the calendar icon in the ribbon
- Use the command palette: "Open Kanban Calendar"
- Use the hotkey (if configured)
Access plugin settings through Settings → Plugin Options → Kanban Calendar:
- Default Kanban Board: Specify a default file to read tasks from (leave empty to scan all files)
- Default Calendar View: Choose between Week, Month, or Year view
- Show Completed Tasks: Toggle visibility of completed tasks
- Date Format: Configure the date format used in your Kanban boards
├── main.ts # Main plugin class
├── calendar-view.ts # Obsidian view integration
├── calendar-component.tsx # React calendar component
├── kanban-parser.ts # Kanban board parser
├── types.ts # TypeScript type definitions
├── styles.css # Plugin styles
├── manifest.json # Plugin manifest
├── package.json # Dependencies
├── tsconfig.json # TypeScript configuration
└── esbuild.config.mjs # Build configuration
# Development build with watch mode
npm run dev
# Production build
npm run build- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
- Obsidian: Requires Obsidian v0.15.0 or higher
- Platforms: Desktop and mobile
- Themes: Compatible with all Obsidian themes
MIT License - see LICENSE file for details
If you encounter any issues or have feature requests, please:
- Check the existing issues on GitHub
- Create a new issue with detailed information
- Include your Obsidian version and plugin version
- Drag & drop to reschedule tasks
- Recurring task support
- Calendar export functionality
- Integration with other task management plugins
- Custom date formats
- Task filtering and search
- Built with React and TypeScript
- Uses Obsidian's plugin API
- Inspired by the Kanban plugin by mgmeyers