1. Home
  2. Knowledge Base
  3. IDWedge BT
  4. IDWedgeBT with HanDBase Android Demo – Easy Custom Forms with ID Card Data Capture
  1. Home
  2. Knowledge Base
  3. News
  4. IDWedgeBT with HanDBase Android Demo – Easy Custom Forms with ID Card Data Capture

IDWedgeBT with HanDBase Android Demo – Easy Custom Forms with ID Card Data Capture


HandDBase by DDH software provides an easy way to build custom forms that can be partially filled in by the Tokenworks IDWedgeBT ID Scanner. The software is currently $9.99 for Android and there are other versions available for iOS and Windows.

We have provided a demo file and and instructions to set up a basic form in HanDBase on an Android device that works with IDWedgeBT. The user can customize the demo form using the many options available in the software like drop down menus, checkboxes, image capture, signature capture, etc. Some features require an additional paid upgrade (add0n) with HanDBase (approx. $5).

HanDBase website: http://www.ddhsoftware.com/products.html

Tokenworks is in no way affiliated with DDH Software.

Click here for instructions on IDWedgeBT with HanDBase for iOS

Download a Microsoft Word version of the instructions here.


Step-by-step Instructions

  1. Download HanDBase for Android Database Manager from the Google Play Store (currently $9.99)
  2. Configure the IDWedgeBT form fields to match our demo HanDBase form using a PC or Mac.
    1. Detailed instructions and video here:
    2. Power off IDWedgeBT. Connect RJ50 cable to IDWedgeBT (do not connect to computer yet). While holding down battery button, connect USB cable to computer. Continue to hold battery button until battery status light turns blue. IDWedgeBT will be mounted to the computer as a USB drive.
    3. Open the USB drive.
    4. Download pre-configured IDWedgeBT file driverslicenses.txt here. Copy the Driverslicenses.txt file to the IDWedgeBT (replace the default file). This file contains instructions to tell the IDWedgeBT where to enter the ID card data into your form.
    5. Eject the USB drive from your computer. Unplug the IDWedgeBT from computer. Power off.
  3. Turn on IDWedgeBT
  4. Connect IDWedgeBT to Android.
    1. On the Android Device go to Settings > Bluetooth
    2. Turn on Bluetooth
    3. Click on IDWedgeBtHID under Available Devices
    4. IDWedgeBtHID will show as Connected

  1. Download the two files below onto your Windows PC
    1. Download the HanDBase database file here (format is .PDB)
    2. Download the HanDBase form file here (format is .PDB)
  2. Open the HandBase app and click on the Sync button on the top. There will be a web address displayed at the top of the screen. On your computer, go to that web address in a browser.

  3. After you visit the address in your browser, go to Upload File on the right side click on the Choose file option . Select the database file you downloaded above and then click Add file. After adding the database file, click Choose file again and then find the Form file you download from above and then click add file.
  4. Now both files should be loaded into HanDBase. Click the back button to return to the list of databases. You will see some default databases that are included with HanDBase and the database you just installed called “Marketing List”. Click on the “Marketing List” option to view the database.

  5. In the HanDBase app, create a new entry:
    1. Click on the New icon at the bottom right

    2. Click in the First Name box so the cursor and keyboard appear on the screen

    3. Scan an ID with the IDWedgeBT
    4. After you scan the ID, the first five fields of the form should automatically populate with information from the ID. Below is a sample of what the form should look like. If your form does not auto-populate, please verify that 1) the cursor was placed in the First Name field before scanning the ID; or 2) that there was a successful Bluetooth connection between the IDWedgeBT and the device.

    1. IDWedgeBT “types” in the name, date of birth, and address from the ID card. It follows the instructions specified in the driverslicenses.txt file stored on the IDWedgeBT. [You can customize this file to match your own form. See section 3.1 of the IDWedgeBT User Guide for detailed instructions.]
    2. Enter email address, additional notes, first visit date and select an option from the dropdown list if desired. A form can be highly customizable. A company logo can be added, signature fields a variety of other fields. Below is an example of a favorite color dropdown. You can either select a listed option or edit the list options by clicking the “Edit Popups” in the bottom of the list.

    3. Click the check icon to save and return to the database or the plus icon to save and start a new entry..
  6. To export or email the database:
    1. Click on menu icon at top-right and click on Email Records

    2. Click on Mail to email the data or save the file to Dropbox, Google Drive, etc.

  7. To customize your form, open the database and click on the wrench icon in the bottom-right corner. Choose the option that says “Database Properties”.
  8. To edit the form, choose the option that says “Forms”. You can either create a new form by clicking the “+” icon in the bottom-left or edit the “Tokenworks Sample Form” by clicking the name and choosing “Edit”.
  9. From the edit form page, you can add new fields or move and resize existing fields. You can edit the properties of a field by selecting it and clicking the gear icon. You can delete a selected field by clicking the wrench icon and choosing “Delete Control”.
  10. You are also able to share forms between devices. To do this, click on the sync button on the app’s main page and connect your browser to your device you can download the database and form file directly from the browser.
Updated on December 31, 2020

Was this article helpful?

Related Articles

Need Support?
Can't find the answer you're looking for? Don't worry we're here to help!
Open Support Ticket