Obsidian Stats logoObsidian Stats

Neighbourhood Graph

by agilesmagile
5
4
3
2
1
Score: 35/100
New Plugin
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Interactive D3.js force-directed graph showing the current note's neighbourhood in a sidebar panel. Nodes connected by shared tags and backlinks.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Neighbourhood Graph

An Obsidian plugin that shows the current note's neighbourhood as an interactive force-directed graph in a sidebar panel. Navigate your vault by exploring connections between notes, shared tags, and backlinks.

Neighbourhood graph with colour groups, size variation, and settings panel

What it does

Opens as a right-sidebar panel. As you navigate between notes, the graph recentres on the active note and shows:

  • The focus note highlighted with an amber glow, largest node
  • Neighbour notes connected via shared tags or backlinks, sized by relevance
  • Shared tag nodes (diamond shapes) representing tags that connect notes
  • Edges showing the relationships between notes and concepts

Hover any node to highlight its connections. At depth 2, secondary connections also light up, revealing the structure around any note in the neighbourhood.

Two-hop highlight showing #capdev connections radiating from the focus note

Interactions

Action Behaviour
Hover Highlights direct connections (and secondary connections at depth 2)
Click Recentres the graph on that note
Double-click Opens the note in the editor and recentres
Drag Repositions a node
Scroll Zoom in and out

Installation

From the community plugin directory

  1. Settings > Community plugins > Browse
  2. Search "Neighbourhood Graph"
  3. Install and enable

Manual install

  1. Download main.js, manifest.json, and styles.css from the latest release
  2. Create a folder at <your vault>/.obsidian/plugins/neighbourhood-graph/
  3. Copy all three files into that folder
  4. Settings > Community plugins > reload and enable Neighbourhood Graph

Settings

Click the gear icon in the top-right corner of the graph panel. Each setting has an info icon with a tooltip explaining what it controls.

Setting Description Default
Highlight depth Tiers of connections highlighted on hover. 1 = direct only. 2 = direct + secondary. 2 hops
Max neighbours Cap on displayed notes. Most strongly connected shown first. 30
Show path in tooltip Display the vault folder path when hovering a note. On
Size by relevance How much node size varies by connection strength. 0 = uniform, 10 = dramatic. 5

Physics controls

Four sliders for fine-tuning the graph layout: line colour, line thickness, spread (repulsion), and link pull (clustering).

Colour groups

Colour groups are configured in Settings > Neighbourhood Graph. Assign colours to notes by query:

  • path:people/ matches notes in the people folder
  • tag:#project matches notes with the project tag
  • Plain text matches against note titles

First matching rule wins. You can import colour groups directly from Obsidian's built-in graph view with the Import from graph view button.

Import colour groups from Obsidian's graph view

How it works

The plugin reads Obsidian's metadata cache for tags and resolved links. No custom frontmatter required. Neighbours are scored by connection strength:

  • Shared tags between the focus note and a neighbour
  • Direct wikilinks (outbound and inbound)
  • Bidirectional links score higher
  • Well-connected hub notes rank higher (logarithmic scaling)

The top N neighbours (configurable) are shown, with node size reflecting their relevance to the focus note.

Licence

MIT

Sponsors