Graph Source Color

An Obsidian plugin that dynamically colors graph nodes based on their linked "source" notes.

Demo

View the interactive demo — Step-by-step animation showing how source colors propagate through links.

Features

• Source Detection — Automatically identifies source notes within configured folders. Each folder becomes a color group.
• Link Propagation — Recursively traces outgoing and incoming links to associate notes with their relevant sources. Linked notes inherit source colors through BFS propagation.
• Multi-Color Nodes — Notes linked to multiple sources display split-color nodes:
  • 2 sources → left/right split
  • 3+ sources → pie-chart split
• Read-Only — Does not modify Obsidian's native graph.json configuration.
• Folder Tree Selector — Visual folder picker in settings for easy source folder configuration.
• Color Inheritance — Parent folder colors cascade to sub-folders that don't have an explicit color set.

Installation

From Obsidian Community Plugins

1. Open Settings → Community Plugins
2. Search for "Graph Source Color"
3. Install and enable

Manual Installation

1. Download main.js, manifest.json and styles.css from the latest release
2. Copy both files to your vault: <vault>/.obsidian/plugins/graph-source-color/
3. Restart Obsidian and enable the plugin in Settings → Community Plugins

Configuration

Open Settings → "Graph Source Color" to configure:

Note: Source folder colors can also be set in Obsidian's native graph settings (color groups with path: queries). The plugin will read and respect those colors.

How It Works

Source Identification

Notes inside configured source folders are automatically treated as source notes. Their group is determined by the folder they belong to.

Association Logic

1. Outgoing links — A source note's outgoing links associate the target note with that source
2. Incoming links — A non-source note linking to a source becomes associated with that source
3. Propagation — Notes already associated with sources propagate those associations through their own outgoing links (BFS)

Commands

Compatibility

• Minimum Obsidian version: 0.15.0
• Desktop and mobile supported

Development

npm install
npm run dev    # Watch mode
npm run build  # Production build

License

MIT