XCUECAT(1)

NAME
xcuecat - GUI X interface to the :Cue:Cat™ wand scanner.

SYNOPSIS
xcuecat [ file ]

DESCRIPTION
The xcuecat script opens an X dialog to allow the user to interact with the :Cue:Cat™ wand scanner. The file argument, if present, is used for the initial configuration file. If it is not present, then .xcuecat in the users home directory will be used.

The top part of the dialog - labeled Bar code - has an entry area labeled Scan. To start a scan, activate this area, and then scan a bar code with the :Cue:Cat™ scanner. After a successful scan, the bar code proper is displayed in the area labeled Code, and the type of the bar code in the area labeled Type. The Code area is selected, and may be pasted into another application immediately after the scan.

The second part of the dialog - labeled Filter - is a radio selection controlling the translation of the scan. If None is selected, the scan will be translated into an EAN13 type code. If ISBN is selected, then the scan will be translated into an International Serial Book Number type code if that is possible. If any other type of bar code is scanned, the scan will not be considered successful. If UPC is selected, than the scan will be translated into a Universal Product code if that is possible. Any other type of bar code scanned will fail.

The third section - labeled State - controls the behavior of the Gui. The checkbox labeled Beep after scan will cause a successful scan to generate audible feedback if it is checked . The checkbox labeled Balloon help will enable balloon help if it is checked. Finally, the entry area labeled Command can be used to enter a shell command to be executed after a successful scan. It should have a single “%s” which will be replaced by the code resulting from the scan before being passed to the shell. To get a single “%” in the command, use “%%”. See the cuecat(1) manual page for example commands.

The next to last part of the dialog has three buttons, Load, Save, and Exit. Load and Save open dialogs to load and save the configuration file, defaulting to the current configuration file. After the file is loaded or saved, it becomes the current configuration file. The Exit button will save the current configuration to the current configuration file and then exit. If the window manager is used to close the window, the application will exit without saving the current configuration.

If the operating system cooperates, the saved configuration files will be executable. Running them will run xcuecat using that configuration file. For this to work, the operating system must support #! executables, must have a env(1) command, and the envName attribute of the Scanner class in xcuecat must match. This may need to be edited for your operating system.

The last part of the dialog is an unlabeled message area where longer help messages and the results of various actions are displayed.

SEE ALSO
cuecat(1) env(1)