Knox Timeline
Christopher Wagner33 downloadsTimeline view of your Fastmail calendar (and read-only iCal URLs) in a sidebar leaf, with one-click meeting note creation.
- Overview
- Scorecard
- Updates6
Timeline view of your Fastmail calendar in an Obsidian sidebar leaf, with one-click meeting note creation.
Why this exists
I really like the two day timeline view for daily planning and meeting prep, but I do most of my note-taking in Obsidian. Existing Obsidian calendar plugins lean toward month grids or to-do lists, neither of which answer "what does my day actually look like." Knox Timeline brings the timeline format into Obsidian's right sidebar, sourced from Fastmail via CalDAV, and lets me turn any event into a meeting note with one click.
Features
- Single-day or two-day (today + tomorrow) timeline views
- All-day events shown in a strip above the timed grid
- Multi-calendar support with per-calendar enable/disable
- One-click meeting note creation from any event
- Hide noisy events (recurring blockers, declined invites) with the ability to unhide later
- Auto-refresh at midnight and on stale data
- Commands for previous/next day, jump to today, and refresh
Install
Plugin Directory
- Open Obsidian → Settings (⌘,) → Community plugins
- If you see "Restricted mode is on", click Turn on community plugins
- Click Browse
- Search "Knox Timeline"
- Click Install → then Enable
Via BRAT (For Pre-release Betas)
- Install the BRAT plugin from the Community plugins directory.
- In Obsidian: Settings → BRAT → Add Beta plugin.
- Paste:
cwagner223355/knox-timeline - Enable Knox Timeline in Community plugins.
Knox Timeline is not yet in the Community plugins directory.
Setup
- Generate a Fastmail app password: Fastmail → Settings → Privacy & Security → App passwords. Give it Calendars (CalDAV) access only.
- Open Knox Timeline settings: enter your Fastmail email and app password.
- Click Refresh calendar list to discover your calendars.
- Toggle which calendars to include in the timeline.
Settings
| Setting | Type | Default | Description |
|---|---|---|---|
| Fastmail username | text | empty | Your full Fastmail email address. |
| Fastmail app password | secret | empty | App password with Calendars (CalDAV) access. Stored in Obsidian's SecretStorage; see security notes below. |
| First day of week | dropdown | Sunday | Sunday or Monday — controls the leftmost column in the month calendar. |
| External iCal URLs | list | empty | Read-only iCal feeds (Google Calendar secret URL, iCloud public calendar, Outlook published calendar, etc.). Each has name, URL, color, and an enabled toggle. |
| Default view | dropdown | Single day | Single day or today + tomorrow side-by-side. |
| Enabled calendars | toggle list | all discovered | Which calendars to include in the timeline. |
Commands
| Command | What it does |
|---|---|
| Open Timeline | Open the timeline panel in the right sidebar. |
| Refresh Timeline | Re-fetch events from Fastmail. |
| Previous day | Shift the timeline anchor back one day. |
| Next day | Shift the timeline anchor forward one day. |
| Jump to today | Reset the anchor to today. |
Security notes
The Fastmail app password is stored in Obsidian's SecretStorage on the device where you entered it. It does not sync with your vault.
Use a scoped Fastmail app password — give it Calendars (CalDAV) access only. You can revoke it at any time from Fastmail settings.
Network traffic to caldav.fastmail.com is HTTPS only, so credentials are encrypted in transit.
Known limitations
- Read-only: events cannot be created or edited from the timeline.
- Desktop only. Mobile support is not planned for v1.
Support
If Knox Timeline is useful to you, consider buying me a coffee.
License
MIT — see LICENSE.