Calendar Period Week Notes

Obsidian Calendar Period Week Notes

A powerhouse daily and weekly planning plugin for Obsidian which combines a highly customizable calendar with an integrated tabbed interface for your scratchpad, recent notes, tasks, assets and a dashboard containing a number of widgets giving you a complete overview of your vault at a glance.

Move beyond simple daily notes with a unique Period/Week system for those who have their financial year mapped out over 13 periods of 4 weeks, (or simply use the standard calendar week numbering), interactive popups, and a deeply integrated task manager.

The main calendar grid with period / week column, dot indicators, and heat map for the number of tasks for a date.

The vertical calendar grid which allows you to scroll up and down to see previous dates and forward dates up to the next year.

The main interface showing in light appearance with the calendar week column, heat map for tasks, and the integrated tab buttons for Tasks, ScratchPad, Pinned Notes and Assets.

The Themes settings tab provides the ability to view different themes in light and dark app appearances and then apply with one click. Navigate up and down the different themes with the arrow keys and left / right to toggle between light and dark appearance.

Some of the available 16 themes or make your own theme and share with others from the plugin settings.

NEW: Dashboard Task Tab showing summary and heatmap of tasks acrosss your notes.

NEW: Dashboard Task custom widget chart examples that can be configured: kpi stat widgets, cumulative line chart to track task completion/project completion which can be based on tag. Radar completion chart, pie chart and simple line chart examples. Create your own with style with colours, show hide legends, show hide toggles, show / hide chart titles and even create section headers to group charts - which you can easily show / hide by clicking the widget name or chevron. Easily order in the settings too by dragging and dropping where you want a widget displayed. Five widget sizes to choose from all based on widget and height: quarter, third, half, full and full tall.

NEW: Dashboard File Creation Tab showing summary and heatmap of files acrosss your vault.

NEW: Dashboard Custom Heatmaps - create your own configurable heatmaps with powerful filters in the new Dashboard Settings area.

NEW: Dashboard Custom Heatmaps - example of a custom heatmap showing in the Dashboard tab.

NEW: Set your goals with 15 levels to achieve.

---

Calendar Period Week Notes

A powerful calendar and dashboard system for Obsidian, designed for deep customization and integration with your notes, tasks, and files. It combines a dynamic calendar with a configurable dashboard featuring task summaries, file creation heatmaps, and much more.

---

✨ Features

📊 The All-New Dashboard

The plugin now features a powerful, customizable dashboard grid that can be switched between two primary modes by clicking its tab. All widgets are collapsible and their order can be rearranged via drag-and-drop in the settings.

• Two Main Views:
  • Tasks Dashboard: Get an at-a-glance overview of your productivity.
  • Creation Dashboard: Visualize your note and file creation activity over time.
• Tasks Dashboard Widgets:
  • Task Summary Widgets: See summaries for Today, Tomorrow, Next 7 Days, and Future & No Due Date, with progress bars showing Incomplete, In-Progress, Completed, and Overdue tasks.
  • Mini & Collapsed States: Click the header to collapse a widget, or use the toggle to switch to a compact "mini" view.
  • Weekly/Monthly Task Metrics: View bar charts summarizing task completion and creation over the current week and month.
• Creation Dashboard Widgets:
  • Custom Heatmaps: Create an unlimited number of personalized heatmap widgets to track file activity. Each heatmap is deeply configurable:
    • Date Source: Track files by creation date or by a date in the note title.
    • Custom Filters: Combine multiple rules (tag, filename, path, filetype) using AND/OR logic.
    • Date Range: Set custom time windows using "Months Back" and "Months Forward" fields.
    • Color & Links: Assign a unique color and link the widget's total count to a summary note.
    • Debug Mode: A special mode to help you troubleshoot your filter rules.
  • All Files Heatmap: A default widget that shows all note and asset creation activity across your vault.

🗓️ Dynamic Calendar View

• Dual Calendar Layouts: Instantly switch between a traditional monthly grid and a continuous vertical scroll view by clicking the month title.
• Enhanced Mobile Experience:
  • Swipe Gestures: Intuitively swipe up on the grid to collapse it, swipe down on the header to expand it, and swipe down on the grid itself to switch to the vertical view.
  • Optimized Interaction: On mobile, long-press a date to open the details popup and tap the date to open the daily note. The calendar also auto-collapses when you focus a search bar to maximize screen space.
• Custom Period/Week System: Structure your year with a 13-period, 4-week system. Set your own start date for P1W1.
• Flexible Week Start: Choose either Sunday or Monday as the first day of the week.
• At-a-Glance Dot Indicators: See daily activity with fully customizable colored dots for daily notes, weekly notes, new/modified notes, new assets, and external calendar events.
• Task & Event Indicators: Visualize your workload with multiple styles:
  • Badge: A numerical count of open tasks/events.
  • Heatmap: The cell background color changes based on the number of tasks/events.
  • Dot: A single, customizable dot.
  • Custom Task Statuses: Go beyond [x]. Use symbols like / (in-progress), > (forwarded), ! (important), or ? (questions), all with customizable icons.
