dv is a command line tool for visualizing disk data usage on systems that don't have access to a graphical environment. After scanning a directory, dv generates an interactive webpage that displays useful information about the disk's contents. This webpage is a sunburst partition layout, where each subdirectory is displayed as a portion of the scanned directory.
Hovering over a directory shows its size and percentage of the whole. dv is multiprocessed, and can be used to quickly visualize what is taking up space on a system.
Check out a pre-generated plot.
dv has several options that can be explored with
dv --helpTo get started as quickly as possible with a basic directory scan and plot, download this repository, cd to the python directory, and run:
python3 dv.py <directory-to-scan> --save-and-host <directory-to-store-plot>If on windows, head over to the "release" section and get the latest windows build. Place it alongside dv.py and run:
dv.exe <directory-to-scan> --save-and-host <directory-to-store-plot>In addition to the D3.js-based web visualization, dv now includes a Python-based visualization module using Plotly for enhanced interactivity:
# Install dependencies
pip install -r requirements.txt
# Visualize scan results
python python/visualization/integration_example.py scan.json -o output.html --summaryFeatures:
- Interactive Sunburst Chart: Fully interactive Plotly-based visualization
- Dual Metrics: Toggle between size (bytes) and file count views
- Age-Based Fading: Visualize file age with adjustable opacity sliders
- Multiple Themes: 8 color schemes (Viridis, Blues, Greens, etc.)
- Rich Tooltips: Hover to see detailed path, size, count, and modification time
- Standalone HTML: Export portable HTML files that work offline
See python/visualization/README.md for detailed documentation.