--- title: TBR Wizard slug: tbr-wizard docTags: createdAt: 2023-03-08T07:50:06.000Z --- **TBR Wizard** is an application that identifies the best TBR Code(s) to maximize the recognition rate or speed for your typical images. # Using TBR Wizard ## Installation Download TBR Wizard: - Windows 32-bit [download](https://barcode-reader.inliteresearch.com//downloads/actions/do-download.php?prod=TWW32\&back) - Windows 64-bit [download](https://barcode-reader.inliteresearch.com//downloads/actions/do-download.php?prod=TWW64\&back) - Linux 64-bit [download](https://barcode-reader.inliteresearch.com//downloads/actions/do-download.php?prod=TWL64\&back) ## Basic examples Find the best TBR code to read the `pdf417` barcode from a file: :::BlockQuote tbr\_wizard -type=pdf417 c:\some\_folder\some\_file.pdf ::: Find the best TBR code to read `code39` and `code128` barcodes from TIF and PDF files in a folder: :::BlockQuote tbr\_wizard -type=cdoe49,code128 "c:\some folder" -incl=tif,pdf ::: See [TBR Wizard Reference](docId\:kqwI9QelG581eap-OGukq) for a complete list of command line options. ## TBR Wizard Results TBR Results present the following essential information. - `TESTED TBR` is a list of analyzed TBR codes. If `-tbr` option is not set, this is a list of valid TBR codes for the specified `-type`. - `RECOMMENDED TBR` is one or more TBR codes that read a maximum number of barcodes in the shortest time. - `Alternative TBR` is a list of TBR codes that read a similar number of barcodes but slower than RECOMMENDED TBR. Additional intermediate data are available by setting a `-verbosity` option. :::hint{type="info"} TBR Wizard results are based on real-time measurements. Actual timing varies between TBR Wizard sessions; therefore, the preferred and alternative codes might change between sessions. ::: An example of TBR Wizard results: :::BlockQuote TESTED TBR: 100 103 107 108 111 112 113 115 116 117 118 119 120 121 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 401 415 0 RECOMMENDED TBR: TBR 107 reads 5 barcodes in 346 milliseconds or 49 milliseconds per page. TBR 108 reads additional 1 barcode in 408 milliseconds or 58 milliseconds per page. Alternative TBR are 112 113 100 128 119 401 118 0 129 111 ::: ## Using TBR Wizard results Activate recommended TBR codes in your Inlite Products: - **ClearImage SDK** - Set the `TbrCode` property of the readers. If multiple TBR codes are recommended, use one of the methods: - Repeat reading operations with each TBR code - Use [external TBR](docId\:KRbh-LutYaWZPHRaJ5lqS) - **Barcode Reader CLI** - Set the `-tbr` option. To use multiple TBR codes, set them as a comma-separated list. The [external TBR](docId\:KRbh-LutYaWZPHRaJ5lqS) mechanism is available for all Inlite Products to: - Override default processing - Read using multiple TBR codes The following considerations affect the utilization of the TBR Wizard recommendations. - TBR technology employs sophisticated image processing algorithms, which consume more CPU cycles than the default algorithms. Consequently, recognizing marginal, poor-quality images may require more time to read more barcodes. - The analysis of the TBR Wizard provides statistical data, which enables the user to balance speed vs. recognition rate. - If multiple barcode-type groups are used, combine the recommendations of the TBR Wizard for each of the groups. Each group is processed separately, thus adding time to the total reading time. - Actual recognition speed in production reader mode can be faster than the TBR Wizard measurements because: - Inlite's Barcode Readers can run multi-threaded, using available CPUs. However, TBR Wizard runs as single-threaded to perform accurate timing measurements. - Inlite's Barcode Readers can limit the number of barcodes found on a page. On the other hand, TBR Wizard tries to find all barcodes on a page. # Reference ## Command line format :::BlockQuote tbr\_wizard \[options] \[sources] \[@configuration\_file] ::: Where: `options` - options specified in this document. See [option rules](docId\:vUIyHltrRQommo0HkJ2iO) `sources` - files, folders, or URLs identifying input files `configuration-file` - zero one or more configurations files ## Source The `source` parameter specifies the location of image files to read barcodes from. Multiple sources can be specified. Sources can be: - Local image file - Local folder The rules for source values are: - The value of the source should use **UTF-8** to represent non-English file names. - The value containing spaces should be enclosed in double quotes (`""`) ## Options ### Option rules - Options are specified as `-name=value`, except - If the value is described as a **list**, zero or more valid values can be set. A comma should separate multiple values. No spaces are allowed in the list. - All options (except `-type`) are optional. ### Reader options Reader options configure the barcode reader parameters to be applied to a source. | **Name** | **Value Description** | **Default** | **Valid values** | | --------------------------------------------------------------------------- | --------------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `-type`
`-t` | **Required.** List of barcode types | | `code39` `code128 codabar` `ucc128` `code93` `upca` `ean8` `upce` `ean13` `i25`
`datamatrix`
`pdf417` `drvlic`
`qr`
`imb` `bpo` `aust` `sing` `4state`
`patch` | | `-tbr` | List of [TBR Codes](docId\:KRbh-LutYaWZPHRaJ5lqS)  | 0 | Valid TBR codes for a given type are displayed by the [TBR Wizard](docId\:GLmGkFKXRClppzzASNvWc) | | `-dir` | List of barcode directions | `all` | `all` `horz` `vert` | `-type` option is a comma-separated list of barcodes to analyze. All specified types should belong to only one of the following groups: - `code39` `code128` `codabar` `ucc128` `code93` `upca` `ean8` `upce` `ean13` `i25` - `datamatrix` - `pdf417` - `qr` - `imb` `bpo` `aust` `sing` `4state` - `patch`  `-tbr` option is a comma-separated list of TBR codes TBR Wizard will analyze. If not set, all valid TBR codes for the selected group will be evaluated. ### Source options - Multi-page file format This option control processing of multi-page file formats: `PDF`, `TIFF`, `GIF` | **Name** | **Value Description** | **Default** | **Valid values** | | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- | ----------------------------------------------------- | | `-pages` | List of page selectors to limit reading to a set of pages.
`NMB` is an explicit page number (1-based)
`START` is an explicit page number or **`first`**
`STOP` is an explicit page number or `last` | `all` | `all` `even` `odd` `first` `last` `NMB` `START-STOP` | ### Source options - Folder processing These options control the selection of image files when the `source`* *is a folder. | **Name** | **Value Description** | **Default** | **Valid values** | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------- | -------------------------------------------------- | ---------------- | | `-sub`
`-subfolders` | Include subfolders of the source folder in the processing
| `true` | `true` `false` | | `-incl` | List of file name masks to be included in the processing | \*.tif,\*.tiff,\*.jpg,\*.jpeg,\*.pdf,\*.bmp,\*.png |   | | `-excl` | List of file name masks to be excluded from processing |   |   | ### Miscellaneous options | **Name** | **Value Description** | | --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `-help`
`-h` | Flag to output command-line help to console. No processing is done | | `-verbosity` | Defines the amount of information presented in the output
0 (default) - Essential information, including recommended TBR codes to use
1 - Adds summary of found barcodes and timing
2 - Display the TBR codes test and number of barcodes during measurements | ## Configuration file A configuration file is a convenient way to define a set of options and/or sources shared by multiple systems or sessions. The format rules for configuration files are: - `-name` sets command line flags - `-name=value` sets command line options with values - `source` specifies the location of image files to read barcodes from. It can be an **image file**, **a folder** containing image files, or **a URL**. Values with spaces should be enclosed in double quotes (`"some text"`) - `#` starts the comment portion of a line. If `#` is the first character, the whole line is treated as a comment. - `exit` ends the processing of a configuration file. The rest of the file is ignored. The configuration file should be in UTF-8 to include non-English file names.