Weekly Routine Planner

Weekly Routine Planner

An Obsidian plugin for planning weekly routines with a timetable-style editor and a fenced weekly-routine block.

It is meant for recurring weekly structure, not dated calendar events or one-off schedules. The plugin is currently desktop-only.

Start hour, end hour, and hour height are configured in the plugin settings.

Installation

This plugin is currently under review for the Obsidian Community Plugin directory. Once approved, you will be able to install it directly from Settings → Community plugins in Obsidian. Until then, you can install it manually:

1. Clone or download this repository.

   git clone https://github.com/lylaminju/weekly-routine-planner.git
   

2. Locate your vault's plugin folder. It is at <your-vault>/.obsidian/plugins/. Create the plugins directory if it does not exist.
3. Copy main.js, manifest.json, and styles.css from the cloned repository into a new folder:

   mkdir -p <your-vault>/.obsidian/plugins/weekly-routine-planner
   cp main.js manifest.json styles.css <your-vault>/.obsidian/plugins/weekly-routine-planner/
   

4. Add "weekly-routine-planner" to the array in <your-vault>/.obsidian/community-plugins.json. If the file does not exist, create it with:

   ["weekly-routine-planner"]
   

5. Restart Obsidian (or reload without cache: Ctrl/Cmd + Shift + R on desktop).
6. Go to Settings → Community plugins, find Weekly Routine Planner in the list, and enable it.

Note Format

```weekly-routine
```
<!-- weekly-routine:start -->
- [s-1] Monday 08:00-08:30 | Wake up | #daily-routine
-
<!-- weekly-routine:end -->

The fenced code block marks the note as a weekly routine planner note. The plugin only writes inside the region between <!-- weekly-routine:start --> and <!-- weekly-routine:end -->, so the rest of the note stays untouched.

Each routine line is stored as:

- [event-id] Day HH:MM-HH:MM | Title | #category-tag

Category Management

Categories are managed by the user from the timetable UI:

1. Click Manage categories in the timetable toolbar.
2. Add, rename, recolor, or delete categories.

The same category manager is also available while creating or editing a routine.

Category definitions are saved in the plugin's data/settings, not directly in the note. Inside the note, a routine only stores the selected category as a tag such as #daily-routine.

The category id is generated from the category name, so Daily Routine becomes #daily-routine. If you rename a category, the plugin updates matching tags in the managed routine block. If you delete a category, the plugin removes that category tag from affected routines.