Sightcorp logo

1.About CrowdSight Toolkit #

About CrowdSight Toolkit

CrowdSight Toolkit is a simple cross-platform plug & play solution that enables you to detect and analyze multiple faces using just one application!

Get insights into your audience demographics and viewer behaviour and optimize messaging in real-time with no need for hard coding. The software can be installed with ease by anyone within minutes!

1.1.Analyzed features #

  • Emotion Recognition
  • Age Estimation
  • Gender Estimation
  • ID Detection
  • Head Position/Head Gaze
  • Attention Time

1.2.Key benefits #

  • 14 Analyzed features: age, gender, emotion, head pose, attention and more!
  • Easy and quick setup: the software can be installed with ease by anyone within minutes.
  • Affordable pricing: start from 15€/month!
  • CMS Integration: using http request in JSON format.
  • Real-time results: no need to wait for data to be displayed.
  • Anonymous analysis: no video is ever recorded and no identifiable facial features are stored.
  • Cross-Platform: Toolkit runs on Windows and Linux (Android coming soon!).
  • Processed Locally: all data is analyzed on the device.
  • Push mechanism: send messages from Toolkit to multiple external applications.
  • Works with most cameras: from budget USB cameras to high definition IP cameras.
  • No internet needed: analysis runs offline (one-time authentication).
  • 1.3.Quick installation guide #

    Preparations for installation:

    Step 1. Make sure your device has Internet connection for license authentication (by browsing google.com, for example).

    Step 2. Make sure the web/inbuilt camera on your device is installed and is running as expected (by opening camera app, for example).

    Installation:

    STEP1

    Download the CrowdSight Toolkit for your preferred operating system.

    For Windows device, please allow the app to make changes to your device and run it.

    STEP 2

    Follow the setup instructions and accept the licensing agreement to continue.

    STEP 3

    You can now access your application folder and double click to activate and initialize the Toolkit.

    STEP 4

    After the Toolkit is installed, you will need to enter a valid license.

    Go to the “Licensing” tab to add your license key.

    You are now ready to start using the CrowdSight Toolkit.

    2.Using the Toolkit #

    3.Functionalities #

    3.1.CSV export #

    A CSV file is a comma separated values file which allows data to be saved in a table structured format. The Toolkit can generate a CSV file which contains raw data gathered during the real-time analysis. This data can be used for post-processing.

    To enable CSV saving go to Output and make sure the checkbox Save data to CSV is checked. By default, the CSV file will be automatically generated in the Toolkit folder after each analysis. Users can also specify the location where the CSV file will be stored. Every row in the CSV file contains the analysis of 1 person.

    IMPORTANT: If you install the Toolkit on its default location (eg. “Program Files (x86)”, the default path for storing CSV files is within its installation directory and will need Administrator permission to write the files. You need to run the Toolkit as Administrator to write to this directory, or select another directory where you do not need Administration rights to write the CSV files to.

    Toolkit Output tab

    You can select a directory where to save the files to, and optionally choose to also dump the face landmarks. The landmarks will increase CSV file size significantly due to the number of landmarks (therefore if these metrics are not required for your project we advised to turn this option off).

    The first row of the CSV file contains the label of the respective column.

    3.2.HTTP interface #

    You can connect your Business Intelligence platform or CMS to the Toolkit using the HTTP interface of the Toolkit. Go to ‘Output’ Tab and click on the field: ‘Enable HTTP Interface’ and ‘Send processed image data through socket’.

    You can now access the JSON response through a GET request on localhost for your external application. You can use this function for instance for Digital Signage or narrowcasting application which trigger custom and relevant ad content to the right people at the right time.

    Toolkit HTTP interface

    3.3.Push mechanism #

    The push mechanism allows for messages to be sent from the Toolkit to external applications (eg. CMS systems) instead of requiring an external application to actively ask the Toolkit for changing status (pulling). If the “push mechanism” feature is enabled, the Toolkit will send an HTTP POST request to the endpoint defined by the user every second. The endpoint needs to be a valid HTTP server able to receive HTTP POST requests. The body of the HTTP POST request is a JSON object containing a summary of the last second of analysis.

    Toolkit push mechanism

    3.4.Auto-restart #

    It might be desirable to start the Toolkit on startup of the system. For both platforms it is required that you log in automatically when the system is turned on, eg. you are not required to enter a password and you’re instantly booted to the Desktop.

    Windows 10

    In the installation directory of the Toolkit there is a default start.bat script that can be used and modified for automatic startup of the Toolkit from the command line. Once the start.bat script has been modified in accordance to your preference, you can use this script for automatically starting up the Toolkit as follows:

    1. Use the Windows key + R keyboard shortcut to open the Run command
    2. Type shell:startup to open the Startup folder of Windows. All shortcuts placed in this directory will be called when Windows has started
    3. Right-click and select New > Shortcut
    4. Browse and select the start.bat file
    5. Double-check if the Toolkit starts up when you double-click the shortcut
    6. If the Toolkit launches in step 5, you’re all set for automatic startup

    4.Hardware Recommendations #

    Although our CrowdSight Toolkit is hardware and camera agnostic, this section gives a few recommendations for devices that you can use in different scenarios. In case none of these machines match your requirements, you are free to choose your own device according to the following general specifications;

    Minimum:

    • Processor: Intel i5 (2 cores) 2.3 GHz (low to medium frame rate)
    • NUC 7th or 8th generation
    • RAM: 8 Gb minimum
    • Storage 2Gb free space

    Preferred:

    • Processor: Intel i7 (4 cores) 3.5 GHz (high frame rate)
    • NUC 7th or 8th generation
    • RAM: 8 Gb minimum
    • Storage 2Gb free space

    (Please note that hardware type significantly influences the software performance therefore choose your devices carefully)

    Recommended Intel NUCs:
    hardware-overview-table

    Not sure which passmark applies to your device? Check it here.

    Recommended models:
    Intel NUC 7 NUC7i5BNHXF
    Intel NUC 7 NUC7i7BNKQ
    Intel NUC 7 NUC7i5BNK

    Intel NUC 8 NUC8i7BEKQA
    Intel NUC 8 NUC8i5BEHFA
    Intel NUC 8 NUC8i7BEHGA

    5.Camera Recommendations #

    There are many different camera types on the market that work with the Toolkit, but to make your decision making easier below we list a few preferred models per industry that we and our clients use frequently;

    Digital Signage:
    Logitech HD Pro Webcam C920
    Logitech webcam BRIO 4K Ultra-HD
    Logitech C930e
    Genius WideCam F100

    DOOH:
    AXIS F Series cameras

    Retail:
    AXIS FA Series cameras
    Hikvision Pro Series cameras

    6.Error Diagnostics #

    1. “Couldn’t resolve host name”
    The Toolkit is trying to authenticate the license key against our licensing server but there is no internet connection available. Try connecting to network first and then running the software again. After the initial authentication, the software runs offline so there is no need for active internet connection.

    2. “Cannot initialize log rotation”
    This error occur due to the fact that Toolkit does not have permissions to write log files in the specified directory. To fix this you can either start the Toolkit as administrator or set the log folder where the Toolkit has permissions (eg: a folder in the Desktop). If the logs files cannot be generated, the Toolkit will still be working.

    7.FAQ #

    Please refer to our help desk.

    8.Privacy policy #

    Please contact us for further resources.