Cockpit Board

Cockpit Board

A dynamic Kanban board for Obsidian driven by frontmatter properties. Drag-and-drop updates files instantly. Includes calendar views, timers, recurring tasks, and a checklist editor.

Features

• Kanban Board — Cards auto-sort into columns based on configurable rules (status:, date:, label:, no-date)
• Drag & Drop — Move cards between columns or reorder within. Bulk drag with multi-select (Ctrl+Click)
• Calendar Views — Week, month, and year views with time grid, all-day cards, and year heatmap
• Timers — Start/stop timers on cards, time tracked in time_spent frontmatter
• Recurring Tasks — Cron-based rules create tasks automatically each day
• Checklist Editor — Click the checklist count to open a drag-and-drop editor modal
• Archive Search — Search completed tasks in a YYYY/MM/DD folder structure
• Auto-Archive — Optionally move done cards into the archive folder after a configurable number of days
• Due-Soon Notifications — Configurable lead times (default 15 and 1 minutes before a task's time), with optional desktop notifications that reach you when Obsidian is in the background
• Mobile Optimized — Tab-based column switching with swipe gestures
• Privacy Mode — Blur card titles (hover to reveal) for screen sharing
• Focus Mode — Show only Today + In Progress columns (press F)
• Split & Close — Split a partially-completed checklist into done + continuation cards

Installation

From Community Plugins (recommended)

1. Open Settings > Community plugins
2. Click Browse and search for "Cockpit Board"
3. Click Install, then Enable

Manual

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create a folder <vault>/.obsidian/plugins/cockpit-board/
3. Copy the three files into that folder
4. Enable the plugin in Settings > Community plugins

Quick Start

1. Create a folder for your tasks (e.g., Tasks)
2. Go to Settings > Cockpit Board and set the Tasks folder
3. Open the board with the ribbon icon or command palette: "Open Cockpit Board"
4. Create task files with frontmatter:

---
title: "My Task"
status: scheduled
due: 2026-04-15
time: "14:00"
completed:
project: "Project X"
labels: [Work, DEADLINE]
created: 2026-04-01
source: manual
---

# My Task

Task description here.

## Checklist: Steps
- [ ] Step one
- [ ] Step two

Deep Link & Home-Screen Shortcut (Android / iOS)

The board registers the obsidian://cockpit-board URL, so you can jump straight to it without going through the command palette:

obsidian://cockpit-board?vault=MyVault&view=board
obsidian://cockpit-board?vault=MyVault&view=calendar
obsidian://cockpit-board?vault=MyVault&view=archive

Replace MyVault with your (URL-encoded) vault name. view is optional and defaults to board. The link works on desktop too, and survives a cold start (Obsidian opens first, then the board).

Android: open the URL once in Chrome, then ⋮ menu → Add to Home screen. Or use any shortcut-maker app with the URL above as the target.

iOS: create a Shortcut with Open URLs set to the link above, then Share → Add to Home Screen. Alternatively paste the link in Safari and use Share → Add to Home Screen.

Quick-add (file a task without opening the board)

obsidian://cockpit-board?vault=MyVault&quickadd=Buy+milk&due=today&time=18:00

quickadd is the card title (required). Optional: due (today, tomorrow, or YYYY-MM-DD), time (HH:MM), project, labels (comma-separated), and open (board, calendar, archive, or none — the default, which just shows a confirmation and leaves you where you were). Remember to URL-encode the vault name and title (spaces as %20 or +).

Phone recipes: on iOS, a Shortcut with Ask for Input → Open URLs gives you dictation-to-task in seconds. On Android, automation apps like MacroDroid or Tasker can prompt for text and open the built-in URL; for recurring one-tap tasks, pin a static URL per task straight to the home screen.

Frontmatter Properties

Column Rules

Rules determine which column a card belongs to. Evaluated in order: status rules first, then date/label rules.

Recurring Tasks

Create a JSON file (e.g., Scripts/recurring.json) and set its path in Settings:

{
  "tasks": [
    {
      "title": "Weekly review",
      "cron": "0 7 * * 5",
      "labels": ["Work"],
      "project": ""
    }
  ]
}

Cron format: minute hour dayOfMonth month dayOfWeek (standard cron).

Special frequencies: biweekly-2nd-sat, monthly-1st-mon.

External Calendars (Outlook / ICS)

One-way editable import: new Outlook events become cards in your tasks folder with the label you choose. Imported cards are never overwritten, so your edits are safe. Cancelled Outlook events do not delete cards. Skipped automatically: STATUS:CANCELLED, subjects starting with Canceled:/Cancelled:, and blocks with no title. A cancelled instance also suppresses that day's occurrence of its series, so no ghost card is left behind. Events deleted in Outlook leave no trace in the file — set "When events disappear" per calendar to keep the card (default), mark it done, or delete it. Only dates inside the sync window are ever touched, and cards you already marked done are left alone.

1. Get the calendar feed:
   • Outlook on the web: Calendar > Share > Publish > copy the ICS link.
   • Outlook desktop: Calendar > Publish Online > copy the link (https:// or webcal:// both work).
   • No link? Export a .ics file into your vault instead.
2. Settings > Cockpit Board > External calendars > + add calendar.
3. Set Name (e.g. Client Acme), paste the ICS URL (or .ics path: vault-relative like Calendars/client.ics, or on desktop an absolute path like ~/Downloads/client.ics), Label (e.g. ClientAcme), and optionally Project (e.g. ClientAcme — shown as a [Project] prefix).
4. Run Sync external calendars now from the command palette. New events import with due, time, due_end, labels: [ClientAcme], source: external-calendar.

Notes: syncs on startup, hourly, and every N minutes (configurable, min 5). Only new occurrences import — recurring Outlook series expand inside your days-back/ahead window. Filter the board by the label to see just that client.

Timezone: UTC times convert automatically. Times stamped with a zone (Outlook usually stamps its own, e.g. Swiss time) convert to your device time automatically. If the calendar has naive times in another zone, set the source timezone (IANA name, e.g. Europe/Zurich) and they convert too. Leave it empty when the calendar is already in your time.

Keyboard Shortcuts

Settings

• Tasks folder — Folder to scan for task files
• Archive folder — Folder for archived tasks (YYYY/MM/DD structure)
• Auto-archive done cards — Automatically move done cards into the archive folder once they've been completed for N days (also available as the "Archive done cards now" command)
• Recurring config path — Path to recurring.json
• External calendars — Outlook/ICS feeds imported with a fixed label (one-way, editable, never overwritten)
• Reminder lead times — Minutes before a card's time to warn, comma separated (default 15,1). Each lead fires once per card per day
• Desktop notifications — Also send a system notification, so reminders arrive when Obsidian is in the background (desktop only)
• Card open mode — Split pane, sidebar, or modal
• Mobile default column — Which column shows first on mobile
• Privacy mode — Blur card titles
• Checklist editor — Enable click-to-edit checklists
• Card label tint — Subtle background color from primary label
• Custom card order — Enable drag-and-drop reordering
• Label Colors — Assign custom colors to labels (auto-assigned from palette when not set)
• Columns — Add, remove, reorder, and configure column rules

License

MIT