# Welcome to encantar.js!

[![GitHub release (latest by date)](https://img.shields.io/github/v/release/alemart/encantar-js)](https://github.com/alemart/encantar-js/releases/) ![GitHub file size in bytes on a specified ref (branch/commit/tag)](https://img.shields.io/github/size/alemart/encantar-js/dist/encantar.min.js?branch=master&label=minified%20js) [![GitHub Repo stars](https://img.shields.io/github/stars/alemart/encantar-js?logo=github)](https://github.com/alemart/encantar-js/stargazers) [![GitHub Sponsors](https://img.shields.io/github/sponsors/alemart?logo=github)](https://github.com/sponsors/alemart/)

The Augmented Reality engine that will enchant you!

[:sparkles: Demos](./demos.md){ .md-button ._blank }
[:eyes: Try it!](https://alemart.github.io/encantar-js/demos/hello-three/poster.html){ .md-button ._blank }
[:books: Learn](./tutorial/introduction.md){ .md-button } [:heart:{ .heart } Sponsor](./support-my-work.md){ .md-button }

## Features

* **Image tracking**: track detailed images such as book covers, cartoons and photos. No need of manual training!
* **Pointer tracking**: create interactive experiences based on touch and mouse input with an easy-to-use API.
* **Plugins**: use encantar.js with the 3D framework of your choice, including A-Frame, Babylon.js, Three.js and more!

## Key points

* **AR everywhere**: it runs on Android, on iOS, and even on Desktop computers! Only a modern web browser is required.
* **Easy to use**: just load a static HTML page! No need of heavy app downloads, server-side components or subscriptions.
* **Device-agnostic**: no need of AR-capable devices! encantar.js is AR built from scratch with computer vision!
* **Fast & powerful**: encantar.js is GPU-accelerated. It uses WebGL2 and WebAssembly for turbocharged performance.
* **Open source**: personal, professional and educational uses are allowed.

## Browser compatibility

encantar.js is compatible with all major web browsers:

| Chrome | Edge | Firefox | Opera | Safari* |
|:------:|:----:|:-------:|:-----:|:-------:|
| :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |

\* use Safari 15.2 or later.

encantar.js requires WebGL2 and WebAssembly, which are widely supported.

## About

encantar.js is developed by [Alexandre Martins](https://github.com/alemart) and released under the [LGPL](./license.md). It is based on [Speedy Vision](https://github.com/alemart/speedy-vision).
