Build your Wisdio video library.

Quick start

Keep the setup predictable: one folder for notes, one template, and one MOC (Map of Content) note for every Dataview view.

1. 1
   Install the two Obsidian plugins

   Enable Wisdio Companion and Dataview in your desktop Obsidian vault.

2. 2
   Choose the Wisdio folders

   Use Wisdio/Notes for notes and Wisdio/Templates/Default Note.md for the template.

3. 3
   Copy the recommended template

   New notes will include the source URL, timestamps, and editable organization fields.

4. 4
   Create Wisdio/MOC.md

   Paste any Dataview recipe from this page into your MOC.

YAML fields

YAML fields store note metadata. Wisdio writes the source and time fields; users fill in platform, collections, and status.

Wisdio sync fields

User organization fields

A video can belong to more than one collection:

platform: "youtube"
collections:
  - "AI"
  - "Product"
  - "To Research"
status: 🟥

Note security

Wisdio and Obsidian are two separate note systems. Wisdio keeps its own local note data, while Obsidian keeps Markdown files and attachments in your Vault. Wisdio Companion links the systems through a local, authenticated connection, but it does not merge their storage or share their deletion lifecycle.

Independent deletion boundaries

Revision protection

When both Wisdio and Obsidian edit the same linked note, Wisdio checks the file's current revision before writing. If the Obsidian file changed after Wisdio last read it, Wisdio stops instead of silently overwriting newer content.

• Reload the latest Obsidian version.
• Intentionally overwrite Obsidian with your Wisdio edits.
• Save your local edits as a new Wisdio note.

Retention and backups

If an Obsidian file is deleted, Wisdio keeps the local note so you can review it or link it again intentionally. Wisdio also keeps its own image cache and recent image versions for recovery; older image versions are cleaned up on a retention schedule.

Stable identity and local security

Linked notes use a stable Wisdio identity rather than relying only on a file name or path, so a rename or move can keep the link. Wisdio Companion runs on your local device and accepts authenticated local requests; it does not expose your Vault as a public cloud file system.

Template variables

Template variables are replaced by Wisdio when it creates a Markdown file.

Recommended template

Paste this into Wisdio/Templates/Default Note.md. Wisdio fills the source fields; the user fills the organization fields.

---
wisdio_id: "{{id}}"
wisdio_source: browser-extension
wisdio_source_url: "{{sourceUrl}}"
wisdio_created_at: "{{createdAt}}"
wisdio_updated_at: "{{updatedAt}}"
platform: ""
collections: []
status: 🟥
---

{{content}}

Time format

Wisdio writes timestamps in ISO 8601 format so they remain precise, portable, and sortable.

Dataview date tokens

For a compact date such as 20260721, use yyyyMMdd.

dateformat(
  localtime(date(wisdio_created_at)),
  "yyyy-MM-dd HH:mm"
)

Understand and customize Dataview

Dataview reads YAML metadata and turns it into live lists or tables. It does not move or duplicate your Markdown files, and every part of a query can be changed to match your vault.

Common customizations

Continue with the official Dataview documentation

Dataview recipes

Create Wisdio/MOC.md as the content map for your video notes, then paste the views you want to use. Each Copy button includes the complete ```dataview code fence required by Obsidian.

Recommended: Group by Collection

Use FLATTEN so one video can appear in every collection listed in its YAML.

```dataview
TABLE WITHOUT ID
  Collection AS "Collection",
  rows.file.link AS "Videos",
  rows.platform AS "Platform",
  rows.status AS "Status"
FROM "Wisdio/Notes"
WHERE collections
FLATTEN collections AS collection
SORT date(wisdio_created_at) DESC
GROUP BY collection AS Collection
SORT Collection ASC
```

Optional: All videos, newest first

```dataview
TABLE
  elink(wisdio_source_url, "Watch") AS "Source",
  platform AS "Platform",
  collections AS "Collections",
  status AS "Status",
  dateformat(
    localtime(date(wisdio_created_at)),
    "yyyy-MM-dd HH:mm"
  ) AS "Created"
FROM "Wisdio/Notes"
WHERE wisdio_source_url
SORT date(wisdio_created_at) DESC
```

Group by Platform / Collection

```dataview
TABLE WITHOUT ID
  Group AS "Platform / Collection",
  rows.file.link AS "Videos",
  rows.status AS "Status",
  map(
    rows.wisdio_source_url,
    (url) => elink(url, "Watch")
  ) AS "Source",
  rows.wisdio_created_at AS "Created"
FROM "Wisdio/Notes"
WHERE platform AND collections
FLATTEN collections AS collection
FLATTEN platform + " / " + collection AS group_label
SORT date(wisdio_created_at) DESC
GROUP BY group_label AS Group
SORT Group ASC
```

Filter one platform and Collection

```dataview
TABLE
  status AS "Status",
  elink(wisdio_source_url, "Watch") AS "Source",
  wisdio_created_at AS "Created"
FROM "Wisdio/Notes"
WHERE platform = "youtube"
  AND contains(collections, "AI")
SORT date(wisdio_created_at) DESC
```

Troubleshooting