Vault Graph

Your whole vault as one disc.

Project maintained by luke321 Hosted on GitHub Pages — Theme by mattgraham

Feature gallery

A short clip per feature — instead of one hero trying to show the whole vault at once. assets/demo.webp at the top of the README is still the full walkthrough; this page is the same page, broken into pieces small enough to actually watch.

New in 2.9.0 — Folder order


The disc	The disc, growing · Subfolders · Reading each folder’s share · Unlinked notes join their folder · Folder order
Reading a note	Reading one note · Pin a note to the hub
Navigation	Walking the links, and back · The camera
Narrowing what is shown	Grouping by tag · Filtering by folder · A folder hidden by default
Time	The timeline · The heatmap · The recent lens · Compact date axis
Colour	Folder colours · Subfolder colours
Fitting the window	Folding the panels away · The disc on a phone

Regeneration commands for each clip live alongside its source, not here — see docs/features/.

The disc

The disc, growing

Every note is a dot; every top-level folder owns a wedge of the circle whose angle is its share of the vault. The layout is deterministic — no simulation, no seed — so the same vault always draws the same picture. Refresh replays the vault growing from its first note to now.

Refresh clicked, the whole vault regrowing from its first note to now while the date ribbon's range handle sweeps along with it

Subfolders

Open a folder’s twisty to reach the subfolders inside it — tinted from the parent’s hue, hoverable and clickable the same way a top-level folder is.

A folder's twisty opened to reach its subfolders, one hovered to find it on the disc, then clicked to halo it and push its sub-wedge out, then let back down and folded away

Each row whose count is a plain number draws a 2px rule along the bottom, in that folder’s own colour. The largest folder currently shown fills its row and every other bar is read against it, so the scale is always something on screen. Hide that folder and the next one grows into its place; a hidden folder draws no bar at all, so soloing one leaves exactly a single bar. The bars ride the cascade’s own clock, walking and shrinking with the disc rather than snapping.

The folder list zoomed in, each row carrying a coloured bar under its name sized to its share of the largest folder shown, then one folder soloed and every other bar shrinking away to nothing

Unlinked notes join their folder

A note with no links at all joins its own folder’s group by default — same wedge, same colour, same everything as any other note filed there. Right-click the (unlinked) row, always the last one in the legend, and switch off its “Joins its folder” toggle to pull unlinked notes back into their own population instead: one flat grey swatch, its own wedge, a parenthesised count. A third toggle, “Colour by folder”, appears one row further down once the group actually holds someone, for a note that stays in that population but still wants its own folder’s tint — the row’s own swatch turns into a gradient of whatever colours are actually in play.

The (unlinked) row right-clicked to keep its notes separate instead of joining their folder, the wedges reallocating around a new group, then right-clicked again to colour those notes by their own folder anyway, and both toggles put back

Folder order

Wedges and the legend run in name order by default. Switch Folder order in the gear menu to File explorer and they follow your vault’s own Custom File Explorer Sorting spec instead — pinned names first, then whatever ascending or descending order the spec sets — or to Size, biggest folder first. Root notes take their place among the folders under either mode rather than always sitting first or last. Only the top-level wedges and the legend follow the chosen order; a folder’s own subfolders stay ordered by size, which is what gives its fan of tints their gradient.

Settings opened, Folder order switched from Name to File explorer so the wedges and the legend reorder to match the vault's own custom-sort spec, then switched back to Name

Reading a note

Reading one note

Hover a note to raise it and dim everything unconnected to it. Click it and the sidebar switches to its reading — folder, type, tags, word count, linked notes, each one clickable to jump across the disc. The card sits in the sidebar rather than over the graph, so the disc stays whole while you read it; the tab strip says Groups or Selected note, and the card’s close button or a click on empty stage goes back to the groupings.

A daily note hovered, then a meeting note hovered, each raising and haloing its own links while the rest of the disc dims

Pin a note to the hub

Drag a note into the hole at the centre, right-click it, or open its own detail card and click Pin to hub — three ways to hold up to thirteen notes together in the hub, out of the ring. The ring closes around wherever a pinned note came from, and reopens the moment it is unpinned.

A note dragged into the hole to pin it, a second note right-clicked to pin it the other way, and a third pinned from its own detail card, whose panel is then closed

Walking the links, and back

The linked notes on a card are clickable, and clicking one walks the graph — a hop. Each hop is remembered: the card grows a back arrow and a trail of where you came from, oldest first, folded to the first and the last two once the walk gets long. The arrow steps back one hop; any crumb jumps straight to that note and drops everything after it. A crumb whose note a filter or the date range is currently hiding greys out and stays clickable. Opening a note from the disc or the search box starts a new walk, and closing the card ends it.

A card opened on a well-linked note, four of its linked notes clicked in turn so the trail grows a back arrow and crumbs, folded to the first and the last two, then two steps back with the arrow and a jump straight to the first crumb, which truncates the walk there

The camera

Scroll to zoom, drag to pan, double-click or the corner button to reset.

Scrolling to zoom in, dragging to pan, double-clicking to reset, zooming in again, then the corner button resetting it

Narrowing what is shown

Grouping by tag

