alemart 6c9c017fc8 Change VideoSource._handleBrowserPolicies() slightly		1 year ago
.github	Simplify	3 years ago
demos	Introduce VideoSource._handleBrowserPolicies() for better compatibility	1 year ago
dist	Refactor sources of data	1 year ago
docs	Introduce VideoSource._handleBrowserPolicies() for better compatibility	1 year ago
docs_overrides	Load mp4 videos for better compatibility with Safari / iOS	1 year ago
src	Change VideoSource._handleBrowserPolicies() slightly	1 year ago
.gitignore	Add entry	3 years ago
CHANGES.md	Prepare for release	3 years ago
LICENSE.md	Initial commit	3 years ago
NOTICE	Simplify	3 years ago
README.md	Add Safari support.	1 year ago
mkdocs.yml	Upload demos. Create a mkdocs hook to copy the demos to the website	1 year ago
package-lock.json	Update Speedy Vision	1 year ago
package.json	Add deploy script	1 year ago
tsconfig.json	Initial commit	3 years ago
webpack.config.js	Upload demos. Create a mkdocs hook to copy the demos to the website	1 year ago

MARTINS.js WebAR engine

Create amazing Augmented Reality experiences with MARTINS.js, a GPU-accelerated Augmented Reality engine for the web. Users don’t need specialized hardware nor dedicated software - only a modern web browser.

Try a demo | :heart: Support my work!

:man_technologist: MARTINS.js is developed by Alexandre Martins and is based on Speedy Vision.

:books: Technical documentation is available at https://alemart.github.io/martins-js/.

Try WebAR right now!

Scan or tap the QR code below with a mobile device.
A web page will be opened. It’s the WebAR experience.
The web page will request access to your webcam. Authorize it.
Scan the cartoon below.
Enjoy! :wink:

Guidelines for WebAR:

WebGL2 and WebAssembly are required. Use a compatible browser.

Don’t move the camera too quickly - it produces motion blur.

The physical environment should be properly illuminated.

Avoid low-quality cameras (cameras of common smartphones are OK).

Visit the Demo gallery for more.

Try locally

Try the demos on your own machine:

Run on a console:

git clone git@github.com:alemart/martins-js.git
cd martins-js
npm start

Open https://localhost:8000/demos/
Pick a demo and have fun!

Features

Image tracking, also known as natural feature tracking. Use it to track detailed images such as: book covers, cartoons and photos.

What can you do with Web-based Augmented Reality?

Lots of exciting things that run in the web browser! No need to install apps!

WebAR games
Marketing gimmicks
Interactive art
Tech demos
…and more!

Why use MARTINS.js?

Here is why MARTINS.js is a great choice for creating Augmented Reality experiences:

No need to download apps! MARTINS.js is a WebAR engine. It runs in web browsers. Users can access the AR experience immediately.
Fast and powerful! MARTINS.js is GPU-accelerated. It uses WebGL2 and WebAssembly for turbocharged performance.
No need of custom hardware or software! MARTINS.js is built from scratch using standard web technologies. All it requires is a modern web browser.
Fully standalone! MARTINS.js has in it everything it needs to analyze the environment and help you create AR. There are no additional requirements. No need of WebXR.
Easy to get started! MARTINS.js can be used with a <script> tag in your page. A static HTML page is enough to get started.

Browser compatibility

MARTINS.js is compatible with all major web browsers:

Chrome	Edge	Firefox	Opera	Safari*
✔	✔	✔	✔	✔

* use Safari 15.2 or later.

MARTINS.js requires WebGL2 and WebAssembly.

License

Released under the AGPL 3.0. A different license is available if you support my work.

README.md