FEATURES

Here are the features of Directory Lister. Let's start from what is actually the output of the program. (...)

Listing

Listing also called output is the list of directories and files and their attributes enumerated one after another in separate lines.

Example: HTML listing

HTML listing

Example: Text listing

Text listing

(...) To start working with the program, please select a directory in the Select directories window. (...)

Select directories window

You can select which directories you want to list by clicking on white box on the left side of a directory name. The given directory will be selected with or without all of its subdirectories depending on whether 'Select with subdirectories' option is selected or not.
You can override this setting by pressing SHIFT to select a dir with all subdirs, or CTRL key to select only one dir.

The box on the left side of a directory name can be in one of the four following states:
  • Checked white box (Checked white box) - list this directory and all subdirectories recursively,
  • Checked grey box (Checked grey box) - list this directory but not all of its subdirectories (not all could also be none),
  • Grey box (Grey box) - list some of the subdirectories of this directory,
  • White box (White box) - do not list this directory and none of its subdirectories.

(...) Program will automatically show the listing in the Preview window. (...)

Preview window

You can see how the listing will look like in this window. You have an option to copy the contents of the preview window to a clipborad by pressing the Copy button in the Edit menu.

(...) OK, so let's go to the main menu and the toolbar and describe all their functions. (...)

Main menu

All commands are available from the main menu which consists of the following items:

File menu

The File menu offers the following commands:

  • Save listing - Generate and save listing under a specified name.
  • Print listing - Generate and print listing.
  • Send listing - Generate and send listing as e-mail attachment.
  • Quick configuration - Quickly load a configuration file that is saved in Directory Lister Pro directory.
  • Load configuration - Load a previously saved configuration file.
  • Save configuration - Save a configuration file for later use.
  • Load dirs selection - Load a previously saved selection file.
  • Save dirs selection - Save a selection file for later use.
  • Quick HTML style - Load one of the HTML styles saved in Directory Lister Pro directory.
  • Load HTML style - Load only HTML style configuration.
  • Save HTML style - Save HTML style configuration.
  • Print preview - Preview how the listing will look when printed.
  • Print setup - Setup the printer configuration.
  • Cancel - Cancel listing generation.
  • Exit - Exit from the application.

Language menu

The Language menu displays all available languages for user interface. The selected language is immediately applied to the interface.

Edit menu

The Edit menu offers the following commands:

  • Copy - Copy the contents of the preview window listing to a clipboard. If you select a portion of a listing, only that portion is copied to a clipboard.

View menu

The View menu offers the following commands:

  • Split - Set focus to the split bar so you can resize windows.
  • Refresh listing - Generate and show listing.
  • Refresh dirs - Clear directory tree and current dir selection and read its contents again.

Help menu

The Help menu offers the following commands, which provide you assistance with this application:

  • Help Topics - Show an index to topics on which you can get help.
  • Contact support - Send e-mail to support team.
  • Visit homepage - Go to http://www.krksoft.com.
  • Visit forum - Go to Directory Lister Pro forum.
  • About Directory Lister Pro... - Show the 'About' window where you can find registration data and current version number.

Toolbar

The most important commands are available for quick access in the toolbar:

  • Save listing - Generate and save listing under a specified name.
  • Print listing - Generate and print listing.
  • Send listing - Generate and send listing as e-mail attachment.
  • Copy - Copy the contents of the preview window listing to a clipboard. If you select a portion of a listing, only that portion is copied to a clipboard.
  • Refresh listing - Generate and show listing.
  • Cancel - Cancel listing generation.
  • Help Topics - Show an index to topics on which you can get help.
  • Visit homepage - Go to http://www.krksoft.com.
  • Exit - Exit from the application.

(...) The power of Directory Lister Pro is in the myriad of configuration options. Let's review them page by page. (...)

Standard columns page

