DIRGRAPH 1.3.5
Disc Usage Analyser
For when you need to know where all those Gigs have vanished to...
Source-code now available

New in v1.3.5:

Having finally had chance to play with DirGraph on a Windows 2000 machine, the bugs re: 'permission denied' errors on windows 2000/XP when scanning entire NTFS drives are now fixed

Contents:  

Introduction | What is it? | Why is it? | It's Free, right? | History | Future
Usage | Download & Install | Requirements | Quick Tour | Options | Notes

To contact the author, use the following e-mail address:
DirGraph135@spillett.net. NOTE: This link is not clickable, as a
SPAM reduction measure, just type the address into your emailer.

Introduction

Control Window

What is DirGraph?

DirGraph provides a graphical view of the space used by your files and directories. It allows you to navigate around this view - zooming in to see greater detail and zooming out to see the bigger picture.

It also supports colour coding its display by file dates, so you can see at a glance how much of the space used is occupied by files that haven't been access for an age [and that should therefor have been committed to back-up storage long ago].

It can be quite interesting to look at your system in this way: for instance did you know your games and mp3 directories was taking that much of you over-all drive space?!! No wonder there wasn't room to install the latest version of PaceMaker...

DirGraph is free to use and distribute, but if you find it or its code useful, the author would appreciate a small donation [just a few $] for his trouble. See below for information about how to do this.

An updated version of DirGraph has been created by Kevin Stokes, who has taken my source and added a number of the features from my TODO list that I never got around to working on. As it is unlikely I will spend more time on DirGraph, his version should probably be considered the 'official' one - as such I've given him some of my 'spare' webspace to host it on.
It can be found at the following location: http://www.spillett.net/~dirgraph.

If you have also created an updated version of DirGraph, let me know and I may link to it from here.
Cheers,
Dave.

Contents

Why is DirGraph?

While trying to find where all the space on an 8Gb network share had gone, I remembered a utility I'd seen many moons previously on a PC running a Unix of some variety. Said utility would have been very useful at that point.

It turned out that over 2Gb of the network drive was taken up by one client directory, which for the most part was full of old database backups. Once some of said backups were deleted and most of the rest archived off to CDs the network suddenly had room to breathe again!

Later I tried but failed to find a Windows utility like the one mentioned above. While there were many utils that would draw a pie-chart of a particular directory, list large files, output a 'du' style text-based output or the same in a Windows tree-view, I couldn't quite find what I was looking for. I'd have happily paid a small amount for a util that did the job.

