kerikun11 / triggeye

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

TriggEye

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

• 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)
   • Windows
   • Linux
   • Mac

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

• Mac

  % ./triggeye say OK Google
  

• Windows

  % ./triggeye ./say_win ok_google.wav
  

• Linux
  • See How to play audio files on the command line

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