Schedule Block is a lightweight timeline toolkit for SiYuan, offered in two ways:
- Embedded schedule blocks placed directly inside documents, bound to a specific day or week.
- A standalone schedule panel opened from the top-bar menu as a tab, showing the same data at full size with switchable day / week / month views and automatic follow of the current time — a good fit for a personal main schedule.
It is not a global calendar and it is not a replacement for database calendar views. It focuses on a narrower workflow: an editable, draggable, persistent schedule without creating a database or leaving SiYuan.
- Standalone schedule panel (tab) with switchable day / week / month views.
- The panel follows the current time automatically: the now indicator advances every minute and the view rolls over to the new day at midnight, with no need to reopen it.
- Month view shows Gregorian + lunar dates per cell, compact dot-style events, a "+N more" popover when overflowing, and per-day weather.
- Embedded day blocks and week blocks for inline use in documents.
- Each block is bound to a date or ISO week; the toolbar button shows the range you are currently viewing, highlights when it matches the bound range, and jumps back to it when clicked.
- New blocks can infer their initial date or week from the document title; if no supported title date is found, they use the current date.
- Settings allow changing the bound date/week and the default event duration.
- New events default to 30 minutes, with per-block options for 15, 30, 45, or 60 minutes.
- Newly inserted schedule blocks are tall enough to show the full 24-hour timeline by default.
- Drag-select to create events; single-clicking blank space does nothing, while double-clicking creates a default-duration event.
- Click an event to edit title, date, time, all-day state, color, and notes.
- Recurring events use a rule, like other calendar apps: an event stores one repeat rule (daily / every weekday / weekly / biweekly / monthly / yearly, ending never, after N times, or on a date) and the view expands it into occurrences, so editing the rule updates the whole series.
- Editing, dragging, or deleting a recurring event asks for the scope: this event only, this and following events, or all events.
- Recurring to-dos track completion per occurrence, repeating events carry a loop marker on the chip, and the editor shows the current rule.
- Drag or resize events to adjust time.
- Hover an event with notes to show the note in a lightweight tooltip; it disappears when the mouse leaves.
- Use
Cmd/Ctrl+Zto undo the previous schedule data operation. - Use the Add Schedule command, with
Option+Command+Sby default, to quickly add an event outside a specific schedule block. - Use the Open Schedule Panel command, with
Option+Command+Shift+Sby default, to open the standalone panel. - Export the current day or week schedule block as a PNG screenshot.
- Events created from drag-select, double-click, or the toolbar plus button auto-save while editing.
- Clicking outside the editor keeps the auto-saved result.
- Pressing
Escor clicking Cancel truly cancels the current edit: new drafts are removed, and existing events roll back to their original values. - Cross-day events show both start and end dates, so midnight boundaries such as
Jun 12 23:00 -> Jun 13 00:00stay explicit. - Short events use a compact single-line layout and keep their height tied to the real duration, so neighboring events are not covered.
- Events feature an Apple Calendar-style layout (with a soft translucent background tint and a solid left colored border bar) for a clean, modern aesthetic. Text and checkboxes automatically adapt to light/dark themes to ensure high contrast and excellent readability. In month views, events render as clean cards while hiding redundant internal marker lines.
- The block's "color management" lets you drag to reorder, click to recolor, and add/remove colors; changes apply instantly and sync everywhere.
- A toolbar filter button lets you choose which event colors are visible in the current schedule block.
- The filter palette uses the same color order as the event editor.
- When all colors are selected, all events are shown; clicking a color in this state switches directly to "only this color".
- While filtering, click more colors to expand or reduce the visible set, or use All to restore every color.
The day header uses a compact two-line layout:
- Line 1: Gregorian date and lunar date.
- Line 2: weekday and weather icon.
Weather supports four simple states: sunny, overcast, rain, and snow. Click the weather icon to set or clear the day weather. Empty days use a neutral weather placeholder icon, not a specific weather state. Month view shows the set weather icon after each date.
Weather data is stored separately from event data.
After enabling the plugin:
- Open the standalone panel from the top-bar Schedule Block menu → "Open Schedule Panel", or press
Option+Command+Shift+S.
Or insert a schedule block into a document from:
- the top-bar Schedule Block menu,
- the command palette,
- or the slash menu with
/日历块or/周历块.
Inside a block, you can:
- use Add Schedule from the top-bar menu, or press
Option+Command+Sfrom SiYuan, to open the same event editor centered over the SiYuan window with a frosted background overlay, - use document titles such as
2026-6-13,2026/06/13,2026年6月13日,20260613,2026-W26, or2026年第26周to auto-bind newly inserted blocks, - click the anchor button to return to the bound date or week,
- click the gear button to edit the binding and default event duration,
- click the filter button to filter events by color,
- click the screenshot button to export the current schedule block view as a PNG; the export hides transient UI and the current-time indicator, and prefers Desktop as the default save location,
- click the same settings, filter, plus, or weather button again to close its popover,
- drag-select a time range to create an event,
- double-click a blank time slot to create a default-duration event,
- click an existing event to edit or delete it,
- hover an event with notes to preview the note,
- drag existing events to adjust time,
- click the weather icon in the day header to set the day weather.
- Keyboard Shortcuts (requires clicking the schedule view to focus):
ArrowLeft/ArrowRight: Navigate to the previous day/week/month or next day/week/month.T: Reset view. In the standalone schedule panel, it jumps to absolute today/current time; in embedded document blocks, it jumps back to the bound default date/week.S: Open Add Schedule while focus is inside a schedule block or the standalone panel.Command+Z/Ctrl+Z: Undo the last event editing action.
Events are stored in the SiYuan workspace at:
/data/storage/schedule-block/events.json
Weather is stored separately at:
/data/storage/schedule-block/weather.json
Block-level state such as view type, bound date/week, and default event duration is stored in SiYuan block attributes.
- Daily notes, weekly plans, and personal dashboards.
- Project schedules embedded in project documents.
- Meeting agendas inside meeting notes.
- Course plans, reading plans, and writing plans.
- Any note that benefits from an inline timeline.
MIT
This plugin was made entirely through vibe coding. The tools and models used were roughly:
- Codex (GPT 5.5): 60%
- Antigravity (Gemini 3.5 Flash): 20%
- Claude Code (Fable 5): 10%
- QoderWork (GLM-5.1): 10%
(The figures above are estimates from the plugin's first release; it keeps being updated, always with the most capable models available at the time.)
Top-tier models are expensive and my study schedule is tight, so this work has not come easily. If you like this plugin or benefit from it, you are warmly invited to support its development. I will keep updating it and making the experience better.
Please leave your LianDi (ld246) username or any other social account with your payment, and at the next plugin update I will add you to the sponsor list of all my plugins (if you would rather appear only in a specific plugin's list, please say so in your note), as a token of my gratitude. Your support is my greatest motivation to create!
 |
 |
|---|