• Advanced Highlighting: Customize highlighting for the current week row, day column on hover, or use the Complex mode to highlight both the row and column up to the hovered date.
• Weekly Notes: Create and manage weekly notes with customizable naming formats, template support, and a dot indicator on the week number.

Please Note: For the calendar event dots you may (optionally in the plugin settings) set up to fetch over the internet the calendar event information you wish to see / view on the caleandar grid and popup window.

🧩 Integrated & Draggable Tab Panels

A powerful set of panels located below the calendar. All tabs can be reordered via drag-and-drop.

• 📊 Dashboard Tab: The entry point to the new dashboard system. Click the tab while it's active to toggle between the Tasks and Creation dashboard views.
• 📝 Scratchpad Tab:
  • Toggle between edit and Markdown preview mode.
  • Quickly add tasks using a customizable format with dynamic date placeholders ({today}, {friday}).
  • Shift-click the tab to open the scratchpad file in a full editor tab.
• 📂 Notes & Pinned Tab:
  • Click the tab to toggle between "Recent" and "Pinned" mode.
  • Pinned Mode: Shows notes with a specific tag (e.g., #pin).
  • Custom Drag-and-Drop Sorting: Activate a custom sort order and reorder pinned notes by holding Alt/Option.
  • Right-Click Popups: Choose to trigger popups on right-click (or long-press on mobile) instead of hover.
• ✔️ Tasks Tab:
  • Group tasks by due date (Overdue, Today...) or by #tag. Toggle the grouping method by clicking the tab.
  • Animated Groups: Task groups smoothly expand and collapse.
  • Check off tasks directly from the list to update the source file instantly.
• 🖼️ Assets Tab:
  • Toggle between list and grid view by clicking the tab.
  • Unused Asset Indicator: An icon highlights assets not linked from any note.
  • Backlinks Popup: Hover over an asset's icon to see all notes that link to it.

🎨 Powerful Theming & Deep Customization

• 16 Pre-built Themes: Instantly change the look and feel with a diverse collection of themes.
• Total Customization: Every color, font, icon, and size is customizable through the settings.
• Import/Export: Save and load your complete plugin configuration or just your theme colors to a JSON file.
• Draggable Order: Reorder tabs and dashboard widgets to create your perfect layout.
• Visibility Toggles: Hide any tab or dashboard widget you don't use.
• Custom Icons: Change the icons for tabs and task groups to any Lucide icon name.

---

🚀 Installation

From Community Plugins

1. Open Settings > Community Plugins.
2. Make sure "Restricted mode" is off.
3. Click Browse and search for "Calendar Period Week Notes".
4. Click Install, then Enable.

Manual Installation

1. Download the zip file containing the main.js, manifest.json and Theme files from the latest GitHub release.
2. Create a new folder named Calendar Period Week Notes inside your vault's plugin folder: <VaultFolder>/.obsidian/plugins/, (you may need to show hidden files for your operating system to view this)
3. Copy the downloaded files into this new folder.
4. Reload Obsidian, then go to Settings > Community Plugins and enable it.

The folder structure should be:

<VaultFolder>/.obsidian/plugins/Calendar Period Week Notes/
├── main.js 
├── manifest.json
├── styles.css

---

💡 How to Use

1. Open the View: Click the 📅 icon in the left ribbon or use the command palette (Ctrl/Cmd + P).
2. Navigate the Calendar:
   • On desktop, click a date to open its daily note. On mobile, tap a date.
   • On desktop, hover a date to see the details popup. On mobile, long-press the date.
   • Click the month title (e.g., "October 2025") to switch between monthly and vertical views.
   • On mobile, swipe up on the grid to collapse it or swipe down on the header to expand it.
3. Use the Tabs:
   • Click a tab to switch panels. Drag and drop tabs to reorder them.
   • Click a tab that is already active for special functions:
     • Dashboard Tab: Toggles between the Tasks and Creation dashboards.
     • Scratchpad Tab: (Shift-click) Opens the scratchpad file in a new editor.
     • Notes Tab: Toggles between "Recent" and "Pinned" views.
     • Tasks Tab: Toggles grouping between "Date" and "Tag".
     • Assets Tab: Toggles between grid and list view.
4. Reorder Pinned Notes: In the Pinned Notes view, set the sort order to Custom. Then, hold Alt (Windows/Linux) or Option (macOS) and drag notes.

---

🔧 Settings

The plugin offers extensive options organized into the following tabs.

General Display

Calendar Functional

Popup Indicators

Dot Indicators

Weekly Notes

Task Indicators

Dashboard

General Tabs

ScratchPad Tab

Notes Tab

Pinned Notes Tab

Assets Tab

Tasks Tab

Import & Export

---

❤️ Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the GitHub issues page.

Buy me a coffee

📄 License

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