Obsidian Stats logoObsidian Stats

Knox Timeline

by Christopher Wagner
5
4
3
2
1
Score: 35/100
New Plugin
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Timeline view of your Fastmail calendar (and read-only iCal URLs) in a sidebar leaf, with one-click meeting note creation.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Knox Timeline

Timeline view of your Fastmail calendar in an Obsidian sidebar leaf, with one-click meeting note creation.

Knox Timeline panel

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

  1. Open Obsidian → Settings (⌘,) → Community plugins
  2. If you see "Restricted mode is on", click Turn on community plugins
  3. Click Browse
  4. Search "Knox Timeline"
  5. Click Install → then Enable

Via BRAT (For Pre-release Betas)

  1. Install the BRAT plugin from the Community plugins directory.
  2. In Obsidian: Settings → BRAT → Add Beta plugin.
  3. Paste: cwagner223355/knox-timeline
  4. Enable Knox Timeline in Community plugins.

Knox Timeline is not yet in the Community plugins directory.

Setup

  1. Generate a Fastmail app password: Fastmail → Settings → Privacy & Security → App passwords. Give it Calendars (CalDAV) access only.
  2. Open Knox Timeline settings: enter your Fastmail email and app password.
  3. Click Refresh calendar list to discover your calendars.
  4. 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.

Sponsors