The group list’s heading is a segmented control: Folders or Tags. Cut by tag, every note sits in one wedge — the first tag it lists files it, in the order its frontmatter gives, so a note tagged [meeting, project] is in the meeting wedge, and a nested tag such as area/health nests as a sub-wedge of area the way a subfolder does. A note with no tag goes to (untagged), shown in grey. Where a tag’s wedge holds fewer notes than carry the tag, its row says so: 74 filed here, 82 carry this tag. Nesting works the same way it does for folders — open a nested tag’s twisty to reach its sub-tag, click to halo and push it out.

The disc cut by tag instead of by folder, a nested tag's twisty opened to reach its sub-tag, clicked to halo and push the sub-wedge out then let back down, folded away again, and the disc switched back to folders

Switching draws both discs at once: one hand erases the folder disc where it stands, the other lights the tag disc at its seats, with the links, the heat strip and the group list following the notes. The group list’s own rows are the switch’s clock — folder rows drop out as their notes fade, tag rows drop in with their first lit note — and the disc keeps its hub and its rings across the switch.

Filtering by folder

Click a folder in the legend to hide it; the remaining wedges grow back into the angle it vacated and the disc re-packs. Solo a folder to hide everything else in one click. Hide something big enough and the camera reframes to match, as long as you haven’t already panned or zoomed yourself. The same right-click menu also carries hidden by default — its own entry, next.

This is also the clip where the count bars move — see Reading each folder’s share above.

A folder hidden, the disc re-packing to fill the angle it vacated, then the biggest folder right-clicked and hidden by default from its own menu, then one folder soloed to hide everything else, then everything shown again

A folder hidden by default

Some folders are noise most of the time — an archive, a template store, a folder of attachments. Right-click a folder’s row and toggle hidden by default, one row below its colour picker, and it starts hidden every time the disc opens — this session and the next, on whichever host you opened it from. All leaves it alone, so “show everything” no longer quietly overrides the one folder you asked to keep out of the way.

The biggest folder right-clicked in the legend and hidden by default from its own menu, the wedges reallocating around the gap it leaves, then the setting put back

Time

The timeline

A strip under the heatmap band carrying every month of the vault: two handles cap the date range, a pill sets the heatmap’s own 52-week window, and a chip per year jumps straight there. Replaced the sidebar’s old rank slider — the ribbon is the only timeline now.

The date range dragged in by both handles, a year chip hovered and clicked, the heatmap's own window slid back and forward on its own, then the date range cleared

The heatmap

One square per day above the disc, coloured from what landed in it. Hover a day to halo its notes on the disc; click to keep the mark.

The busiest day hovered, then two more, each haloing its notes on the disc, then the busiest day clicked to keep the mark, and clicked again to let it go

The recent lens

Three chips under the band — Today, Last 7 and Since last open — halo the notes from a recent window wherever they sit on the disc, and dim everything else a little. Nothing moves. Last 7 is a rolling seven days, Since last open appears only inside Obsidian, and the band counts either date, Added or Touched, with every chip saying which one it means.

Today clicked and the notes added that day haloed while the rest of the disc dims, then Last 7 widening the window, the band switched to count by Touched and back to Added, and the chip clicked again to let the lens go

Compact date axis

Years and months on the strip draw by how many notes they hold, not by the calendar. A sparse year collapses toward the same narrow width every other sparse year gets; a busy one keeps growing to fit what it actually holds. Off, in the gear or the icon beside the date fields, gives every year and month back its plain calendar width.

The compact axis toggled off, spreading every year and month back to plain calendar width, then toggled back on to regather around where the notes actually are

Colour

Folder colours

Folders are coloured from twelve slots — ten hues and two greys — handed out in folder order and round again. Right-click a folder in the legend for the same twelve-swatch picker at the row itself, no settings panel needed: click a slot to hold that folder to a colour, Auto hands it back to its positional slot. Setting one folder never changes another, and two folders may share a colour — useful for saying they belong together.

Two folders right-clicked in turn, each given a colour of its own from the picker, then both put back to automatic

Subfolder colours

The same right-click colour menu a top-level folder’s row opens, reached from a subfolder’s row instead — recolour “People” inside “03 - Resources” without touching its parent’s own hue. The row only exists once its folder’s twisty is open, the same precondition the subfolders feature needs. Auto hands the tint back to whatever the parent folder and position would give it anyway.

A folder unfolded to reach a subfolder, that subfolder right-clicked for its own colour menu, given a colour, then put back to automatic

Fitting the window

Folding the panels away

Two buttons at the top left of the disc: one folds the folder list, search and view buttons away, the other folds the notes-added calendar and its date strip. Fold both and the disc has the window to itself, and however you leave it is how the graph opens next time. On a phone the folder list is summoned as a sheet over the disc; on a PC it is a column beside it, so it collapses and hands its width to the graph. Only the calendar’s fold makes the dots bigger — the disc is fitted to the shorter side of the window, and on a landscape monitor that is the height the calendar is eating.

The disc on a phone

A finger drives the disc: one finger pans, two pinch about their midpoint, a tap raises a note and opens its card, and a double-tap fits the disc back into view. Below 720 px the layout changes to match — the disc takes the screen, the folders, search and view buttons slide up as a sheet from two buttons at the top left, the calendar stays on and can be put away, and a note’s card rises as a sheet at the foot so the disc is still visible above what you tapped.

A phone-sized window with a fingertip for a pointer, each tap leaving a ring: the disc zoomed in until its dots are finger-sized, a note tapped so its card rises as a sheet at the foot, the folder list slid up as a sheet, one folder soloed from inside it, the sheet put away so the rest recedes, then a double-tap fitting what is left back into view