Home/Documentation/Obsidian Integration

Obsidian Integration

Connect your knowledge system with your time system. Tasks, events, and time blocks flow seamlessly between Obsidian and Elysium.

Overview

The OpenTime Export plugin for Obsidian creates a bidirectional bridge between your vault and Elysium. It parses your existing notes—whether you use the Tasks plugin, Day Planner format, or YAML frontmatter—and exports them in OpenTime format for Elysium to import.

Every exported item includes source tracking, so you can click any item in Elysium to jump directly back to the original note in Obsidian. It's the workflow you've been waiting for.

Features

Tasks Plugin Support

Parses emoji dates from the Tasks plugin: 📅 due dates, ⏳ scheduled, 🛫 start dates, ✅ done dates, and priority markers.

Day Planner Format

Time blocks like “09:00 - 12:00 Deep work” are automatically parsed and synced to your Elysium schedule.

YAML Frontmatter

Extract scheduled dates, due dates, and other metadata from your note frontmatter for structured scheduling.

Auto-Export on Save

Enable auto-export and your changes sync to Elysium automatically whenever you save a file in Obsidian.

Jump to Source

Click any item in Elysium to open the original note in Obsidian—including the exact line number where it was defined.

Extension Fields

x_obsidian fields track vault name, source file, and line number for perfect round-trip editing.

Installation

1

Install from Community Plugins

In Obsidian, go to Settings → Community Plugins → Browse, then search for “OpenTime Export” and click Install.

2

Enable the Plugin

After installation, enable the plugin in your Community Plugins settings.

3

Configure Export Settings

Go to the plugin settings to configure which parsers to enable, folder filters, and whether to export directly to Elysium's watched folder.

How Bidirectional Linking Works

Every item exported from Obsidian includes metadata that tracks its source. When you click an item in Elysium, it uses this metadata to open the exact note and line in Obsidian.

Example: Exported task with source tracking
- type: task
  id: task_review_notes
  title: "Review project notes"
  status: todo
  due: "2026-01-15"
  x_obsidian:
    vault_name: "My Vault"
    source_file: "Projects/Q1 Planning.md"
    line_number: 42
    original_text: "- [ ] Review project notes 📅 2026-01-15"
  x_elysium:
    obsidian_enabled: true
    obsidian_behavior: "alongside"

The x_elysium.obsidian_behavior field controls how Obsidian opens:

  • alongside — Opens Obsidian in a side pane while keeping Elysium visible
  • replace — Switches focus entirely to Obsidian

Supported Note Formats

Tasks Plugin Format

- [ ] Complete project proposal 📅 2026-01-20 ⏫
- [x] Send meeting notes ✅ 2026-01-02
- [ ] Review budget 🛫 2026-01-10 📅 2026-01-15

Supports: 📅 due, ⏳ scheduled, 🛫 start, ✅ done, ➕ created, 🔁 recurring, and priority markers (⏫🔺🔼🔽⏬)

Day Planner Format

09:00 Team standup
10:00 - 12:00 Deep work on project
14:00 - 15:00 Client call
16:00 Review and wrap up

Time blocks are parsed as events. Single times get a configurable default duration.

YAML Frontmatter

---
title: "Q1 Planning"
due: 2026-01-31
scheduled: 2026-01-15
tags: [work, planning]
---

Structured metadata from frontmatter is extracted and mapped to OpenTime fields.

Configuration Options

Export directly to Elysium

Write .ot files directly to Elysium's watched folder for automatic import

Auto-export on save

Automatically export when files are saved in Obsidian

Parser selection

Enable/disable Tasks, Day Planner, or Frontmatter parsers individually

Folder filters

Include or exclude specific folders with comma-separated patterns

Creating Items from Obsidian

The plugin also lets you create new schedule items directly from Obsidian using a modal interface. Open the command palette and search for “Create OpenTime item” to create:

Goals
Tasks
Habits
Reminders
Events
Appointments
Projects

Each type has rich field support including dates, priorities, recurrence rules, and more.

Get Started

Install the OpenTime Export plugin from Obsidian's community plugins, or visit GitHub to contribute or report issues.