# Tracking.js

[![Build Status](https://travis-ci.org/Bludata/tracking.js.svg?branch=master)](https://travis-ci.org/Bludata/tracking.js)
[![devDependencies Status](https://david-dm.org/bludata/tracking.js/dev-status.svg)](https://david-dm.org/bludata/tracking.js?type=dev)

The tracking.js library brings different computer vision algorithms and techniques into the browser environment. By using modern HTML5 specifications, we enable you to do real-time color tracking, face detection and much more — all that with a lightweight core (~7 KB) and intuitive interface.

* [Official website](http://github.com/bludata/tracking.js)

## Install

Install via [Bower](http://bower.io/), [npm](https://www.npmjs.com/), or [download as a zip](https://github.com/bludata/tracking.js/archive/master.zip):

```
bower install bludata-tracking
```

```
npm install bludata-tracking
```

## Examples

See `./examples` folder.

## Features

* [Trackers](./docs.html#trackers)
  * [Color Tracker](./docs.html#color-tracker)
  * [Object Tracker](./docs.html#object-tracker)
* [Utilities](./docs.html#utilities)
  * [Feature Detection (Fast)](./docs.html#feature-detection)
  * [Feature Descriptor (Brief)](./docs.html#feature-descriptor)
  * [Convolution](./docs.html#convolution)
  * [Gray Scale](./docs.html#gray-scale)
  * [Image Blur](./docs.html#image-blur)
  * [Integral Image](./docs.html#integral-image)
  * [Sobel](./docs.html#sobel)
  * [Viola Jones](./docs.html#viola-jones)
* [Web Components](./docs.html#web-components)
  * [Color Element](./docs.html#color-element)
  * [Object Element](./docs.html#object-element)

## Browser Support

You can plug *tracking.js* into some well supported HTML elements such as `<canvas>`, `<video>` and `<img>`.

![IE](https://cloud.githubusercontent.com/assets/398893/3528325/20373e76-078e-11e4-8e3a-1cb86cf506f0.png) | ![Chrome](https://cloud.githubusercontent.com/assets/398893/3528328/23bc7bc4-078e-11e4-8752-ba2809bf5cce.png) | ![Firefox](https://cloud.githubusercontent.com/assets/398893/3528329/26283ab0-078e-11e4-84d4-db2cf1009953.png) | ![Opera](https://cloud.githubusercontent.com/assets/398893/3528330/27ec9fa8-078e-11e4-95cb-709fd11dac16.png) | ![Safari](https://cloud.githubusercontent.com/assets/398893/3528331/29df8618-078e-11e4-8e3e-ed8ac738693f.png)
--- | --- | --- | --- | --- |
IE 9+ ✔ | Latest ✔ | Latest ✔ | Latest ✔ | Latest ✔ |

However, the browser support may vary if you request the user's camera (which relies on [getUserMedia API](http://caniuse.com/#feat=stream)).

## Contributing

1. Fork it!
2. Create your feature branch: `git checkout -b my-new-feature`
3. Commit your changes: `git commit -m 'Add some feature'`
4. Push to the branch: `git push origin my-new-feature`
5. Submit a pull request :D

## History

For detailed changelog, check [Releases](https://github.com/bludata/tracking.js/releases).

## Team

*tracking.js* is maintained by these people and a bunch of awesome [contributors](https://github.com/bludata/tracking.js/graphs/contributors).

<img width="60" src="https://avatars0.githubusercontent.com/u/6409113?s=460&v=4"/>

## License

[BSD License](https://github.com/eduardolundgren/tracking.js/blob/master/LICENSE.md) © Eduardo Lundgren
