Obsidian Stats logoObsidian Stats

Vault Sunburst - Disk Usage

by n23eos
5
4
3
2
1
Score: 50/100
Install Code

Description

DaisyDisk-style interactive sunburst chart for your Obsidian vault: disk usage, word count and file count by folder. Animated zoom, 13 languages.

Reviews

No reviews yet.

Stats

2
stars
177
downloads
0
forks
30
days
1
days
30
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
8
commits

Latest Version

1.0.3
a month ago

Changelog

Packaging release. No user-facing feature changes.

Release assets are now built in CI and carry GitHub artifact attestations, so anyone can cryptographically verify that main.js, manifest.json and styles.css were built from this repository:

gh attestation verify main.js --repo n23eos/obsidian-vault-sunburst
See all version on GitHub

README file from

Github

Vault Sunburst - Disk Usage

Latest release Stars License: MIT

Vault Sunburst charts an entire Obsidian vault as an interactive sunburst, in the spirit of classic disk-usage analyzers. One chart switches between three metrics: size on disk in bytes, word count in notes, and number of files. Clicking a folder flies into it with animated zoom, while the center, Esc or the breadcrumbs go back up and clicking a file opens it. Sectors morph when the metric changes, hovering highlights a folder together with all its descendants, and the DaisyDisk-style rainbow palette follows the on-screen angle in both light and dark themes. Available in 13 languages, on desktop and mobile.

⭐ Star this repo

If Vault Sunburst helps you make sense of your vault, give it a star — it takes a second and helps other Obsidian users find the plugin.

Vault Sunburst — words mode, dark theme

Features

  • Three metrics, one chart — switch instantly between:
    • Size — sectors proportional to disk usage (bytes);
    • Words — sectors proportional to word count in your notes;
    • Files — sectors proportional to the number of files.
  • Animated zoom — click a folder to fly inside it; click the center, press Esc, or use the breadcrumbs to go back up. Click a file to open it.
  • Smooth transitions everywhere — sweep-in intro, sector morphing when switching metrics, hover highlighting of a folder with all its descendants.
  • DaisyDisk-style rainbow palette — hue follows the on-screen angle, outer rings fade gently. Works in both light and dark themes.
  • Small-file grouping — sectors too thin to see are merged into a single muted "small items" arc, so the chart stays clean at any scale.
  • Context menu — right-click a sector: zoom in, open in a new tab, copy path, show in system explorer.
  • Live updates — the chart rescans automatically when your vault changes (debounced), plus a manual refresh button. Word counts are cached by modification time, so rescans are fast even in large vaults.
  • CJK-aware word counting — Chinese and Japanese text is counted per character, so word counts are meaningful without spaces.

Languages

The UI follows your Obsidian language automatically. 13 languages included: English, Русский, Українська, Deutsch, Français, Español, Italiano, Português, Polski, Türkçe, 中文, 日本語, 한국어.

Plural forms and number formatting follow CLDR rules (Intl.PluralRules, toLocaleString).

Settings

  • Excluded folders — one vault path per line; skipped entirely during scanning (handy for attachments and similar).
  • Ring count — how many nesting levels the chart shows at once (3–8).

Install

From Community Plugins

Once accepted into the directory: Settings → Community plugins → Browse → search for Vault Sunburst.

Manual

  1. Download main.js, manifest.json, styles.css from the latest release.
  2. Put them into <your vault>/.obsidian/plugins/vault-sunburst/.
  3. Reload Obsidian and enable Vault Sunburst in Settings → Community plugins.

Open the chart via the pie-chart ribbon icon or the Open vault chart command.

Development

npm install
npm test        # vitest — 27 tests over the pure modules (layout, geometry, i18n, word counting)
npm run build   # tsc + esbuild → main.js
npm run dev     # watch mode

The zoom is implemented the "zoomable sunburst" way: the angular layout is computed once per metric, and zooming only animates the view window — so navigation stays smooth even in vaults with thousands of files.

License

MIT

По-русски

Интерактивная круговая диаграмма хранилища в стиле DaisyDisk: три режима (размер на диске / количество слов / количество файлов), анимированный зум по папкам, контекстное меню, автообновление, исключение папок и 13 языков интерфейса. Язык подхватывается из настроек Obsidian автоматически.

⭐ Если плагин оказался полезен — поставьте звезду репозиторию, так его найдут другие.

Sponsors