Barcodescanner Keyboard User Manual V1

Introduction

The Barcodescanner Keyboard provides an additional input method for your Android device. It offers a convenient soft-keyboard for manual typing which was extended with an additional key for fast barcode scanning. For the target app there is no difference between manual user input or barcode scanner input - the data appears in both cases as typed by the user.

The Barcodescanner Keyboard offers English, German, French, Russian and Swedish keyboard layouts. The suitable keyboard layout is activated automatically depending on the system language of your handset.

The Barcodescanner Keyboard is extremely easy to use and enables you to scan barcodes without leaving the target app.

Initial Configuration

After you have downloaded and installed the Barcodescanner Keyboard a setup wizards simplifies the initial configuration. The wizard guides you through the minimal required configuration steps:

• Enable the input method
  In order to use the Barcodescanner Keyboard you need to enable it. Do this by opening Android Settings, Language & keyboard and enable the input method named Barcode Keyboard by checking the box. Confirm the security warning (see privacy).
• Activate the input method
  After the input method was enabled it must be activated. Long tap on any edit field, choose the entry Input Method in the upcoming menu and select the input method Barcode Keyboard.
• Test the input method
  Press the button Test it! to display the new soft-keyboard. You can type data manually or use the scan-key for barcode scanning.

That's all! Your Android is now using the Barcodescanner Keyboard as input method. You are able to scan bar-codes with the camera scanner by tapping on the scanner key of the soft-keyboard. Scanned bar-codes appear like manually entered data into the edit-fields of the target app.

The Keyboard

The Barcode-Scanner Keyboard is organized as follows:

• Scanner Key
  
  A short tap on the scanner key invokes the camera bar-code scanner. Long-tap the scanner key to enter characters like colon :, slash /, ampersand &, left parenthesis (, right parenthesis ), minus -, plus +, semicolon ;, comma ,, at-symbol @, single quote ', double quote ", question mark ? and exclamation mark !.
• ?123 Key
  Short tap this key to switch between the alpha- and the numeric/special characters keypad. A long tap shows a menu which offers you the following options:
  • Scan Barcode Now
    Invokes the adjusted camera scanner (see Barcode-Scanner Keyboard Settings).
  • Simulation Rules
    Goes directly to the Keyboard Simulation Rules.
  • Settings
    Opens the Barcode-Scanner Keyboard Settings screen.
  • Input Methods
    Allows you to activate another soft-keyboard.

Barcodescanner Keyboard Settings

To modify the Barcodescanner Keyboard options, go to Android Settings -> Language & keyboard -> Barcode Keyboard (as an alternative you may also press the ?123 key as mentioned earlier). The following options are available:

• Common
  

  This section is used to specify general keyboard options, if and where scan-/settings-key should be displayed and how to modify Quicktexts.

  Scan-key in suggestion bar

  Adjust whether the scan-key is displayed in the suggestion bar or not.

  Settings-key ins suggestion bar

  Adjust whether the settings-key is displayed in the suggestion bar or not.

  Scan-key left of space bar

  If selected (this is the default), the scan-key is displayed on the left of the space bar.

  Custom scan-keys

  Define individual keys, which also can be used for scanning.

  Quicktext-key in suggestion bar

  Define whether the Quicktext-key is displayed in the suggestion bar or not.

  Quicktexts

  Add, edit or delete own Quicktexts.

  
  
  
  
  
  
  
• Camera Scanner
  Camera Scanner

  This option let you choose between the built-in camera scanner (based on Barcode Scanner from ZXing) or select any other installed camera scanner app.

  Batch Scanning

  If this option is selected, the barcode scanner works in batch mode and scans barcodes continuously until interrupted with the back-key.

  Pause Between Scans

  This option is only available if the batch-mode was enabled. It specifies the waiting time between the single scan operations in milliseconds (1000 milliseconds = 1 second).

  Flashlight

  If checked, the flashlight is enabled while scanning bar-codes (this option may not work on all devices).

  Auto Focus

  If checked, Barcodescanner Keyboard sets the focus on the object automatically.

  Barcode Character Set

  Use this option to ensure the correct decoding of bar-codes which are encoded using a special character set. The following character sets are available: automatic mode, ASCII, Latin Alphabet, UTF-8, UTF-16, Korean (949), Russian (20866), Japanese (Shift-JIS), Traditional Chinese (950), Traditional Chinese (Big5).

  Simulation Rules

  By the means of Simulation Rules the user is able to configure keystroke simulation mode and cursor movements per target application.

  
  
  
  
