Help of VisualDirSize 1.3 Synopsis
|
1) Description
- VisualDirSize provides a graphical overview of the files/folders in a selected directory.
- You can view a chart by putting the cursor on any directory and pressing <Ctrl+Q>.
- The selected directory shall be scanned and the sizes of the files¦folders will be displayed as a bar chart in the Quick View panel.
- Such a bar chart is useful to show the relative sizes of files¦folders.
- For instance : you can quickly locate the biggest file¦folder in the directory.
- Because the way in which the plugin works, it's not recommended to use it on very big directories.
- The delays might be pretty significant.
![]()
2) Installation
- TC 5.51
- Copy the <visualdirsize.wlx> file into your Total Commander plugins directory.
- Then add the following line to [ListerPlugins] section in the wincmd.ini file:
- 0=C:\totalcmd\plugins\visualdirsize.wlx (Change the path to your real one )
- TC 6.5 and newer
- This version of TC has an "auto install plugin" feature. Just strike Enter on the archive of the plugin and TC'll ask you whether you want to install it.
Using the free tool TC Plugman, you can also install the plugin very easily for all versions of TC quoted above.
![]()
3) Location of VisualDirSize.ini
- <VisualDirSize.ini> shall be saved in the same directory as <Wincmd.ini> by default.
- If you don't like this location you can simply move the file to one of the following destinations :
- In a subdirectory called "VisualDirSize" relative to the directory where Wincmd.ini is located
- The directory of the Plugin.
- The directory of Total Commander.
![]()
4) Use
- Put the cursor on any directory then press Ctrl+Q.
- It's impossible to execute the plugin with F3 - it works ONLY with Ctrl+Q.
- You can use the arrow-keys
and Home
, End
, PgUp
and PgDn
or SPACE-BAR to scroll trough the bars.
- You can do a mouse left double-click on a graph to land into the corresponding sub-folder and a right double-click to go up towards the parent folder.
- To abort the scanning simply press longer the ESC key.
![]()
5) F. A. Q.
- I don't understand how this plugin can be used. When I press CTRL+Q, the quick view panel appears, but not any graphical overview
- is offered by this plugin. What do I wrong ?
- If after pressing Ctrl+Q there is still the Total Commander default list displayed for a directory-entry, showing the directory info as plain text, move VisualDirSize higher up in the list of the installed Lister plugins.
- Sometimes when moving the cursor FAST up and down the filelist/folder list, the plugin hangs. I guess it is trying to read them all as I navigate upwards or downwards.
- Well, in fact the plugin starts to read all directories on which you put the cursor.
- You have simply to wait until the plugin scans the selected directory and then select the next one.
![]()
6) Charts
- VisualDirSize can visualize the folder sizes in four types of charts. A chart shows always the size of the sub-folders of the currently selected folder.
- The charts can be sorted by size¦name and show the size¦percent¦number of files dependant on which kind of view-type the user selected in the tool-bar.
- Double-clicking on a bar will land into the associated folder.
| Bar chart | Represent the results of scanning the currently selected drive¦folder graphically, with a bar-graph. |
| Pie chart | Represents the results of scanning the currently selected drive¦folder graphically, with a pie (sectors) graph. In this mode small file¦folders may be summarized in a single slice named Other. |
| Block chart | Represents the results of scanning the currently selected drive¦folder graphically, with colored blocks. If the block represents a directory, all files contained within that directory and sub directories are displayed as blocks representing them close it. All directories that are too small to be displayed individually get merged together. |
| Extensions chart | Represents the results of scanning the currently selected drive¦folder as text with a bar-graph, generalized by file types (extensions). |
7) Scan Filtering
![]()
![]()
![]()
- The Scan Filtering feature allows you to filter the scanned files and folders.
- With the scan filtering, you can specify precisely which files would be included in charts.
- So, if you want to get information about certain file-types only, for example graphic files, use the filter "*.jpg *.gif" here.
| File-name masks |
Examples :
Example :
Example :
|
| TC Searches | Use the TC Searches button at the right of the dialogue-box to see the parameters for frequent searches that Total Commander has saved. |
| Use Regular Expressions | Search in file names using the Regular Expressions. |
| Exclude matching files | Exclude (rather than include) matching files. |
These options will not be saved when you exit VisualDirSize in order to avoid wrong results when using it the next time.
8) Report generating
- VisualDirSize has powerful built-in report exporting capabilities.
- Exported report contents can often be imported or otherwise consumed by third-party applications for an additional processing.
- A wide range of export formats are available, including :
| HTML report | Allows you to save a report as HTML file, which can be viewed with any HTML browser later. |
| TXT | Save the collected data to a Tab separated text file that can be imported by applications like Microsoft Excel. |
| Only image | The main application chart can be exported directly as a JPEG image-file. |
Report exporting functionality can be accessed by pressing the “Generate report” button.
9) Configuration Dialogue
10) History
- Caption :
- Added…
- Fixed
- Modified¦Completed
- Removed
- Author's note
- Other note
- 1.3 beta6 [10.12.2007]
- When "Show only directories" option is enabled total size, total number of files are displayed correctly
- Some corrections in Configuration dialog
- Some corrections in Scan Filtering dialog
- Some other small improvements.
- 1.3 beta5 [10.12.2007]
- Added buttons "New schema", "Delete schema" in Configuration dialog
- "New schema" copies actual settings into new schema while "Save current schema" saves changes in active schema
- Mask selected in Scan Filtering is added to button tooltip, so it's possible to see what mask is currently used
- Some corrections in Configuration dialog
- Some corrections in Scan Filtering dialog
- Some other small improvements.
- 1.3 beta4 [10.03.2007]
- Plugin now implements ListLoadNext function to avoid flickering
- Little red marker to show where the splitter is located
- New icons in toolbar to look more like TC 7.0
- Added implementation of ListGetDetectString - plugin is loaded only when necessary.
- Sometimes shadow of the buttons tooltip didn't disappear
- Some stability fixes
- Some other small improvements.
- 1.3 beta3 [07.06.2006]
- Size display. Determines how the file size is shown in charts. You can choose between bytes, kbytes, Mbytes, Gbytes, bkM, bkM2
- Some small fixes and internal improvements
- 1.3 beta2 [05.13.2006]
- Some other small improvements.
- 1.3 beta1 [03.17.2006]
- Block chart. The idea of this mode is taken from the great DirGraph program. You can download it here: http://www.spillett.net/~dirgraph/
- New option in Configuration "Scale factor in Block mode".
- Scan Filtering also works in block mode.
- Now it's possible to use wildcards in folder names when using Scan Filtering.
- Small errors in Configuration.
- New help file rewritten in HTML.
- Some other small improvements.
- 1.2 [03.17.2006]
- Updated LNG files
- 1.2 beta2 [03.05.2006]
- Button to go to the parent folder.
- Default font for dialogs to Tahoma. Therefore plugin probably don't run in (some) Win95.
- Sometimes the plugin didn't get values from «wincmd.ini» after pressing the TC Searches button.
- File name masks history extended to 20 entries in the Scan Filtering dialogue.
- Sometimes the plugin didn't display a bold font in the Show only directories mode
- The plugin now imports the colours and fonts from the TC file panel setting, not TC Lister settings.
- Problem with saving a pie chart.
- 1.2 beta1 [02.04.2006]
- Filter option
- The plugin currently works in Win95 WITH IE4.0 and above because the use of PathMatchSpec API function.
- MatchesMask() included in Delphi 7 contains a non-corrected bug still with ?. See http://qc.borland.com/wc/qcmain.aspx?d=5744
- Possibility to change the font in graphs.
- Hint when resizing the file-name column in the bar chart.
- The plugin works now on [••] and shows the chart for the current directory.
- The plugin isn't loaded when one puts the cursor on ••in the first directory of a drive (like C:\directory\) because a bug in the plugin-interface
- of TC Lister. Mr. Ghisler is informed about this.
- Problem while displaying a too long path.
- Problem while displaying 120 DPI fonts (large fonts)
- Problem to detect the location of «wincmd.ini». Now, it's possible to get settings from the TC Power Pack
- (a unofficial extended edition of Total Commander)
- Some small fixes
- 1.1 beta5 [11.01.2005]
- Problem while hiding the config. window
- The plugin should be more stable when switching folders quickly
- Some small fixes and internal improvements
- 1.1 beta4 [10.17.2005]
- Some bug fixes and internal improvements
- 1.1 beta3 [10.14.2005]
- On¦off button to watch changes in the currently scanned directory
- The aforesaid option from the configuration-dialogue
- In Configuration, a on¦off check-box to launch the browser automatically as soon as the HTML report is available.
- <Visualdirsize.ini> from the distribution
- Sometimes buttons on the button-bar were not visible
- Some small fixes and internal improvements
- 1.1 beta2 [10.10.2005]
- Changed the name of the plugin into VisualDirSize. The previous name sounds too similar to other TC plugins and commercial programs ones
- Possibility to sort by number of files in a directory
- Option to group by extensions.
- Report generation function. There are three possible report types : HTML, plain text and graph image.
- Possibility to resize the file-name column in the bar chart :
- Simply click on the left bar border and drag the mouse to the right (to make wider) or left (to make narrower).
- Loosen the mouse button when the file-name column is wide enough.
- Double click on the left bar border to resize the file-name column to the default position.
- Default location for <VisualDirSize.ini>. Now, <visualdirsize.ini> shall be saved in the same directory than <wincmd.ini>
- If you don't like this location, you can simply move the file to one of the following destinations :
- In a subdirectory called VisualDirSize relative to the directory where wincmd.ini is located
- The directory of the plugin
- The directory of Total Commander
- Option to watch changes in the currently scanned directory (works like WatchDirs=1 in «wincmd.ini»)
- It's not recommended to use this option on directories that changes regularly like a firewall-log directory or a browser-cache directory.
- Plugin should works in systems older than WinXP
- 1.1 beta1 [09.01.2005]
- Button-bar
- Pie chart
- Possibility to go through catalogs
- Double-click a graph to land into the corresponding sub-folder
- Right double-click to go to the parent folder
- Configuration-dialogue
- Support for language files
- Support for colours schemes
- Option to sort the directories¦files names like WinXp does (works like SortUpper=3 in «wincmd.ini»).
- In other systems it's normal sorting.
- This is not quite true
- Sometimes, it was necessary to hold the Esc key for long to stop a folder-size calculation
- Other small improvements and fixes
- 1.0 [08.17.2005]
- Problem with alpha blended icons in WinXP
- Bug in the scan code
VisualDirSize sometimes showed wrong sizes
- Bug when using %COMMANDER_PATH%
On close, VisualDirSize overwrote the %COMMANDER_PATH% with the real path of IcoLibPath.
- Some other small corrections
- 1.0 beta3 [08.13.2005]
- Option to show only directories (key S, show with files key A)
- Displays the total size of the examined directory
- Real-time scrolling
- Esc key to cancel the operation when calculating a folder size.
- Option to show Percents instead file-sizes (key Z)
- Option to show bars sorted by name (key X)
- Some small corrections
- 1.0 beta2 [08.10.2005]
- Display of very big files¦directories
- Possibility to use %COMMANDER_PATH% in IcoLibPath
- 1.0 beta [08.08.2005]
- Initial public release
![]()
11) Licence
- This software is provided as-is. No warranty provided. You use this programme at your own risk.
- The author shall not response for data loss, damages, etc. while using or misusing this software.
- According to the in force laws of some countries, the aforesaid statement might value *peanuts* -Clo-.
- This plugin is freeware.
12) Author
Or visit the official Total Commander Forum