Additional Search Parameters to Filter Search Results
In addition to the -Search (-s) key you can use the following keys and parameters:
Filtering by a catalog branch
Use the -CatalogPath (-cp) parameter to filter search results by a catalog branch:
-CatalogPath "path in the catalog"
-cp "path in the catalog"
Filtering results by file size
To filter search results by a file size use one of the following three parameters (important: parameters are mutually exclusive):
-SizeLessThan (-slt) - size should be less than provided (in kilobytes)
-SizeEqualTo (-seq) - size should be the same as provided (in kilobytes)
-SizeGreaterThan (-sgt) - size should be greater than provided (in kilobytes)
The size value should be passed as a number (of kilobytes):
-SizeLessThan 400 - size should be less than 400 kilobytes
-sgt 1024 - size should be greater than 1MB (1024KB is 1MB).
Filtering search results by date created, and date modified
To filter search results by a creation date use one of the following three parameters:
-DateCreatedBefore (-dcb) - created before the date, provided in the parameter
-DateCreatedOn (-dco) - created on the date, provided in the parameter
-DateCreatedAfter (-dca) - created after the date, provided in the parameter
To filter search results by a last modified date use one of the following three parameters:
-DateModifiedBefore (-dmb) - modified before the date, provided in the parameter
-DateModifiedOn (-dmo) - modified on the date, provided in the parameter
-DateModifiedAfter (-dma) - modified after the date, provided in the parameter
Date should be passed in a string format according to the Regional Settings (the value is set in the Windows Control Panel), or in the universal international format "DD-MM-YYYY" or "YYYY-MM-DD" where DD is the day (two digits number), ММ - month (two digits number), YYYY - year (four digits number).
-DateCreatedBefore 01-07-2015 - the creation date should be before July 1, 2015, date is provided in the universal international format
-dma 2/1/15 - date of last modification should be after February 1st, 2015 (English US date format).
Filtering search results by items type
To filter search results by type use one of the following keys:
-TypeFolders (-td) - find folders and disks
-TypeFiles (-tf) - find items that are not folders or discs (files, custom items, archives, etc)
Filtering search results by locations
To filter search results by locations use the -Locations (-l) parameter and pass the list of locations separated by commas or semicolons:
-Locations "Wallet 1; Red box"
-l "Wallet 1, Red box"
Filtering search results by tags
To limit search results by tags use one of the following parameters and pass the list of tags, separated by semicolons:
-TagsAny (-ta) - find items (files, folders, etc) linked with any of the provided tags;
-TagsEach (-te) - find items (files, folders, etc) linked with each of the provided tags;
-TagsNone (-tn) - find items (files, folders, etc) not linked with the provided tags.
Important: You can use the semicolon only to pass the list of tags (because automatically generated tags can contain commas, for example "Artist Last Name, Fist Name"
-TagsAny "Tag1; Tag2; Tag3"
-tn "tag5"
Finding duplicates
For finding duplicates use the -Duplicates (-dup) key and pass the list of the fields to compare as a parameter; several fields should be separated by commas or semicolons:
-Duplicates "Name, Size, Modified"
Field names can be specified in English only. Filed names should be exactly as in the list below. The full list of the supported fields:
-
Name - item name in the catalog
-
Modified - date modified (for files)
-
Created - date created (for files)
-
Size - size (for folders and files)
-
Filename - filename (for folder and files)
-
Width - width of the picture (from Exif tags)
-
Height - height of the picture (from Exif tags)
-
Date taken - date taken (from Exif tags)
-
Artist - name of the Artist (from ID3 tags)
-
Album - Album (from ID3 tags)
-
Title - Track title (from ID3 tags)
-
Length - Duration (from ID3 tags)
-
Year - Year of release (from ID3 tags)
-
Bit rate - bit rate (from ID3 tags)
-
Sample rate - sample rate (from ID3 tags)
-
Channels - number of channels (from ID3 tags)
-
MD5 - MD5 hash of the file
-
CRC32 - CRC32 checksum of the file
Examples:
WinCatalog.exe –o "d:\my catalog.w3cat" –s -sq "*.jpg"
Start WinCatalog, open catalog file "d:\my catalog.w3cat", open a new search tab, start searching using the "*.jpg" (without quotes) as a search query.
WinCatalog.exe –o "d:\my catalog.w3cat" –s -sq "*.jpg" -cp "Catalog\Vacations" -tf -dcb "01-05-2015"
Start WinCatalog, open catalog file "d:\my catalog.w3cat", open a new search tab, start searching using the "*.jpg" (without quotes) as a search query, filter search results by the "Catalog\Vacations" catalog branch and the creation date should be after May 1st, 2015.