Vault Storage Map – visualize disk usage inside your Obsidian vaul

Share & showcase Workflows & Templates
1

Disclaimer

*Is this project open source? Yes
Is this project completely free? Yes
Is this project vibe-coded beyond the author’s ability to comprehend how it works? No
Community Directory: Vault Storage Map – available in the official Obsidian Community Plugins directory:
https://obsidian.md/plugins?id=vault-storage-map

Vault Storage Map – visualize disk usage inside your Obsidian vault

Hi everyone!

I’m happy to introduce Vault Storage Map – a local-first desktop plugin for visualizing disk usage inside your Obsidian vault.

It helps you quickly understand which folders, files, attachments, indexes, and plugin data are taking up the most space – all without leaving Obsidian.

What it does

Vault Storage Map provides:

  • an interactive treemap with folder drill-down;
  • rankings of the largest folders and files;
  • search and minimum-size filters;
  • file-type storage statistics;
  • comparison with the previous scan;
  • an optional local scan cache;
  • Markdown, CSV, and JSON report export;
  • diagnostic recommendations for large files, attachments, plugin data, indexes, and unreadable entries;
  • light, dark, and system themes;
  • a compact, collapsible details panel.

Privacy

The plugin works locally and does not use telemetry, user accounts, or network requests.

During a scan, it reads filesystem metadata such as:

  • paths;
  • file and folder sizes;
  • file types;
  • modification dates;
  • file and directory counts.

It does not read note contents for storage analysis and does not send vault data anywhere.

The plugin writes files only when necessary:

  • settings;
  • the optional local scan cache;
  • reports explicitly exported by the user.

It never automatically deletes, moves, or modifies vault content.

Interface languages

The interface currently supports:

  • English
  • Russian
  • Simplified Chinese
  • French
  • German
  • Spanish
  • Italian
  • Turkish
  • Hindi
  • Bengali
  • Tamil
  • Portuguese

Proofreading and translation corrections are welcome – especially for Hindi, Bengali, and Tamil.

Requirements

Vault Storage Map is a desktop-only plugin because it uses the local filesystem to calculate actual disk usage.

Symbolic links are not followed by default. They can be enabled manually, but linked directories may point outside the vault and should therefore be used with care.

Installation

Vault Storage Map is available in the official Obsidian Community Plugins directory:

  1. Open Settings → Community plugins → Browse.
  2. Search for Vault Storage Map – or use the link above.
  3. Select Install.
  4. Select Enable.

Usage

  1. Click the hard-drive icon in the ribbon or run Open storage map from the command palette.
  2. Select Scan vault.
  3. Explore the summary, treemap, folders, files, file types, and recommendations.
  4. Select a file, folder, or treemap block to view details.
  5. Export a report when needed.

Support and feedback

The project source code, issue tracker, and releases are available on GitHub:

https://github.com/Dimar4713/vault-storage-map

Bug reports, feature requests, feedback, and translation corrections are always welcome.

I will post all future Vault Storage Map updates in this thread.

Developed by AIMETON · Dimar4713

P.S. As a new user, I’m currently unable to post live links and have placed them in code blocks as advised by the moderators. I will update them to clickable links once my account trust level increases.

1 Like