• Import/Export
  

  Import or/and export configuration files.

  Import

  Import a configuration file into Barcode Keyboard.

  Export

  Export a configuration file out of Barcode Keyboard.

  
  
  
• About
  

  This section provides commands for displaying the user manual, the software version and the copyright information. In addition you can display your license information or enter a manual license.

  User Manual

  This command shows this web-page in your browser. Please contact us in case of questions, suggestions or if you want to report a bug.

  YouTube Videos

  This command opens TEC-IT’s YouTube channels with relevant data acquisition videos.

  License

  This command opens a dialog which displays the current state of your license. You may purchase a full license directly via the Android Market. For users without access to Android Market or if you are interested in a bulk-license with special pricing, the Barcodescanner Keyboard can be licensed by entering an activation key. Activation keys are available from TEC-IT upon purchase, licensing with activation keys requires one-time internet access.

  About

  Displays the current software version, a copyright notice and 3rd party credits.

Simulation Rules

By the means of simulation rules the user is able to configure keystroke simulation mode and cursor movements per target application. When transforming a barcode into simulated keystrokes, the Barcode Keyboard searches for an active rule for the current target app. If no such rule is found, it applies the active default rule.

To maintain simulation rules, go to Android Settings -> Language & keyboard -> Barcode Keyboard -> Simulation Rules. By tapping on a rule name you have the following options:

• Disable rule
  This option diables the selected rule.
• Enable rule
  This option enables a previously disabled rule.
• Edit
  Modify the rule settings (see below)
• Remove
  The initial default rule can't be deleted

A new rule can be added with the button Add Simulation Rule.

Two methods for simulating user input are available:

• All keys at once
  Scanned barcode data is injected as a single string into the target app.
• One key at a time
  Scanned barcode data is forwarded keystroke by keystroke. This method is recommended if the target app is a browser or a RDP (remote desktop) application.

If you have problems forwarding keystrokes to a specific target application you may add an application specific rule for exactly the app in question. Most likely browser or remote desktop (RDP) applications require the setting One key at a time for correct bar code forwarding.

Each simulation rule allows the user to add cursor control commands before and after the barcode data. The following placeholders are supported:

• ${INPUT} or ${I}
  This is the placeholder for the barcode data
• ${ENTER} or ${E}
  Placeholder for the enter key
• ${TAB} or ${T}
  Placeholder for the tab key
• ${DOWN} or ${D}
  Placeholder for the cursor down key
• ${UP} or ${U}
  Placeholder for the cursor up key
• ${LEFT} or ${L}
  Placeholder for the cursor left key
• ${RIGHT} or ${R}
  Placeholder for the cursor right key
• ${F1} ... ${F12}
  Placeholder for the function keys F1 to F12
• ${NOW} or ${N}
  Placeholder for the current date and time

Any placeholder (except for the function keys) can also be used with a multiplier: ${R3} is equivalent to ${R}${R}${R}.

Example: To instruct Barcode-Scanner Keyboard to inject the barcode data followed by the enter key use this rule: ${I}${E}.

Barcodescanner Keyboard Privacy

TEC-IT respects your privacy. Your data is safe.

Barcodescanner Keyboard does not log, store or forward typed text, passwords or other personal data. Please contact us if you have any concerns regarding phishing, key logging or spying.

Important background information: In order to use an alternative input method on Android devices, the user must manually activate this method. By default, Android displays a security hint whenever an alternative input method is activated. This security hint can safely be ignored for all input methods developed by TEC-IT.

Sample security hint: "This input method may be able to collect all the text you type, including personal data like passwords and credit card numbers. It comes from the application Barcode Keyboard (or a similar name). Use this input method?"