/TriggEye

When looking at the webcam, TriggEye executes the specified command.

Primary LanguagePythonApache License 2.0Apache-2.0

TriggEye

When looking at the webcam, TriggEye executes the specified command. Overview Example

  • Usage: triggeye COMMAND_TO_BE_EXECUTED_WHEN_LOOKING_AT_THE_WEBCAM
  • Example: triggeye say OK Google
  • Supported OS: Windows10, Mac, Linux

Features

  • High Performance: Detects gaze wherever you are in the room. (Performance of TriggEye)
  • Light Weight: Runs on a low-end computer with a regular webcam. (System Requirements)
  • Secure: No internet connection required, so you don't have to worry about video leaking from your webcam.

Installation

Prerequisites (Only for Windows10)

TriggEye requires WSL (Windows subsystem for Linux). This allows it to be handled in the same way as Linux or Mac.

Building

  1. Clone the GitHub repository of TriggEye.
    % git clone https://github.com/takjg/TriggEye.git
    
  2. Install OpenFace in the TriggEye directory. (See also OpenFace License)

Operation Check

Connect a webcam to your computer and execute:

% cd PATH/TO/TriggEye
% ./triggeye echo OK

It is a success if OK is displayed every time you look at the webcam.

When failed:

  • Use the option -d to specify the webcam device ID:
    ./triggeye -d 3 echo OK
    
  • Use the options -w and -h to specify the width and height of the webcam resolution:
    .triggeye -w 640 -h 480 echo OK
    
  • Make sure the path of OpenFace is directly under TriggEye

Options

Option Unit Default
-d camera ID id 0
-w camera width pixels 1920
-h camera height pixels 1080
-i minimum trigger interval seconds 1.0
-m margin for error millimeters 150

Example

Wake up a smart speaker without a wake word

The sample audio files ok_google.wav and alexa.wav were created by Open JTalk.

Mechanism and implementation

See Mechanism and implementation of TriggEye

License

Released under the Apache License, Version 2.0

You have to respect OpenFace, dlib, OpenBLAS, and OpenCV licenses.

Copyright (c) 2019 Tak Jaga