This EnScript searches user-nominated items for specified keywords.

If an item is an entry, file-slack will be searched by default. Coupled with this, the user can opt to ignore an entry's logical-data if the entry's hash-value matches that of a hash-item listed in the current hash-library.

Keywords can be entered manually and will be stored by the script for later use. They can also be imported from a *.Keywords file or a file exported by the raw search dialog.

The script will bookmark a specified number of bytes either side of each hit. The user can specify that this data should only be bookmarked if unique, but this will increase processing time.

It's important to note that bookmarks are grouped by keyword-name, or if no name has been given, by keyword-expression. Taking this into account, it's advisable to name GREP keyword-expressions to prevent bookmark-folder naming issues causes by certain GREP operators.

Bookmarked data may be written into a logical evidence file such that:Records will be stored using the item-path property.Entries will be stored using the true-path property minus the name of the current case.

To prevent the inadvertent merging of paths due to duplicate evidence-file or compound-file names, each path can be prefixed with the source file's primary and secondary-device GUIDs.

In addition to bookmarks, the script will also create a result-set containing responsive items. The comment of each result will list the keyword(s) found.

The script has the ability to search the transcript data of items rather than their file data. This can prove very useful for searching file-types containing compressed data (docx, xlsx, pdf, etc.) and does not require indexing. It does not, however, search file slack unless the item in question is a known file, in which case it's logical data will be ignored and a physical keyword-search used to search slack instead

To use the transcript option, the user must be sure to specify Unicode search-terms.

In addition, the examiner must use the script's internal condition to specify the items whose transcript data is to be searched.

It's important to note that an empty transcript condition will return true by default. This would cause the transcript data of every target item to be searched, which might lead to undesirable consequences. Accordingly, the Use Transcript option should be used to control transcript searching.

The script creates text bookmarks for search-hits found in files; the source data can be viewed in the Text or Hex tabs. The source data for transcript bookmarks should be viewed in the Transcript tab.

Furthermore, when viewing transcript data, the examiner should bear in mind that the Transcript tab shows the data as Unicode characters, not bytes, so the range spanning each hit will appear to be half the size, i.e., if a range of 100-bytes either side of each hit has been specified and a hit is 10-characters in length, the range shown will be 50 + 10 + 50 = 110-characters. The fact that transcript data is encoded in Unicode will be evident when viewing the content of the logical evidence file produced by the script.

When it comes to specifying a maximum length of data to search, the following points are worthy of note:

  • For files, this value represents the number of bytes to search.
  • For transcript searching, this value represents the number of Unicode characters to search.
  • This value is ignored when searching the slack space of known files.

Please note that a known bug causes the Keyword Hits tab to be activated once the script has finished processing.

Feedback is provided via the console window.

Last updated using EnCase 22.3.

This script was developed for use in EnCase training. For more details, please click the following link:


Keyword Search with Range Bookmarking 5.5
Jan 18, 2024
More info Less info
Product compatibility
Version 22.3 · 22.4
Version 23.2 · 23.3 · 23.4
Version 22.3 · 22.4
Version 23.2 · 23.3 · 23.4
Release notes

This release allows the user to search a specified number of bytes/characters from the start of each file.


Unsubscribe from notifications

You are receiving release updates for this item because you have subscribed to the following products:
If you unsubscribe, you will no longer receive any notifications for these products.
Tip: to update your subscription preferences, go to Manage Subscriptions from your Dashboard, uncheck the products you no longer want to receive notifications for, and click 'Save'.

Marketplace Terms of Service

In order to continue, you must accept the updated Marketplace Terms of Service
Since you are downloading an app from the OpenText Marketplace, you need to accept the updated Marketplace Terms of Service before you can continue. Use the link to review the Marketplace Terms of Service. Once complete check the, "I accept the Marketplace Terms of Service" box below and click accept to continue your download.

Your download has begun...

Your download has begun

Related content and resources

Your browser is not supported!

Please upgrade to one of the following broswers: Internet Explorer 11 (or greater) or the latest version of Chrome or Firefox

release-rel-2024-1-1-5922 | Wed Jan 17 03:07:51 PST 2024