A python-based tool for tracking assets (e.g., people, equipment) through the use of QR codes. The system uses USB-interface webcams along with the open-source python-based software for scanning and generating QR codes. The system was designed to read QR codes attached to assets. QR stations (consisting of a laptop and webcam) can be staged at various locations for the purpose of tracking an entity for logistical and health and safety purposes.
Run the QR-Toolbox-Installer-v1.3.exe file in the Setup folder (or where you downloaded as part of a release). The installer allows for single-user installation, no admin rights needed, and system (all-users) installation, where admin rights will be needed.
Then, after installation, find your installation location and fill out the three variables in the settings.py file, which is found in the Setup folder. Refer to and follow the User Guide in the Documentation folder for more information.
This Guide contains info on how to quickly get started using the application.
- To Launch the Tool
- Double-click on the software shortcut on your desktop or in your start menu
- To Create a Single QR Code
- Click 'QR Creator - Single'
- To Create Multiple QR Codes
- Click 'QR Creator - Batch'
- To Modify QR Codes Created Through 'QR Creator - Batch'
- Navigate to "C:/Users//AppData/Local/Programs/QR-Toolbox" or wherever you installed the program files
and find 'names.csv'
- Once there, open that file and change the text as you wish
- Navigate to "C:/Users//AppData/Local/Programs/QR-Toolbox" or wherever you installed the program files
and find 'names.csv'
- To Scan QR Codes
- Click 'QR Reader'
- To Restart a Scanning Session
- Click "QR Reader" and then click "Restart previous session"
- To Upload Backed-Up Data
- Click the 'Setup' button and then 'Upload/Consolidate' when in Online Storage Mode
- To Consolidate CSV Files
- Click the 'Setup' button and then 'Upload/Consolidate' when in Local Storage Mode (will consolidate CSV files in the chosen location)
- To Change the Camera
- Click the 'Setup' button and then 'Change Camera Source', then choose the camera source you want
- To Change Storage Location
- Click the 'Setup' button and then 'Change Storage (Local/Online)', then choose the storage location you want
- To Choose Special Character Conversion
- Click the 'Setup' button and then 'Special Character Conversion', then choose your preference
- To Find the Saved Files
- Navigate to either "C:/Users//AppData/Local/Programs/QR-Toolbox", or to wherever you installed the program files and then navigate to 'Archive' within those program files, to see the QR Codes and CSV files
- To Exit
- Click either the "Exit" button or the 'X' button in the top right corner of the window
See the User Guide in the Documentation folder for more detailed information.
Note: the tool requires a Sharepoint ID and passcode to operate (see the settings.py in Setup folder). This information is specific to your organization or account. For EPA users, please contact Timothy Boe and Jonathan Pettit to obtain the necessary settings information.
Note: The software is limited to only the QR Codes generated by itself. Outside sources not allowed (will not work properly). English and Latin characters only.
Code integration, enhancements, & platform development - Timothy Boe boe.timothy@epa.gov and Muhammad Karimi karimi.muhammad@epa.gov; Xiaowen Huang - Office 365 integration; qrcode - Lincoln Loop info@lincolnloop.com; pyzbar - Lawrence Hudson quicklizard@googlemail.com; OpenCV code - Adrian Rosebrock https://www.pyimagesearch.com/author/adrian/
Timothy Boe boe.timothy@epa.gov
Jonathan Pettit pettit.Jonathan@epa.gov