Graph Project Buttons

by Daniel Kremen
5
4
3
2
1
Score: 52/100

Description

One-click project filter buttons for the graph view.

Reviews

No reviews yet.

Stats

0
stars
221
downloads
0
forks
158
days
4
days
4
days
11
total PRs
0
open PRs
7
closed PRs
4
merged PRs
0
total issues
0
open issues
0
closed issues
8
commits

Latest Version

5 days ago

Changelog

Security

  • Updated dev dependencies to clear Dependabot alerts: minimatch to 11.0.8 (pinned with an npm override), brace-expansion, js-yaml and fast-uri. None of them ship in the plugin bundle.

README file from

Github

Graph Project Buttons

One-click project filter buttons for the Obsidian graph view, so you never have to type path: queries by hand.

The plugin injects one compact filter button into every graph view. It opens a menu with a Curated reset entry, an All projects entry, and one entry per subfolder of a configurable root folder (default projects). Pick an entry and the graph's search is set for you.

Graph Project Buttons in the graph view

Features

  • A menu entry per immediate subfolder of your projects root, auto-discovered from the vault. Loose files under the root and dot-folders are ignored.
  • A Curated entry that applies a configurable reset query (default -path:projects/) and an All projects entry (path:<root>/).
  • The button shows the active filter's name and the menu checks its entry.
  • Per-entry lucide icons and a left/right dock position.
  • Re-injects itself when the graph re-renders, using a MutationObserver — no polling.
  • The project list is cached and only recomputed when files are created, deleted, or renamed.
  • Zero runtime dependencies. Desktop and mobile.

Privacy

To build the project buttons, the plugin reads only the vault's file list (file paths via getFiles) so it can find the subfolders under your projects root. It never opens or reads file contents, makes no network requests, and writes nothing outside its own plugin settings.

Install

Manually

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Copy them into your vault at <vault>/.obsidian/plugins/graph-project-buttons/.
  3. Reload Obsidian (or toggle community plugins off and on) and enable Graph Project Buttons under Settings → Community plugins.

From the community directory (once published)

Open Settings → Community plugins → Browse, search for Graph Project Buttons, install, and enable it.

Usage

Open any graph view. The filter button appears in the top corner, labelled with the active filter (or Filter when none matches). Click it and pick a project to filter the graph to that subfolder, or Curated to apply your reset query.

Settings

Setting Default Description
Projects root folder projects Top-level folder whose subfolders become menu entries.
Curated query -path:projects/ Graph search applied by the curated reset button.
Curated button label Curated Label shown on the curated reset button.
Show curated button on Show the curated reset button.
Show all-projects button on Show the All projects button.
Show icons on Show per-button lucide icons.
Bar position Top left Dock the bar to the top left or top right.

Development

npm install      # install dev dependencies (zero runtime deps)
npm run dev      # esbuild watch -> main.js
npm run build    # type-check (tsc --noEmit) + production bundle
npm test         # node:test unit tests for the pure helpers
npm run lint     # eslint (eslint-plugin-obsidianmd + typescript-eslint)

To develop against a real vault, symlink or copy this folder into <vault>/.obsidian/plugins/graph-project-buttons/ and run npm run dev.

See docs/architecture.md for how the injection, MutationObserver, and search dispatch fit together, and docs/publishing.md for the community-directory submission steps. Contributor guidelines live in CONTRIBUTING.md.

Support

If this plugin is useful to you, you can sponsor its development through GitHub Sponsors. Sponsorship is entirely optional — the plugin stays free and open source either way.

License

MIT © 2026 Daniel Kremen