Wisdio Companion

Take video notes without leaving your browser — and keep them synced with Obsidian.

Wisdio website · Install Wisdio for Chrome · Documentation

Wisdio is a browser extension for writing notes beside the video you are watching. Capture ideas, add timestamps, and organize what you learn without switching away from the browser.

Wisdio Companion is the Obsidian plugin that connects that browser workflow to your local vault. It saves Wisdio notes as ordinary Markdown files and keeps note content and filenames synchronized between Wisdio and Obsidian.

Demos

Sync video notes with Obsidian

https://github.com/user-attachments/assets/d10d6646-1115-471d-8ec1-e92f23f4d7d9

Watch on wisdio.org

Capture subtitles and take timestamped notes

https://github.com/user-attachments/assets/bf943b97-e99c-40c6-a580-d324fc721bc7

Watch on wisdio.org

Take notes on Bilibili videos

https://github.com/user-attachments/assets/57ccdd1c-8486-4499-86f5-f8393355e533

Watch on wisdio.org

Take video notes on mobile

https://github.com/user-attachments/assets/6a8e6094-cbb0-49b8-9c9a-3a62f3f717cf

Watch on wisdio.org

How it works

1. Watch a video and write timestamped notes in the Wisdio browser side panel.
2. Wisdio Companion saves the note into your chosen Obsidian vault folder.
3. Continue editing from Wisdio or Obsidian. Changes and file renames stay linked through the note's managed wisdio_id.
4. Revision checks stop one side from silently overwriting newer changes made on the other side.
5. Images pasted into Wisdio remain in Wisdio local storage and are copied into the attachment location configured by Obsidian when the note synchronizes.
6. Companion keeps stable image identities in .wisdio/assets.json, so image renames, edits, missing files, and reconnect recovery do not depend on a filename staying unchanged.

Requirements

• Obsidian 1.5.7 or newer
• Desktop Obsidian only
• Wisdio browser extension

Features

• Write video notes without leaving the browser
• Add timestamps that return to the relevant moment in the video
• Paste images into Wisdio notes and sync them as ordinary Obsidian attachments
• Track linked images across Obsidian renames and real binary edits
• Preserve the Wisdio copy when an Obsidian image or Markdown reference is removed
• Create Wisdio notes as Markdown files in your vault
• Sync note content and filenames between Wisdio and Obsidian
• Import existing Obsidian notes into Wisdio
• Rejects stale writes instead of silently overwriting newer Obsidian edits
• Tracks linked notes by wisdio_id, including after file renames
• Lets you choose the Wisdio notes folder
• Provides a customizable Markdown template for new Wisdio notes
• Uses a local API key so only authorized local clients can connect

Setup

1. Install the Wisdio browser extension.
2. Install and enable Wisdio Companion in Obsidian.
3. Open Settings -> Wisdio Companion.
4. Copy the generated API Key.
5. Open the Wisdio browser extension settings.
6. Enable Obsidian Link.
7. Use the default endpoint unless you changed the port:

http://127.0.0.1:27125

8. Paste the API key from Obsidian into Wisdio.
9. Choose the vault folder where Wisdio notes should be stored, for example:

Wisdio

Settings

• Enabled: Starts or stops the local API and WebSocket server.
• Port: Local loopback port. Default is 27125. Vaults running Companion at the same time must use different ports.
• API Key: Bearer token used by the Wisdio browser extension.
• Folder: Vault folder used for Wisdio notes and event filtering.
• Template File: Vault-relative Markdown template for new Wisdio notes.
• Reset Template File: Restores the default Wisdio note template.

Template variables

The default template is stored at:

Wisdio/Templates/Default Note.md

You can edit it directly in Obsidian. Supported variables:

• {{id}}
• {{title}}
• {{content}}
• {{sourceUrl}}
• {{url}}
• {{createdAt}}
• {{updatedAt}}

The template always contains:

wisdio_id: "{{id}}"

This is the managed identity that keeps a Wisdio note linked to the same Obsidian file after renames and imports. Companion restores the field automatically if it is removed or replaced with a fixed value.

For a copy-and-paste YAML template and Dataview-powered MOC setup, see the Wisdio Documentation.

Privacy and security

• Wisdio Companion only binds to 127.0.0.1.
• It does not expose your vault to the public internet.
• Requests require the API key shown in plugin settings.
• Wisdio note files are ordinary Markdown files in your local vault.
• Image attachments are stored according to your Obsidian attachment settings.
• .wisdio/assets.json contains only image IDs, hashes, MIME types, and vault-relative paths; it does not contain image data.
• Removing an image reference does not automatically delete either physical copy. Unused Wisdio copies can be deleted from Wisdio's Images view.
• Deleting files is intentionally not exposed through the local API. Delete real files from Obsidian.

Manual Companion install for reviewers and developers

Build Wisdio Companion:

npm install
npm run build

Then copy main.js and manifest.json into:

<your vault>/.obsidian/plugins/wisdio-companion/

Enable Wisdio Companion from Obsidian community plugin settings.

Support

Please open an issue in this repository for bugs, setup questions, or compatibility problems.