This page allows you to select standard file properties that will be presented on the listing. There is a variety of different properties you can list. The edit boxes with a spin control to the right of some columns determine the width of particular column in the text listing unless Auto column widths option is selected.

Standard columns group

  • Number - Count and display the numbers in front of each file.
  • Path - Include full path in front of each listing item. After selecting this option, choose what part of the path will be actually displayed using Path option on Format & sorting page.
  • Name - Display file or directory name. This option cannot be unchecked.
  • Extension - Display file extension. Directories are assumed to have no extension (that is '.' is not perceived as extension determinant).
  • Size - Display size for files and total size for directories.
  • Creation date, Last write date, Last access date - Display proper date for a file.
  • Type - Display type as registered in Windows Registry.
  • Attributes - Display one of possible attibutes: read-only, archived, hidden, system, compressed.
  • Owner - Display the user who is the owner of the file.
  • Drive volume label - Display drive volume name on which the file is stored.

Document columns page

This page allows you to display properties of document files. These are usually Microsoft Office documents (.doc, .docx, .xls, .xlsx, .ppt, .pptx extensions), PDF files and also some other file types (eg. .tif files).
These properties can be changed in Windows Explorer when you right click on a file, select Properties menu item and then switch to Details page.
Such properties can also be stored in the NTFS file system which is used on Windows 2000, XP, Vista and 7 operating systems. To see these properties, please select Display NTFS compound properties option on Behavior page.

Only the following properties are available in Directory Lister Standard:

  • Title
  • Subject
  • Author

Multimedia columns page

These columns extract available media information from image (.bmp, .gif, .jpg, .png, .tif), video (.avi, .wma, .mpg, .mkv) and music (.mp3, .mid, .wav, .mka) files.

Only the following properties are available in Directory Lister Standard:

  • Video/Picture format
  • Width
  • Height
  • Audio format
  • Length
  • Title
  • Artist
  • Album

Other columns page

Executable info group

These columns extract executable information from .exe, .dll, .ax, .cpl, .ocx, .sys etc. files. These properties are not available in Directory Lister Standard.

Hashes group

  • CRC32 - Count and display Cyclic Redundancy Check sum using CRC-32-MPEG2 / CRC-32-IEEE 802.3 standard. This produces 8 digit hexadecimal number which is consistent with crc32 value used in zip/rar archives.
  • MD5 - Count and display Message-Digest algorithm 5 hash value presented as 32 digit hexadecimal number.
  • SHA-1 - Count and display Secure Hash Algorithm 1 hash value presented as 40 digit hexadecimal number.
  • Whirlpool - Count and display Whirlpool hash value presented as 128 digit hexadecimal number.

Display page

This page allows you to decide how the listing will look like.

Row options group

  • Directory rows - Display directory rows right before files from this directory.
  • File rows - Display file rows right after directory row.
  • Subdirs - While listing a directory, display its subdirs together with files.
  • Subdirs in front of files - Subdirs will be always listed on the first position, not among other files.
  • Hide empty dirs - Do not display directories which are empty.