Having a little free time on my hands [something that doesn't happen nearly often enough!] and an 'itch' to scratch, I wrote my own util that weekend. What started a simple bar-graph quickly became a play-thing and changed to allow navigation through the display, and to include other tweaks [such as updating the screen while a scan is taking place] and options. At the suggestion of a college I added the highlighting function one evening that week and have since fixed a few bugs and added support for displaying more than one drive at a time.

I have been pointed to a Linux utility that performs the same task as DirGraph. It appears to be an enhanced version of the utility I mentioned on DirGraph's main page. The utilty is called XDiskUsage and can be found at http://xdiskusage.sourceforge.net/.

Contents

Is it Free?

DirGraph is free to use and distribute. You can also download the source code, and do with it what you will.

Of course, if you would like to donate a small amount [just a few $] to the author [that's me, BTW], he would be very grateful. For details on how to do this, see below. This is a little experiment to see if MicroPayments do actually work - when I bore of said experiment I will probably release the source-code for DirGraph into the Public Domain.

There is one caveat to the free distribution and use of DirGraph: If you present DirGraph on your web-site you must not link directly to any binary files [graphics or .zips] - feel free to copy them to your website and use your own bandwidth though. A link back to this HTML page would be appreciated though.

Contents

Revision History

Not yet written in human readable form...

Contents

Future?

While there are things I would like to do with DirGraph [including some of the feature additions, feature improvements, and bug-fixes its users have requested I simply don't have time to do this. So that DirGraph can be improved, I have released the source-code.

And before anyone e-mails me and suggests I shouldn't ask for donations if I don't have time to support DirGraph: when I did support it there were 7000+ downloads from my website, countless others from other websites, and many e-mails, and precisely one donation [thanks Tim!].

If I do improve DirGraph for my own uses, I will post the changes on this web-page. If someone else uses the source-code to produce an improved program that is freely available, I will gladly link to their information from here.

Quick Usage Guide

Contents

Download and Install

Download the following file: DG135bin.zip. Unzip this and you will find a single executable [dirgraph.exe]. This file can be placed anywhere you like. To launch DirGraph, run this file. Sorted.

To download the source-code, get the following file: DG135src.zip.

To contact the author, use the following e-mail address: DirGraph@spillett.net. Please note I don't have much free time ATM, so don't respond to support e-mail very quick...

Uninstall

To uninstall, simlpy delete the .exe file. DirGraph store some settings in the registry in the key HCCU\software\vb & VBA\DJS, which you may wish to delete also.

Requirements

DirGraph requires the Visual Basic run-time libraries in order to run. It is compiled against the 'Service-Pack 4' versions, so should be used with these or newer.

If you do not have these libraries [the vast majority of people do have], or are unsure if you have an up-to-date version, please download them from Microsoft's web-site. At the time of writing, the latest versions of these libraries where available in an install package from: http://download.microsoft.com/download/vb60pro/Redist/sp5/WIN98Me/EN-US/VBRun60sp5.exe

I did not include the VB run-times with DirGraph as this would have increased the size of the download from about 36Kb to just under 1.5Mb. This way only those people who need to have to download the bigger chunk.

DirGraph also used the FileSystemObject provided by Microsoft's scripting library. If you have Internet Explorer 4 or above installed on you PC then you will have this.

Contents

Quick Tour

Control Window

When you first start DirGraph, you will see a large empty area, and a small control form that looks like the image you see on the left. The main display area can be resized as you wish and any graph displayed will be resized to fit.

Enter a directory name into the text-box [the last directory you looked at is pre-entered as a default] and click 'Change To'. DirGraph will then scan the specified location and display a graph of the results - if you selected a location that contains a large number of files [i.e. an entire drive], this may take a while to complete. You can enter any path-spec here: drives [such as c:\], directories [c:\windows] and network shares [\\sirius\master]. The image below shows DirGraph displaying 'c:\program files' on my home PC.
Example screen shot
Note: I don't keep much here, as you will no doubt notice. Most of my apps are installed to d:\. This makes backing up the system drive easier.

Note2: The example here shows colour-coded directories - see below to see how to turn this option on.

If you hover you mouse over one of the blocks for a second-or-so, you will see a 'tool-tip' containing information about the object you are interested in, as shown here for c:\program files\microsoft office.

Any directories that are too small to display on there own get clumped together. In the example shown here program files has 68.1Mb in directories that are too small to display on there own. Enlarging the size of the DirGraph may cause some of these small directories to be display, as the available display area increases. Also, blocks are drawn for the files in a directory - program files has 32.7Mb of files in the above example.


Example screen shot 2 You can zoom in to see a directory in detail simply by clicking on it. In the example to the right I am taking a closer look at 'common files'.

You can zoom in to any displayed directory in this way. To zoom out a level, slimply click the out-most directory. For example, clicking 'common files' in the example to the right would return me to viewing 'program files'

If I then clicked 'program files', DirGraph would display 'c:\', as seen below. If you zoom out further than DirGraph has already scanned, it will automatically scan the new directory.

To move to a completely new directory, simply enter the new location into the control form and click 'change to' as before. To force a re-scan of the current view [if you have deleted a block of files for instance], click 'change to' without entering a new location.

Example screen shot 3
There are a number of options that affect the display produced by DirGraph. To access these, click the 'show options' button on the control box. These options are described in detail below.

Contents

Options

Section not yet written...

The only options that really need much explanation are the colour-coding options. These allow directories to be highlighted according to the age of the files they contain. You can set the colours used and the boundaries in days. For example, the default settings highlight directories containing at least on file no more than a day old in yellow. Directories that don't contain any files created in the last year are highlighted in red in the default settings, and so on.

You can highlight by 'last-modified' times, or by 'last-accessed' times. These options can be useful in deciding what to do when you need to make room on a drive. You may want to delete all files older than a year old, unless you use some of the every other day. It can also help to decide which files are simply deleted and which are backed-up first.

Contents

Advanced Notes

Context menu example You can display more than one drive at once in DirGraph. To do so, separate them with semi-colons. For instance: to display the contents of both your c: and d: drives, enter 'c:\;d:\'. You can combine any selection of locations in this way, i.e.: 'c:\;d:\temp;\\gomeisa\xfer', though this option usually makes most sense when used with the roots of local drives.

You can add DirGraph to the context [right-click] menu as shown here. To do this, follow the following procedure:

  1. From any explorer window, select the 'Folder Options' command from the 'View' mnu
  2. Select the 'File Types' tab, and find the item 'file folder' in the file-types list.
  3. Select 'file folder' and click the 'edit' command.
  4. In the resulting dialogue box, click 'New'.
  5. In the 'action' box, enter a name for the new item on the menu [i.e 'DirGraph', or 'Space Consumption Analysis'].
  6. Click the 'OK' and 'Close' buttons until you are back to Explorer.
  7. Now right-click on a folder in Explorer, and your new option will appear.

Contents

Donations

While I am happy for you to freely use and distribute DirGraph and its source code, if you find it useful I would appreciate a small donation...

As stated several times already: you do not have to pay me for DirGraph, but if you find it useful a small donation would be appreciated. Such donations will increase the chance of me releasing the source-code in the near future, and the chance of me freely releasing other utils I have written.

Making a Donation: US$

I have a PayPal account that you could pay into. Click the button on the right to make a donation via PayPal. Fro more information about this facility, contact PayPal or myself at DirGraph135@spillett.net.

This page was created by hand and tested using Internet Explorer 5.5 at screen sizes 800x600 and 1024x768. It should display fine in just about any browser that supports tables [and most that don't], at any resolution or colour depth. If your browser is unhappy with my HTML, let me know.