punkyard_obsidian-lindar/docs/options.md

Options

All settings are in Settings → Community plugins → Lindar.

Event notes folder

Setting	Event notes folder
Default	Lindar
Description	Folder used to store calendar event notes. Relative to vault root. Created automatically if it doesn't exist.

Default event color

Setting	Default event color
Default	#4f46e5
Description	Used as the default color when creating events. A reset button restores the default.

Task tag

Setting	Task tag
Default	#lindar
Description	Tag used to identify task checkbox lines for calendar display. Any - [ ] line containing this tag and a Tasks-plugin-compatible emoji date (📅📆🗓⏳⌛🛫) is rendered as a bordered outline bar in the grid. Color can be set per task with a backtick-wrapped #hex at end of line.

Task line format

- [ ] Title  #tag 📅 YYYY-MM-DD `#hex`

• Tag: configurable (default #lindar)
• Date priority: 📅|📆|🗓 (due) > ⏳|⌛ (scheduled) > 🛫 (start)
• Color: `#hexcode` in backticks at end of line
• Clicking a task bar opens the source note at the task line

Motto

Setting	Motto
Default	(empty)
Description	Message shown in the year view header.

Day highlights

Setting	Default	Description
Highlight Wednesdays	On	Applies a muted highlight to Wednesday cells.
Highlight weekends	On	Applies weekend styling to Saturday and Sunday cells.

Located after the Motto field and before Expand months to fit events.

Event lanes

Setting	Default	Description
Expand months to fit events	Off	When on, each month expands vertically to show all event lanes. When off, the lane count below applies.
Visible event lanes per month	0	Number of event lanes displayed (may require scroll). 0 distributes rows evenly. Only active when Expand months is off. Changes are debounced (500ms).

Categories

Categories label events by type and auto-assign a default color. Each category has a name, a color, and an enabled toggle.

Seed categories

Category	Default color
appointment	#4f46e5
call	#0891b2
meal	#65a30d
meeting	#ca8a04
travel	#ea580c
deadline	#dc2626
task	#7c3aed
reminder	#0d9488
other	#78716c

Add, rename, recolor, or remove any — they are a starting point.

Managing categories

Each category row has two groups:

Left group: ↑ (move up) · ↓ (move down) · name input · color swatch Right group: toggle (enable/disable) · trash (delete)

• Add: click + Add category at the bottom. A new row appears with empty name and default color.
• Reorder: ↑ and ↓ arrows. First row cannot move up; last cannot move down.
• Rename: type directly in the name field.
• Recolor: click the color swatch.
• Disable: toggle off. Disabled categories are hidden from the event modal's type dropdown. Rows dim to 50% opacity. Existing events keep their type text.
• Delete: trash icon. Irreversible.

All changes save immediately.

Per-event color override

1. In the event modal, type or select a category from the Type field.
2. The Color picker auto-fills with that category's color.
3. Change the color picker to override per-event — the category definition is unaffected.

Type field (combobox)

The Type field in the event modal is a custom combobox:

• Click the input or toggle button to show all enabled categories.
• Type to filter the list.
• Keyboard navigable (arrow keys, Enter to select, Escape to close).
• Selecting a category auto-fills the color picker.
• The list closes on selection.