Display options group

  • Surround subdirs with < > - Put < in front of subdir name and > at the end.
  • Volume label for drives - Display volume label just after directory name. This is only displayed for root drives (c:, d:, etc.)
  • File count in directory row - Display file count for each directory just after directory name. This information is presented in brackets, except for CSV, where it is in separate column. If you set mask different than '*.*', this number will be counted only from files which match the mask. Subdirectoried are not counted and only files in given directory are counted, without subdirs.
  • Show time in date columns - Display time as part of date columns.
  • End directories with \ - Put a backslash as a last character of each directory. This option only affects directory rows and does not affect subdirectories displayed as part of directory contents.
  • Draw dirs tree - Draw a directories tree from ASCII characters. This option works properly only for text listings, when Hide empty dirs option is disabled, when directories are sorted by name in ascending order and when no filters are applied.
  • Path - Select which portion of path should be displayed:
    • Full - Display whole path
    • No drive - Don't display the drive letter
    • From top-checked dir - Display the path starting from the top-most selected directory. Program will find top-directory which is a common parent directory for all selected directories on the same drive.
    • Top-checked is root - Display the path starting from, but without the top-most selected directory as if it was the root directory. Program will find top-directory which is a common parent directory for all selected directories on the same drive.
    • Current dir only - Display only the current directory, without any parent directory part.
    • From distinct top-checked dir - Display the path starting from the top-most selected directory. Top-selected directory is the first directory which has a white checked mark or gray checked mark.
    • Distint top-checked is root - Display the path starting from, but without the top-most selected directory as if it was the root directory. Top-selected directory is the first directory which has a white checked mark or gray checked mark.
    See the following example of how the listing will look like for different Path options when the following folders on the "d:" drive are selected:

    Full
    Name
    d:\demo\
    example file in demo dir.txt
    d:\demo\first dir\
    example file in first dir.txt
    d:\demo\third dir\
    example file in third dir.txt
    No drive
    Name
    \demo\
    example file in demo dir.txt
    \demo\first dir\
    example file in first dir.txt
    \demo\third dir\
    example file in third dir.txt
    Current dir only
    Name
    demo\
    example file in demo dir.txt
    first dir\
    example file in first dir.txt
    third dir\
    example file in third dir.txt
     
    From top-checked dir
    Name
    \demo\
    example file in demo dir.txt
    \demo\first dir\
    example file in first dir.txt
    \demo\third dir\
    example file in third dir.txt
    Top-checked is root
    Name
    \
    example file in demo dir.txt
    \first dir\
    example file in first dir.txt
    \third dir\
    example file in third dir.txt
     
    From distinct
    top-checked dir

    Name
    \demo\
    example file in demo dir.txt
    \first dir\
    example file in first dir.txt
    \third dir\
    example file in third dir.txt
    Distint top-checked
    is root

    Name
    \
    example file in demo dir.txt
    \
    example file in first dir.txt
    \
    example file in third dir.txt
     

Header options group

  • Display summary - Display total files, directories and size for the whole listing at the top of it or at the bottom.
  • Column names in header - Display column names in front of files.
  • Title - You can provide your custom title that will be displayed in listing header and in HTML <title> HTML tag.
  • Program information in header - Display timestamp, program name and version in the header. This option works after registration only.

Behavior page

This page allows you to control how the program should behave when looking for file properties and during listing generation.

Behavior options group

  • Files treated all together - Treat files as if they were in one directory, that is numbering and sorting is done for all files regardles in which directory they reside. This option is only enabled when Directory rows option is unchecked on Display page.
  • Treat archives as directories - Display .rar and .zip archives contents as if they were normal directories.
  • Count hashes for directories - Generates a hash sum for each directory. This is achieved by counting a hash value from all hash values for the files in a given directory. Before counting this hash value, all files' hash values are sorted so you are able to find out if two directories contain the same files even if they are named differently. Whirlpool hash sum is recommended for doing such comparisons as it provides the most unique hash values.
  • Display NTFS compound properties - This will force to read NTFS file system properties for each file. These properties are not included in the file itself, and are only stored for NTFS drives. This option makes the listing very slow!
  • Recognize numbers while sorting - If several files contain numbers in their names, then these numbers will be recognized by the sorting algorithm and sorted in logical (ascending or descending) order instead of raw ASCII comparison. See the below example how two files will be sorted when this option is checked or unchecked:
    Order when this option is disabled Order when this option is enabled
    My 10 image.jpg My 5 image.jpg
    My 5 image.jpg My 10 image.jpg
  • Listing in each directory - Generate listing in each scanned directory under the name taken from 'Listing name:' edit box. Extension is automatically added.
    WARNING! This file is ALWAYS overwritten so be sure not to choose a name that will delete your own files!
  • Limit recursion level - If you choose 0 for this option then the program will not go into any subdirectory of a selected directory. When you select 1 for this option then the program will go only to subdirectories of a selected directory. When you select 2 for this option the program will enter subdirectories of a selected directory and their subdirectories, but not any furter. And so on. Please note this option means the program will not include and deeper level than selected into any statistics. So this option limits both, how deep to look for directories and (since they are not traversed) the display level of subdirectories.
  • Limit display level - This option causes the program to enter all levels of subdirectories of a selected directory (unless the above option is selected), but any level deeper than selected will not be displayed.

