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

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