Skip to main content

Welcome to Periodix-Planner

Time is your scarcest resource — and the hardest one to “optimize” because you can’t get more of it.

Periodix-Planner turns your Obsidian vault into a time-aware planning system. It automatically generates and connects periodic notes (daily → yearly) and adds a structured way to plan time investments, not just tasks.

🎯 What is Periodix-Planner?​

Most planning systems focus on output (“What did I get done?”). Periodix-Planner focuses on inputs (“What am I spending my time on?”).

This plugin is not a task manager. Tasks are result-oriented. Periodix-Planner is time-oriented.

The core idea is to treat time like a finite investment portfolio:

  • Allocate hours into categories (work, learning, health, relationships, projects)
  • Observe where time actually goes over days/weeks/months
  • Decide whether those investments are worth the returns you’re getting

Periodix-Planner combines:

  • 📅 Automatic Periodic Note Generation - Creates notes for each time period automatically
  • 🔗 Interconnected Note Web - Links notes hierarchically through frontmatter properties
  • ⏱️ Time Budget System - Allocate and track time across categories with visual feedback
  • 📊 Visual Statistics - Pie charts and tables showing time allocation and budget status
  • 🎨 Category Management - Organize your time investments with custom categories and colors

✨ Key Features​

Automatic Note Generation​

The plugin automatically creates notes for each time period, always staying one step ahead by generating the next period's note in advance:

  • Daily notes → Generated for today and tomorrow
  • Weekly notes → Generated for this week and next
  • Monthly notes → Generated for this month and next
  • Quarterly notes → Generated for this quarter and next
  • Yearly notes → Generated for this year and next

Hierarchical Time Structure​

All notes are linked through frontmatter properties, creating a navigable web of time:

---
# Daily Note Example (2025-01-15)
Previous: "[[2025-01-14]]"
Next: "[[2025-01-16]]"
Week: "[[2025-W03]]"
Month: "[[2025-01]]"
Quarter: "[[2025-Q1]]"
Year: "[[2025]]"
Hours Available: 24
---

Time Budgeting​

Time budgets flow through your periods so trade-offs become obvious:

  • Yearly → Define total category budgets
  • Quarterly → Allocate portions of yearly budgets (plugin tracks remaining)
  • Monthly → Allocate from quarterly budgets
  • Weekly → Allocate from monthly budgets
  • Daily → See available time and track actuals

Visual Feedback​

  • 🟢 Within budget → Green indicators
  • 🟡 Approaching limit → Yellow warnings
  • 🔴 Over budget → Red alerts with clear messaging

Complements task managers (doesn’t replace them)​

Tasks help you execute.

Periodix-Planner helps you decide what deserves your time in the first place.

🎬 Video Walkthrough​

Watch the full feature breakdown on YouTube to see Periodix-Planner in action.

📸 Screenshots​

Check out the Screenshots Gallery to see all plugin visuals and features in action.

🚀 Quick Start​

  1. Install the plugin from Obsidian Community Plugins or BRAT
  2. Configure your folder structure and naming preferences in settings
  3. Set up your time budget categories
  4. Generate your first set of periodic notes
  5. Allocate time using the interactive allocation editor

See the Installation Guide and Quick Start Guide for detailed setup instructions.

💡 Use Cases​

Personal Productivity​

  • Plan your year with clear time investments
  • Track where your time actually goes
  • Balance work, health, and relationships

Goal Achievement​

  • Allocate dedicated hours to learning
  • Track progress toward time-based goals
  • Adjust allocations based on priorities

Business Planning​

  • Quarterly OKR time budgets
  • Project time allocation
  • Resource planning across time horizons

📚 Documentation Structure​

🤝 Contributing​

We welcome contributions! See our Contributing Guide for how to help improve Periodix-Planner.

📄 License​

MIT License - see the LICENSE file for details.

Ready to get started? Head to the Installation Guide to begin!