HID Barcode Scanner

Android app for scanning barcodes with the phone camera and sending them to a PC via bluetooth. No special software is required on the PC as this app uses the BluetoothHID API available on devices running Android 9 or greater.

Features

• Supports a wide range of Linear and 2D-Codes thanks to Googles ML-Kit
• Doesn't require any internet connection
• History feature that allows exporting the session as text, JSON or CSV
• Multiple different keyboard layouts to choose from
• Large amount of customization for different use-cases
  • Extra keys like \n or \t
  • Template engine to send additional special keys including modifier combinations
  • Regex filtering of codes with support for capture group extraction
  • JavaScript engine to implement custom logic based on the value and type
  • Auto connect with last device
  • Auto send on detection
  • And much more

Screenshots

Device list and Scanner screen. If you don't want to connect with any device now and just want to try out the scanner, pressing the 'Skip'-Button at the bottom of the paired devices will bring you directly to the scanner.

Otherwise the app tries to connect with the selected device and automatically sends you to the scanner once connected.

All configurable Settings. (Newer versions might contain more or less settings as shown in the pictures)

Download

Note
Because the version on the Play Store is usually one or two versions behind the latest release, you can also download the latest APKs directly here on GitHub as explained in the next section

Download as APK

Since this app uses the ML-Kit there are two app version to choose from. The standard version doesn't contain the scanner library directly. Because of this the size much smaller than in the bundled but requires the user to have the Play Store installed on their device.

You can either download the latest stable version from the Releases tab or directly from the CI using the links below. Please note that the CI version might be unstable and that the builds are not signed (debug builds), thus requiring you to install them on your phone using ADB. The download links below are using nightly.link to provide the files because GitHub doesn't allow to download files from actions without being logged in.

• Latest APKs (Release): here
• Latest APK ( Debug): here
• Latest Bundled APK ( Debug): here

Troubleshooting

If you are unable to connect with a device you can try either of the steps below depending on how the app behaves. If these don't help, feel free to open a new issue and describe your problem in detail.

Connection dialog visible, but no connection possible

This is most likely caused because the phone was paired with the PC previously and now doesn't accept a new type of connection request.

Solution:

1. Make sure to first unpair the PC on the phone either from within the app or from the system Bluetooth settings
2. Remove the phone from the PC device list. On Windows you can either do this through the device manager (look under the Bluetooth category) and choose Uninstall Device or using the device list in the settings app.
3. In the app now search for new devices and click on the target PC (This step could be important so that the phone can tell the PC the new device type)
4. A pairing request should show up and you may need to confirm a pin on both sides
5. After that the connection should be successfully established

Nothing happens when clicking on a device

If there is not even a connection dialog when clicking on a device. This means that the registered Bluetooth proxy was interrupted. Normally it should be connected again right away but in some cases this might not happen.

Solution:

Restart the app. When launching again, there should be a small message at the bottom of the screen that says the Bluetooth proxy was successfully connected. Otherwise you may have to restart your device. This could also mean that your device does not support the Bluetooth HID profile. To test this, search for the app "Bluetooth HID Profile Tester" in the PlayStore and see what the result is. If the test is not successful, unfortunately your device is not supported.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open a new issue with the tag "enhancement". If you want to work on an existing issue, please let me and others know by leaving a small comment.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Copyright (C) 2023 Fabi019

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

Google Play and the Google Play logo are trademarks of Google LLC.