iHart: Interactive Hallways for Attraction and Retention in Technology
ActionScript Python Java Other
Latest commit 3473ac2 Feb 7, 2017 @robinsonsarah01 robinsonsarah01 committed on GitHub Merge pull request #14 from ihart-mhc/server-refactor
Server refactor

README.md

iHart

iHart is a library that provides an easy way to write programs that react to motion captured by a web camera, along with a collection of applications.

The iHart: Interactive Hallways for Attraction and Retention in Technology project provides inexperienced programmers with the unique opportunity to develop interactive scenes and games that can be displayed on floors and walls, creating a fun and refreshing diversion from the hustle of everyday life for anyone who walks by. The project strengths lie in its intuitive development environment and its easy and inexpensive installation into the hallway. The goal of the iHart project is to attract and inspire students to pursue careers in computer science and information technology.

The iHart system consists of two parts - a server and a client. The server uses OpenCV to monitor the camera feed for motion. The client triggers CVEvents based on the information it receives from the server. The iHart applications create an instance of the client and listen to the CVEvents, which they can respond to as they would to a MouseEvent.


Installing iHart

You can find all the necessary files for installing the iHart application on Windows or iOS in the server folder.

  • server - files needed for the installation of the iHart software
    • dist - the iHart application exported for iOS and Windows
      • mac
        • cvServer.app - the iHart application
        • cvServer - the iHart application that runs from the terminal
      • windows
        • cvServer - application files (do not touch unless you know what you're doing)
        • cvServer.exe - the iHart application
    • src - the source code for the iHart application
  • bin - scripts and utilities

iHart Applications

All the curently available iHart applications can be found in the client folder.

  • client - files needed for running iHart applications.
    • apps - library of the currently available Flash and Java iHart applications
    • library - the iHart event libraries for Flash and Java (do not touch unless you know what you're doing)
    • sample - documentation of how to create and use iHart applications, plus a demo app

iHart Documentation

Some PDF documentation can be found in the doc folder. More can be found on the iHart website, under Application Development and Software Development.

See this wiki page for documentation about installing from source; the source code is located in server --> src and requires Python 2.7+ and OpenCV 2 for Python.