Format & sorting page

This page allows you to select format of certain columns and sorting of columns.

Format options group

  • Date format - Select how the date will look like.
  • Time format - Select how the time will look like.
  • Size display - Display directory and file sizes in Bytes, Kilobytes, Megabytes, Gigabytes or Dynamic - depending on size, in proper measure.
  • Size precision - When you choose 'Size display' other than Bytes this is the number of digits after the decimal point.
  • Thousand separator - Select character used for separate thousands in sizes.
  • Decimal separator - Select character used for separate decimal numbers from integer numbers in sizes.

Files sorting and Dirs sorting groups

Select the sorting order for files and directories here. If two files or directories are equal when compared using "1st sorting column" then "2nd sorting column" is compared and so on. You can also choose descending option for each selection.

Output type page

This page allows you to select output type of a listing.

Output file type group

  • Text file - Generate plain text file.
  • HTML file - Generate HTML file.
  • CSV file - Generate CSV file. This is very useful if you want to open the output in Excel or import it to a database. This option is not available in Standard edition.
  • Database - Stream all data directly into a specified database. This option is only available in Enterprise edition.
  • Encoding - Select whether output should be saved in Unicode format or ANSI format. Usually you don't need to change this option as the UTF-8 format is the best choice.

Text options group

  • Auto column widths - Automatically count column widths based on the longest string in that column.
  • Wrap columns - When column widths are fixed and a column string exceeds given width, it will be wrapped to the next (and more) lines.

HTML options group

  • Generate links to files - Generate links to actual files. Normally, path is copied into HREF part of a tag, except for Path: From top-checked dir and Top-checked is root options. In these cases HREF part does not contain leading '\' char, so you can browse subfolders when copied to appropriate directory.
  • Generate links to dirs - Generate links to actual directories. The same rule takes effect as for files.
  • Put file:// into links - Insert "file://" into html <a> tag. This is for browsing local files in Opera and Firefox browsers.
  • Links to subdirs inside listing - Create links to the place in the current listing where a particular subdir contents are listed.
  • Include external CSS - You can provide your custom CSS file that will be included just after default CSS definitions within the <style> HTML tag. Specify only the styles themselves, without any HTML tags.
  • Element - Choose a HTML element here for which you can change Font, Color and Size.

