README file from
GithubLocal Graph Depth
Local graph views always open at depth 1, with the controls panel in the way. This plugin opens them at a depth you choose, with the controls collapsed.
Behavior
- A local graph you open gets your configured depth, and its controls panel starts collapsed.
- A pane restored from the saved workspace keeps the depth and controls state it was saved with.
- Moving the depth slider in the plugin settings re-depths every open local graph at once.
- Otherwise what you set by hand wins. The plugin touches each pane once as it opens, and applies a depth only when the pane is still at Obsidian's default of 1.
Settings
Default depth — a slider from 1 to 5, the same range as the depth slider in the local graph controls. The default is 2. Set it to 1 to leave newly opened graphs alone.
Collapse the graph controls — hides the settings panel when a local graph opens. The gear icon brings it back. On by default.
Installation
From the community plugin list
Settings → Community plugins → Browse → search for "Local Graph Depth" → Install → Enable.
Manual
- Download
main.jsandmanifest.jsonfrom the latest release. - Put both in
<vault>/.obsidian/plugins/local-graph-depth/. - Reload Obsidian, then enable the plugin in Settings → Community plugins.
How it works
A local graph view carries its settings in the options object of its view state: localJumps holds the depth, close collapses the controls panel. On each layout change the plugin looks for local graph panes it has not seen, and writes the keys it wants through view.setState(). The view hands those keys to its graph engine, which is the same route the depth slider and the close button take, so the controls, the options and the rendered graph all stay in step.
Only getState() and setState() are used, both public API. The options keys themselves are undocumented, but they are the format Obsidian persists in workspace.json. If a future release renames them the plugin stops applying its defaults, and fails quietly: the graph still opens, at depth 1.
Tested against Obsidian 1.8.4.
License
MIT