ShellDetails 1.07
ShellDetails is a Content plugin for Total Commander.
Content
- Plugin description
- System requirements
- Directories for field search
- Field settings
- ShellDetails.ini location
- Troubleshooting
- Known bugs and limitations
- Version history
- Author contact
1. Plugin description
ShellDetails displays all Windows Explorer fields in Total Commander.
In addition to standard fields like Name, Size, Type, Attributes, several date/time fields and many others are available.
The Owner of a file can be displayed as well as (number of) Pages in documents like TIFF or DOC.
Especially interesting for searching are meta data information like Author, Title, Category and Comment.
For music files fields like Copyright, Interpreter, Album Title, Year, Title Number, Song Category, Length and Protected should be relevant. Some of these fields are also supported for video files.
In the category pictures there are the fields Camera Model, Picture Captured On and Dimensions. Not only dimensions of JPEG pictures are supported. Many other picture formats are supported as well.
We also have the properties of applications and libraries like Company, Description, File Version, Product Name and Product Version.
These are just the internal fields. If you have any ShellExtensions installed that provide additional fields they will be displayed as well. Here are some examples:
Hint: The field names used here are taken from a German Windows XP installation. I translated them to English. The original English names will be different for some fields. Some field names are slidely different on Windows 2000.
2. System requirements
You need Total Commander 6.50 or higher for this plugin.
The current supported operating systems are Windows 2000, XP and 2003.
If you install ShellDetails on other Operating systems no fields are provided.
3. Directories for field search
Which fields are available for displaying differs from directory to directory. For this reason the plugin offers to set the directories where to search for fields. As an example the fields provided by the program TortoiseCVS are only available in directories which are under CVS control. If TortoiseCVS is used and the directory C:\MyProject is under CVS control you may add this line to your ShellDetails.ini configuration file:
[Directories]
Dir_1=C:\MyProject
It's not necessary to add an additional directory which contains the common directories. If no directory is set by the user ShellDetails will search for fields in the Windows directory.
4. Field Settings
ShellDetails will create a settings file called ShellDetails.ini. You can use it to define datatype conversions (casting), calculations and other settings. Each section is named with a unique name to identify the field. You don't have to and should not edit the section titles. It can contain the following entries:
Default Value |
Possible values |
Description |
UseDefault=1 |
0, 1 |
Set to 0 will enable custom casting and calculations. Otherwise the default field type will be used. |
Cast=1 |
2, 5, 10 |
This is the target field type. 2=numeric value, 5=time, 10=DateTime. |
Operator=47 |
47 |
The only allowed settings here is 47 which stands for /. That means division is currently the only supported operation. |
Processing=0 |
>= 1 |
A numeric value greater than 0. |
Caption |
|
The caption which is displayed to the user in Total Commander. |
Here are some useful examples for built-in Explorer fields:
;Displays the file size as KB.
[{B725F130-47EF-101A-A5F1-02608C9EEBAC}12]
UseDefault=0
Cast=2
Operator=47
Operand=1024
;Displays the length of video and audio files as time value.
[{64440490-4C8B-11D1-8B70-080036B11A03}3]
UseDefault=0
Cast=5
Operator=47
Operand=10000000
;Displays the bitrate for audio files as kbits/sec. The field will be shown "on demand".
[{64440490-4C8B-11D1-8B70-080036B11A03}4]
UseDefault=0
Cast=2
Operator=47
Operand=1000
Processing=3
;Corrects the Explorer error that the original image date is extracted as string value.
[{14B81DA1-0135-4D31-96D9-6CBFC9671A99}36867]
UseDefault=0
Cast=10
;Untitled field caption set to "Width" and casted to numeric value.
[{6444048F-4C8B-11D1-8B70-080036B11A03}3] UseDefault=0 Caption=Width Cast=2
5. ShellDetails.ini location
ShellDetails.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 ShellDetails relative to the directory where Wincmd.ini is located
- Plugin directory
- Total Commander directory
6. Troubleshooting
- Question: A field is not provided by the plugin but can be selected in Explorer column configuration. What can I do?
Answer: Please check section 3. Directories for field search. This section explains how to add the missing fields.
- Question: A field is not displayed or not displayed as expected. What can I do?
Answer: Please start your Windows Explorer and add this column there. If the column values aren't shown here too then it's defintely not a bug in my plugin. In all other cases please report the problem to me.
7. Known bugs and limitations
- Date values display differs by a few seconds. This is caused by the way the column interface provided by Windows stores the date values. Windows Explorer has the same problem.
- If you have a single file in a directory and the file information to be displayed is updated you need to reenter the directory.
8. Version history
Version 1.07 |
|
FIXED |
The field type had been detected incorrectly in some cases which led to field detection abortion. |
|
|
Version 1.06 |
|
FIXED |
If no directory is set manually for field search newly installed shell extensions were not recognized. |
CHANGED |
Plugin is no longer compressed with UPX. This caused troubles on some systems. |
CHANGED |
The default path for ShellDetails.ini is now the directory were Wincmd.ini is located. |
|
|
Version 1.05 |
|
FIXED |
Refresh didn't work properly. |
ADDED |
You can now change the caption for every field. |
FIXED |
The settings has not been saved in some cases. |
ADDED |
If a Shell Extension was installed that contained invalid characters in a field name an error message was displayed. These invalid characters are replaced by an underscore character. |
|
|
Version 1.04 |
|
FIXED |
Some resource leaks have been fixed. |
ADDED |
Support for untitled columns has been added. |
CHANGED |
Speed improvements especially when many columns are displayed. |
|
|
Version 1.03 |
|
ADDED |
ShellDetails supports now background processing for custom column view. |
ADDED |
New field setting "Processing" added. See "Field Settings" for more information. |
|
|
Version 1.02 |
|
FIXED |
file type of folders wasn't displayed correctly. |
FIXED |
Plugin crashed on Windows 9x and Windows NT 4. That doesn't mean it works now on these operating systems. No fields should be available. |
FIXED |
Plugin crashed when entering some special folders. |
ADDED |
Added support for numeric field value types as well as DateTime and Time values types. |
ADDED |
Added support for field settings. See "Field Settings" for more information. |
|
|
Version 1.01 |
|
CHANGED |
Plugin is many times faster than 1.00 |
FIXED |
Fields values are now displayed always in the right field. |
FIXED |
Extra fields for *.lnk files are now displayed. |
|
|
Version 1.00 |
Initial release |
9. Author contact
Visit the Total Commander Forum. Copyright (C) 2004, 2005 Lefteous, All rights reserved. This Total Commander plugin is copyrighted freeware. |