CSV options group

  • Separator - A character used for separating columns in CSV file. If separator is present in a particular column then this column is surrounded with double quotation marks (").
  • Tab - Use Tab character as separator, thus you can open the output file in eg. Excel.

Column order page

This page allows you to select order of columns in a listing.

Column order group

Select order of columns from left to right. Also when you select a column you can set its alignment to the left or right side of space determined by column width. This only works for text listings.

Filters page

Name filter group

Only files which match the mask from Include files option and which don't match the mask from Exclude files option will be listed. This mask has no influence on processed directories. It concerns files only. You can specify multiple masks separating them with ';' e.g: '*.avi;*.txt' Wildcards ('*?') are allowed.
Example: Files starting from 'a', having 4 characters in name and any extension: a???.*

Date filter group

List only files that were created / last written / last accessed after or before given date or files older / newer then specified amount of seconds, days, months, years.

Size filter group

List only files that are between a specified size.

Attributes filter group

List only files with given attribute set or unset. The checkboxes take the following 3 values:

  • Checked - Only files with the specified attribute will be listed
  • Indeterminate - Ignore the specified attribute filter
  • Unchecked - Only files without the specified attribute will be listed

Program Options page

This page allows you change program settings.

  • Remember dirs selection - This will save 'DirListerPro.dls' containing current selection on exit and load this selection file when you start Directory Lister next time. This file is located in "%APPDATA%\KRKsoft\Directory Lister Pro" directory.
  • Enable shell integration - This option allows you to start Directory Lister Pro from a context menu interface in Windows Explorer.
  • Automatically refresh preview - Refresh preview window on each option change and directory selection change.
  • Automatically check for updates - Every 30 days program will check if a new version is available and will display a window allowing you to download the latest version.
  • Enable tool tips - Enable tool tips which are shown after you hold a mouse for a while over an option.

(...) Program settings are stored in various configuration files. They are described below: (...)

Configuration files (.dlc)

User can save the options into a text file called configuration file. This file has .dlc extension.
This file contains the states of all configurable options from the user interface, selected interface language and application window position and state. Do not edit this file directly.

Selection files (.dls)

You can save the names of directories you've selected in the select directories window into a text file called selection file. This file has .dls extension.
Only top-most directories checked with 'checked white box' and all directories checked with 'checked gray box' are saved to a selection file.
Subdirectories are read during generation of a listing.

HTML style files (.dlh)

HTML style files contain a subset of all configuration options only responsible for storing HTML properties. It is convenient when only a visual view of a listing must be changed, without impacting any other option.

(...) Other program information like context menu, command line usage, shortcuts and requirements are briefly described below.

Context-menu interface

Directory Lister Pro installs itself in the shell context-menu by default. You can right click on any folder or select a group of folders and then right click in Windows Explorer or Total Commander and choose Generate listing using option from the context-menu. Then choose the configuration file you want to use to generate listing of selected directory/directories. After choosing configuration file, user is asked for output file name.
You can install/uninstall Directory Lister Pro from the context menu using Enable shell integration option on Program Options page.

Directory Lister Pro context menu

Command line usage

Directory Lister Pro can be started with several command line parameters:

/l dlsfile[.dls] [output[.txt|.html|.csv]]
This parameter causes Directory Lister Pro to read the given selection file, generate a listing into the given output file and close. If extension of selection file name is not specified, then it is automatically appended to the end of the file name. If extension of output file name is not specified, then appropriate extension is automatically appended to the end of the file name based on the selected output in Output type page. If output file name is not specified then Directory Lister Pro will ask user for it by displaying Save as... dialog.
ATTENTION! If any path contains spaces it must be enclosed in double quotes e.g. "c:\program files\DirListerPro.exe"

/e dlsfile[.dls] [recipient [subject]]
This parameter allows to read given selection file, generate a listing and send it as an e-mail attachment. This option is mutually exclusive with /l option. Optionally recipient and subject can be provided.

/o conf[.dlc]
This parameter allows to read specified configuration file upon start. If extension is not specified then it is appended to the end of file name.

/r
This parameter allows to delete selection file specified with /l parameter. Use this parameter with caution as it is primarily intended for use with shell context menu integration.

Example:
"C:\Program Files\Directory Lister Pro\DirListerPro.exe" /l "c:\my documents\ftpdirs.dls" "c:\ftp\file_listing.html" /o "c:\my documents\myconf1.dlc"

When executing this example, Directory Lister Pro will:
  • read configuration from "c:\my documents\myconf1.dlc",
  • read directories list from "c:\my documents\ftpdirs.dls",
  • generate "c:\ftp\file_listing.html" file,
  • and finally close.

Shortcut keys

F5 - Refresh folders view clearing any current selections and go to Select directories page
F12 - Go to Preview page
Ctrl+Tab - Go to the next options tab
Ctrl+Shift+Tab - Go to the previous options tab

GET IT NOW!



Copyright (c) 2000-2017 KRKsoft