Directory Lister 'Read me' file
Version 0.7
(C) 2000-2004 Copyright by Leszek Skorczynski
http://freeware.prv.pl
Description of Directory Lister
Program goal
Directory Lister lets you list files in selected directories
on hard disks, cd-roms, floppys etc. into a HTML, TXT or CSV file (listing). It's like the DIR command but
MUCH more convenient.
General rules
Directories for diskettes are not read upon start. You must click on diskette
icon to force reading directories.
Selecting directories
(Checked white box) - list this directory and
all subdirectories recursively,
(Checked gray box) - list this directory but
not all of its subdirectories (not all could also be none),
(Gray box) - list some of the subdirectories of this
directory,
(White box) - do not list this directory and none of
its subdirectories.
Only top-most directories checked with 'checked white box' and all directories checked with ' checked gray box'
are saved to a selection file (DLS).
Subdirectories are read during generation of a listing.
Command line usage
[complete_path]DirLister.exe [/l dlsfile[.dls] output[.txt|.html]] [/o configuration[.dlc]]
- where:
-
directories.dls - previously saved list of directories to list
output - listing itself
configuration - previously saved user configuration
/l - reads list of directories, generates listing, than closes
/o - reads configuration from a file
- Example:
-
C:\Program Files\Directory Lister\DirLister.exe /l c:\my documents\ftpdirs.dls c:\ftp\file_listing.html /o c:\my documents\myconf1.dlc
- this example reads configuration from 'c:\my documents\myconf1.dlc',
reads directories to list from 'c:\my documents\ftpdirs.dls', generates 'c:\ftp\file_listing.html', and finally closes (since '/l' option was specified).
Shortcut keys
F5 - Refresh folders view
F12 - Go to 'Preview' page
Context-menu interface
Directory Lister installs itself in the context-menu by default.
You can right click on any folder in Windows Explorer and choose 'DirList' from the context-menu to generate
listing of that directory in that directory. Configuration for this listing is taken from 'This.dlc' file located in Directory Lister
directory. Output file name is set to '_thisfolder' and extension taken from configuration file.
Description of program options
Options 1 page
Include box
- Dir name - this will display directory name above the files listing.
In text listing, if you also check 'File Name'
checkbox, directory name will be sourrounded with
two lines consisting of '-' chars.
- File count in dir name - this will 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. This is count only
of files in a given directory.
- Dir size - this will display directory size above the files listing. If you set mask different
than '*.*' the size will be counted only from files
which match the mask. This is total size of all files in a given directory and all subdirectories.
- Dir date - this will display directory date.
- Dir time - this will display directory time.
- Dir attributes - this will display directory attributes,
where 'r' is readonly, 'a' is archive,
'h' is hidden, 's' is system, and 'c' is compressed.
- Subdirs - this will display subdirectories apart from files.
- File number - this will display consecutive file number in front of file name.
- File path - this will display files with full path, not only the file name. For CSV listing, path is placed
in separate column.
- File name - this will display file name.
- File extension - this will display file extension. Subdirectories are assumed to have no
extension (that is '.' is not perceived as extension determinant).
- File size - this will display the file size and '<dir>' string for
subdirectories.
- File date - this will display file date.
- File time - this will display file time.
- File version - this will display file version - if available. Usually version
information is saved in executable files (exe, dll, ocx, etc.).
- File crc32 - this will display the file CRC32 value (exactly the same as
in zip/rar archives).
- File attributes - this will display file / subdirectory attributes,
where 'r' is readonly, 'a' is archive,
'h' is hidden, 's' is system, and 'c' is compressed.
Options box
- Mask - only files which match the mask 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???.*
- Sort dirs by - you can choose how to sort directories. Sorting is done first by chosen attribute then by name.
- Sort dirs descending - this will reverse the order of sorting for directories.
- Sort files by - you can choose how to sort files. Sorting is done first by chosen attribute then by name.
- Sort files descending - this will reverse the order of sorting for files.
- Files treated all together - this option will 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.
- Size display - displays 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 decimal digits after the point.
- Thousand separator - changes character used for separate thousands in sizes.
- Decimal separator - changes character used for separate decimal numbers from integer numbers in sizes.
- Listing for each dir - this will generate listing in each scanned
directory under the name taken from 'Listing name:' edit. Extension
is automatically added.
WARNING! This file is ALWAYS overwritten so be sure not
to choose a name that will delete your own files!
- Path - changes which portion of path should be displayed.
- Full - will display whole path
- No drive - will not display the drive letter
- No parent dir - will display the path starting from the top-most selected directory.
- Date & Time - changes which date will be presented for date and time options.
- Remember dirs selection - this will save 'DirLister.dls' containing current
selection on exit and load this selection file when you start Directory Lister next time.
Options 2 page
Output box
- Text file - Generate text file. In this mode you can set widths for names, sizes and version columns on 'Options 1 page'.
- 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 database.
HTML options box
- Generate links to dirs - this will generate links to actual directories.
Normally, directory path is copied into HREF part of a tag, except for Path: No parent dir
option. In this case HREF part does not contain leading '\' char, so you can copy HTML output file
to parent dir of 'Top dir' and you can browse its subfolders.
- Generate links to files - this will generate links to actual files. The same rule takes effect as for dirs.
- Background color - changes background for HTML page.
- Header background color - changes background for page header.
- Header font & color - changes font and color for page header.
- Dir background color - changes background for directory rows.
- Dir font & color - changes font and color for directory row.
- Odd row background color - changes background for odd files rows.
- Odd row font & color - changes font and color for odd files rows.
- Even row background color - changes background for even files rows.
- Even row font & color - changes font and color for even files rows.
CSV options box
- Column names in first row - includes all column names in the first row of CSV file.
- Separator - a character used for separating columns in CSV file. If separator is present in a particular column
then this column is sourrounded with double quotation marks (").