VisualDirSize 1.3
Content
- Description
- Installation
- Location of VisualDirSize.ini
- Usage
- FAQ
- Charts
- Scan Filtering
- Report Generating
- Configuration Dialog
- History
- License
- Author
1) Description
VisualDirSize provide a graphical overview of the files/folders in a selected directory.
You can view a chart by putting cursor on any directory and pressing 'Ctrl+Q'.
Selected directory will be scanned and files/folders size will be displayed as a bar chart in the Quick View panel. Such bar chart is useful for showing the relative size of files/folders.
For instance: you can quickly locate the biggest file/folder in directory.
Warning: Because the way how the plugin works, it's not recommended to use it on very big directories - delays might be pretty significant.
2) Installation
a) TC 5.51
Copy visualdirsize.wlx file into your Total Commander plugins directory. Next add the following line to [ListerPlugins] section in the wincmd.ini file:
0=C:\totalcmd\plugins\visualdirsize.wlx (Change path to your real one )
b) TC 6.5 and newer
This version of TC has "auto install plugin" feature. Just enter to archive with plugin and TC ask you about plugin installing.
3) Location of VisualDirSize.ini
VisualDirSize.ini will 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
- Plugin directory
- Total Commander directory
4) Usage
Put cursor on any directory then press 'Ctrl+Q'. Remark: there is no possible to execute plugin with F3 - plugin works ONLY with Ctrl+Q.
You can use the cursor keys and Home, End, PgUp and PgDn or SPACE to scroll trough the bars.
You can mouse double-click a graph to drill into the corresponding subfolder and right double-click to go to parent folder.
To abort scanning simply press longer ESC key.
5) FAQ
Question: I don't understand how can be used this plugin. When I press CTRL+Q quick view panel appear, not graphical overview offered by this plugin. What I do wrong ?
Answer: If after pressing Ctrl+Q there is still the Total Commander default list displayed for a directory entry, showing the directory info in plain text, move VisualDirSize higher up in the list of installed Lister plugins.
Question: 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.
Answer: Well, in fact plugin starts to read all directories you put cursor on them. You simply have to wait until plugin scan selected directory and then select next directory.
6) Charts
VisualDirSize can visualize folder sizes in four types of charts. A chart always shows the size of the subfolders of the currently selected folder.
Charts can be sorted by size/name and show the size/percent/number of files dependant on what kind of view type the user selected in the toolbar.
Double-clicking a bar will drill into the associated folder.
| Bar chart |
represent the results of scanning of the currently selected drive/folder graphically, with a bars graph. |
| Pie chart |
represent the results of scanning of the currently selected drive/folder graphically, with a pie graph. In this mode small file/folders may be summarized in a slice named 'Other'. |
| Block chart |
represent the results of scanning of the currently selected drive/folder graphically, with colored blocks. If the block represents a directory, next to him are displayed blocks representing all files contained within that directory and any subdirectories. Any directories that are too small to display on there own get lumped together. |
| Extensions chart |
represent the results of scanning of the currently selected drive/folder in words with a bars graph, generalized by file types (extensions). |
7) Scan Filtering
Scan Filtering feature allows you to filter the scanned files and folders. With scan filtering,
you can specify precisely which files should be included in charts. So if you want can get information
about certain file types only, for example graphic files, use the filter "*.jpg *.gif" here.
| File name masks |
In this field, you can enter the search mask for the files you want to find.
Names with spaces MUST be put in double quotes, e.g. "Letter to Mr. Smith.doc", otherwise VisualDirSize would look for the name parts individually. You can use multiple filters separated by semi-colon or space.
Examples:
*.txt; *.exe (*.txt *.exe) finds all files with txt or exe extension
*.ini finds for example win.ini
Smith finds "Letter to Mr. Smith.doc"
Excluded masks are placed after "|".
Example:
w*.* | *.bak finds files, which start with w and do not end with .bak'
To Include/Exclude certain directories in the search their names must have a trailing backslash \.
Example:
windows\ system32\ *.ini finds ini files only in windows\ and system32 dirs'
*.ini | windows\ finds all ini files except those in directories called "Windows" and their subdirs.
|
| TC Searches |
Use the TC Searches button to the left of the screen to see Total Commander saved search parameters for frequent searches. |
| Use regular expressions |
Search in file names using regular expressions. |
| Exclude matching files |
Exclude (rather than include) matching files. |
This 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 report exporting capabilities built into it. Exported report contents can often be imported or otherwise consumed by third-party applications for 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 report |
Save the collected data to a tab separated text file that can be imported by applications such as Microsoft Excel. |
| Only image |
The main application chart can be exported directly as an JPEG image file. |
Report exporting functionality can be accessed by pressing “Generate report” button.
9) Configuration Dialog
| External icon library |
This option allows you to choose external library from witch will be loaded default icons for files and directories. (you can use also %COMMANDER_PATH% variable in path). |
| Background color |
Select the background color for charts. |
| Font color |
Use this option to select the text color for charts. |
| Change font |
Choose a font for charts in VisualDirSize. The font can be bold or normal, italic is NOT supported. |
| Sort like WinXP |
Uses mixed lexical and numerical sorting, e.g. file10.txt comes AFTER file1.txt. This option works only in Windows XP, in other systems it's normal sorting. |
| Import TC Settings |
Import above settings from current Total Commander instance. |
| ColourTheme_x |
You can select color setting for charts from that list. |
| Max Hue, Min Hue, Saturation, Lightness |
Color theme for bars. All values are in HSL (Hue, Saturation, Lightness). Bars' colors will be generated from
(Max Hue, Saturation, Lightness) to (Min Hue, Saturation, Lightness) in HSL. |
| Save current schema |
Here you can save current colors setting. It will be append to the end of the ColourTheme_x list. |
| Don’t show more bars than |
Sets how many bars are displayed (default = 500). Reason:
Plugin scan all files and folders in selected directory but only first 500 are displayed, because on slower machines appears problem with refreshing. If your computer is powerful enough you can raise that value.
|
| Scale factor in Block mode |
This option allows you to specify how much directory information gets "lumped" together.
A scale factor of 1 will draw exactly to the boundaries of the VisualDirSize plugin window.
A scale factor of 2 will draw twice as much information as can be displayed in the plugin window. |
| Launch browser after HTML report is generated |
Automatically opens HTML exports in the default web browser after generation is complete. |
| Language |
Allows you to choose a language from the list. If you’d like to translate VisualDirSize to your language please email me. If your language isn't included in package contact me by email. |
10) History
1.3 beta4 [10.03.2007]
- Added. Plugin now implements ListLoadNext function to avoid flickering
- Added little red marker to show where the splitter is located
- Added new icons in toolbar to look more like TC 7.0
- Added implementation of ListGetDetectString - plugin is loaded only when necessary.
- Fixed. 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]
- Added block chart. The idea of this mode is taken from great DirGraph program.
You can download it here: http://www.spillett.net/~dirgraph/
- Added new option in Configuration "Scale factor in Block mode".
- Added. Scan Filtering also works in block mode.
- Added. Now it's possible to use wildcards in folder names when using Scan Filtering.
- Fixed small errors in Configuration.
- Added new help file rewritten in HTML.
- Some other small improvements.
1.2 [03.17.2006]
- Updated LNG files
1.2 beta2 [03.05.2006]
- Added button to go to parent folder.
- Changed default font for dialogs to Tahoma. Therefore plugin probably don't run in Win95.
- Fixed. Sometimes plugin didn't get values from wincmd.ini after pressing "TC Searches" button.
- Fixed. File name masks history extended to 20 entries in Scan Filtering dialog.
- Fixed. Sometimes plugin didn't display bold font in "Show only directories" mode
- Fixed. Plugin now import the colors and font from the TC file panel setting not TC lister settings.
- Fixed problem with saving pie chart.
1.2 beta1 [02.04.2006]
- Added Filter option
- Plugin currently works in Win95 WITH IE4.0 and above because of using PathMatchSpec API function.
MatchesMask() included in Delphi 7 contain still not corrected bug with "?".
See http://qc.borland.com/wc/qcmain.aspx?d=5744
- Added possibility do change font in graphs
- Added hint when resize filename column in the bar chart.
- Plugin now works on [..] and show the chart for the current directory
Note: plugin isn't loaded when put cursor on ".." in first directory on drive (like c:\directory\)
because of TC lister plugin interface bug. Ghisler is informed about this.
- Fixed problem with displaying too long path
- Fixed problem with displaying 120 DPI fonts
- Fixed problem with detecting "wincmd.ini" location. Now it's possible to get settings from TC Power Pack (extended edition of Total Commander)
- Some small fixes
1.1 beta5 [11.01.2005]
- Fixed problem with hiding config window
- Fixed. Plugin should be more stable when switching folders fast
- Some small fixes and internal improvements
1.1 beta4 [10.17.2005]
- Some bug fixes and internal improvements
1.1 beta3 [10.14.2005]
- Added Button to on/off watch changes in currently scanned directory (removed this option from configuration)
- Added In Configuration checkbox to on/off automatically launch browser after HTML report is generated
- Removed visualdirsize.ini from distribution
- Fixed Sometimes buttons on button bar were not visible
- Some small fixes and internal improvements
1.1 beta2 [10.10.2005]
- Changed plugin name to "VisualDirSize". Previous name sounds too similar to other TC plugins and commercial programs
- Added possibility to sort by number of files in directory
- Added option to group by extension.
- Added report generation function. There is three possible report types: HTML, plain text and graph image.
- Added possibility to resize filename 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 smaller). Let up on the mouse button when the filename column is wide enough. Double click left bar border to resize filename column to default position.
- Changed default location for VisualDirSize.ini. Now visualdirsize.ini will be saved in the same directory as 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
* Plugin directory
* Total Commander directory
- Added option to watch changes in currently scanned directory. (works like WatchDirs=1 in wincmd.ini)
It's not recommended to use this option on directories that changes regularly like firewall log directory or browser cache directory.
- Fixed Plugin should works in systems older than WinXP
1.1 beta1 [09.01.2005]
- Added buttonbar
- Added pie chart
- Added possibility to go thru catalogs
- Added double-click a graph to drill into the corresponding subfolder
- Added right double-click to go to parent folder
- Added configuration dialog
- Support for language files
- Support for colors schemas
- Added option to sort directories/files names like WinXp do. (works like SortUpper=3 in wincmd.ini).
In other systems it's normal sorting.
- Fixed Sometimes it was necessary to hold Esc key for long to stop calculating folder size
- Other small improvements and fixes
1.0 [08.17.2005]
- Fixed problem with alpha blended icons in WinXP
- Fixed bug in scan code -> VisualDirSize sometimes showed wrong sizes
- Fixed bug when using %COMMANDER_PATH% -> on close VisualDirSize overwrote the %COMMANDER_PATH% by the real path of IcoLibPath.
- Some other small corrections
1.0 beta3 [08.13.2005]
- Added option to show only directories (key 'S', show with files key 'A')
- Added display total size of examined directory
- Added real-time scrolling
- Added Esc key when calculating folder size to cancel the operation
- Added option to show percents instead file sizes (key 'Z')
- Added option to show bars sorted by name (key 'X')
- Some small corrections
1.0 beta2 [08.10.2005]
- Fixed displaying very big files/directories
- Added possibility to use %COMMANDER_PATH% in IcoLibPath
1.0 beta [08.08.2005]
- Initial public release
11) License
These software are provided "as-is". No warranty provided. You use this program at your own risk. The author will not response for data loss, damages, etc. while using or misusing this software. This plugin is freeware.
12) Author
Karol Zoladek (kzoladek@o2.pl)
Or visit official Total Commander Forum (http://www.ghisler.ch)
|