Obsidian and the sessions calendar

Sync the World and Journal with an Obsidian vault through a token, and subscribe to your sessions in Google Calendar, Apple Calendar or Outlook.

Two connections between your account and outside tools: the Obsidian plugin, which syncs your campaigns' World and Journal with a vault, in both directions, and the sessions calendar, a private link that Google Calendar, Apple Calendar or Outlook keep up to date by themselves.

Where it is

In settings, under the names Obsidian plugin and Session calendar, in the account's connections section. See Settings, one by one.

Requirements and permissions

The Obsidian token can only be created if you are the GM of some campaign, and it is valid only for the campaigns you choose while you are. The calendar shows your sessions; whoever has the link sees them.

Obsidian: syncing the World and the Journal

The plugin brings down to your vault one note per World and Journal entry, with the same header and the same [[links]] as Roliando's exporter, and sends up what you write. GM-only blocks arrive as a warning and become secret again when sent up; if a note changes on both sides at once, nothing is overwritten: the conflict is marked and you resolve it with both versions side by side. Embedded images are uploaded to your space, and nothing is ever deleted: deleting a note on one side does not delete it on the other.

In Obsidian plugin press Create token.
Give it a name (Name (to recognise it)), choose the Campaigns it can see and whether the token Can write (upload changes) or only reads; choose when it expires.
The token is shown once: Copy it now and paste it into the plugin. It is not shown again: if you lose it, revoke this one and create another.
Paste it into the Obsidian plugin, which installs like any community plugin (on mobile BRAT is recommended; the instructions are in the plugin's own README).
The connections list shows each token's state (with its expiry date) and its last use, and Revoke cuts it at once.

Careful. Whoever has the token can read, and if you allow it write, in those campaigns, GM-only secrets included. Treat it like a password.

Sessions calendar

A private link to see your sessions in Google Calendar, Apple Calendar or Outlook. It keeps itself up to date. Anyone with the link sees your sessions: if it leaks, change it. Press Create link to create the link and Copy link to paste it into your calendar application as a subscription. Each session shows with the time in your zone (your account's) and updates by itself when it changes in the campaign. A single session can also be downloaded or added to Google Calendar from Home. See Sessions, schedule and reminders.

Known limits

Syncing with Obsidian covers the World, the Journal and maps; it does not cover campaign settings or sheets.
A session stores no end time: in the calendar it lasts three hours.
Revoking a token does not touch the notes you already have in your vault.

Frequent problems

"I can't create the token." The token could not be created. Check that you are the GM of the chosen campaigns.

"I lost the token." It is not shown again: revoke the old one and create another.

"My calendar does not update." Calendar applications ask for the link again every so often; it may take a while. If the link leaked, create it again.