/excalibrain

A graph view to navigate your Obsidian vault

Primary LanguageTypeScriptMIT LicenseMIT

image

ExcaliBrain is inspired by TheBrain and Breadcrumbs. It is an interactive, structured mind-map of your Obsidian Vault generated based on the folders and files in your Vault by interpreting the links, dataview fields, tags and YAML front matter in your markdown files.

ExcaliBrain distinguishes 5 type of relationships between your notes:

  • Children
  • Parents
  • Friends
  • Other Friends (lateral relationships on the right side)
  • Siblings

Relationships are derived based on the following logic

  • Explicitly defined relationships specified by using dataview fields. (e.g. Author:: [[Isaac Asimov]])
  • Inferred relationships (without the use of dataview fields)
    • A forward-link is inferred as a child
    • A backlink is inerred as a parent
    • If files mutually link to each other they are friends
    • The children of the parents are the siblings

Prerequisites

ExcaliBrain is built on top of Dataview and Excalidraw. You must have both these plugins installed and enabled for ExcaliBrain to work.

ExcaliBrain is optimized to work well with Hover Editor.

Videos and additional background information

Detailed walkthrough

YouTube: thumbnail

image

Quick demo

2022-05-01.20-52-10.mp4

How to install

2022-05-01.22-19-04.mp4

Feedback, questions, ideas, problems

Please head over to GitHub to report a bug or request an enhancement.

Say Thank You

If you are enjoying ExcaliBrain then please support my work and enthusiasm by buying me a coffee on https://ko-fi/zsolt.

Please also help spread the word by sharing about the ExcaliBrain Plugin on Twitter, Reddit, or any other social media platform you regularly use.

You can find me on Twitter @zsviczian, on Discord OMG (zsviczian#6093), and on my blog zsolt.blog.